Pre-Installation Steps

Before you begin

  • Ensure that you have all the nodes required to install Plant Applications Web Client. For information, refer to Deployment Architecture and About Preinstallation Requirements.
  • If you are using a UAA service other than Operations Hub UAA, migrate your UAA data to Operations Hub UAA using uaa-users-migration-utility.
  • During installation, you will be required to enter the following details at different steps. Therefore, make a note of these details.
    • The location of the tar files provided by GE.
    • URL of the local Docker Registry
    • Credentials to access the local Docker Registry (required if authentication is enabled).
    • Host name, username, and password to access the remote server (if you want to install Web Client on a remote server)
    • Name of the Plant Applications database server
    • Instance name of the Plant Applications database server (required only if the database has an instance)
    • Name of the Plant Applications server
    • Credentials to access RabbitMQ
    • Credentials of the username and password of the Plant Applications Admin user who will be added to the UAA service
    • Name of the Apache CouchDB server and access credentials
    • Node name of the Apache CouchDB server (the node name used during the CouchDB configuration. For example: couchdb@localhost)
    • Server name of Operations Hub
    • Admin client ID and secret of Operations Hub UAA
    • Tenant username and password of Operations Hub

Procedure

  1. If your installation environment runs behind a proxy, on all the three servers (nodes 5, 6, and 7 in the deployment architecture), set the HTTP_PROXY and HTTPS_PROXY environment variables to point to your proxy servers.
  2. Create and configure Docker Registry.
  3. Set the NO_PROXY environment variable to the IP addresses or host names of the local Docker Registry, Plant Applications database, Plant Applications, Apache CouchDB, and Operations Hub servers. To do so:
    1. Run the following command: sudo nano /etc/environment
    2. Add the following line in the environment file, and save the file:
      no_proxy=”127.0.0.1, <IP address or hostname of the UAA server>, <IP address or hostname of soadb>, <IP address or hostname of RabbitMQ>, <IP address or hostname of the Docker Registry>”
  4. Access the node on which you want to install Plant Applications Web Client.
  5. Create a folder named wc81tars.
  6. Extract the contents of the PA Web Client 8.1_Tarfiles.zip file, and copy the contents into the wc81tars folder.
  7. Create another folder named wc81installer.
  8. Extract the contents of the PA8.1_uc-ansible-installer, and copy the contents into the wc81installer folder.
  9. Navigate to the installer folder, and run the following shell command: ~/your/path/wc81installer/wc_ansible_install/ sudo chmod +x ./wcinstall.sh