Install Standard Web Client

About this task

Perform the preinstallation tasks.

Procedure

  1. Mount the ISO file for the Plant Applications Web Client or load the DVD if you created one from the ISO file on the application server for Plant Applications.
  2. Run the installfrontend.exe file as an Administrator.
    The installation menu appears, displaying the Install Proficy Plant Applications 8.2 screen.

    Tip: You can hover over each task that appears in the installation menu to refer to the tooltip associated with that task.
    Note: Ensure that you have installed the Microsoft Visual C++ 2015 Redistributable (64-bit) package.
  3. Select Plant Applications Web Client.
    The Plant Applications Web Client installation wizard appears, displaying the Welcome to Plant Applications Web Client 8.2 screen.

  4. In the Welcome to Plant Applications Web Client 8.2 screen, select Next
    The Read and accept the license agreement to continue screen appears.

  5. Read the license agreement, select Accept, and then select Next to continue the installation.
    The Prerequisites screen appears.

    If any of the following required software packages are not already installed on your computer, the installer installs them automatically:
    • Apache Tomcat version 9.0.35
    • Ruby 2.3.3
    • Ruby DevKit version 4.65.0.0
      Note:

      Ruby is required because the UAA Command Line Interface (UAAC) is dependent on Ruby.

    • NodeJS 8.12
    • Python 2.7.2
    • OpenJDK 1.8
    Note: If Microsoft OLE DB Driver 18 for SQL Server or later is not installed, the Missing Prerequisites screen appears informing you to install the required version of the missing software before you run the installer. You must exit the installation, and first install the required software.

  6. In the Prerequisites screen, select Next to view all installed prerequisites and install any missing prerequisites.
    The Operations Hub Credentials screen appears.

  7. In the Operations Hub Credentials screen, enter the credentials to access the Operations Hub server as described in the following table.
    Note: Ensure that you use lower case when entering the server names through out the installation.
    Credential Description
    Server Name This field is automatically populated with the local host name, fully qualified host name, or IP address, based on the configuration in Operations Hub. You can edit the host name of the Operations Hub server based on requirement.
    Note: Instead of IP address, it is recommended to use the Operations Hub host name (computer name).
    Port Enter the Operations Hub port number.
    Tenant Username Enter the tenant Hub username to access the Operations Hub server instance.
    Note: The default user name is OphubAdmin.
    Tenant Password Enter the password for the user name you entered in the Tenant Username box.
    Note: The tenant username and password must be same as the credentials that you have specified during the Operations Hub installation.
    If all the options are entered correctly, the Next button is enabled.
  8. Select Next to continue with the installation.
    The Installation Directory screen appears with the default installation directory selected as C:\Program Files\GE Digital\PlantApplicationsWebClient.

  9. Optional: In the Destination Folder box, select Change to browse and select the directory where you want to install the Plant Applications Web Client.
    Note: Do not use the user profile folder for installation.
  10. In the Installation Directory screen, select Next.
    The UAA Credentials screen appears.

  11. In the UAA Credentials screen, enter the credentials to access the UAA server as described in the following table.
    Credential Description
    Server Name Enter the host name of the UAA server.
    Note: Instead of IP address, it is recommended to use the UAA host name (computer name).
    Port Enter the UAA port number.
    Note: You can leave this field blank if you are using the default port number (443).
    Admin Client ID Enter the admin Client ID to access the UAA server instance.
    Note: The default user name is admin.
    Admin Client Secret Enter the Client Secret for the user name you entered in the Admin Client ID box.
    Validate Select Validate to validate the UAA server connection.
    Note: The following table describes each icon indicating a validation status that might appear during the validation process.
    Icon Description
    Indicates that the validation is in progress.
    Indicates that the validation was successful.
    Indicates that the validation was unsuccessful. In this case, make sure you enter the correct password.
    If all the options are entered correctly, the Next button is enabled.
  12. Select Next.
    The Plant Applications Database Credentials screen appears.

  13. In the Plant Applications Database Credentials screen, enter the Plant Applications database credentials as described in the following table.
    Credential Description
    Server name Enter the server name where the Plant Applications database is installed in the format HOST_NAME\INSTANCE. Where HOST_NAME is the host name (either a fully qualified domain name or IP address, of the server) and INSTANCE is the instance of the server used by the database.
    Note: If there is no instance for the server, you can enter HOSTNAME as the server name. Localhost is not an acceptable value for HOSTNAME.
    Database Enter the name of the Plant Applications database that you want to connect with the Plant Applications Web Client.
    Username Enter the user name that has permissions to access the database you entered in the Database box. By default, the user name appears as sa.
    Password Enter the password for the user name you entered in the Username box.
    Port Optional: Enter the number of the port that the instance uses to listen for client connections.
    Note: The default port is 1433.
  14. Select Validate Connection to validate the database connection.
    Note: The validation process takes some time to check whether a compatible version of the Plant Applications server is installed.
    The following table describes each icon indicating a validation status that might appear during the validation process.
    Icon Description
    Indicates that the validation is in progress.
    Indicates that the validation was successful.
    Indicates that the validation was unsuccessful. In this case, make sure you enter the correct password.
  15. In the Plant Applications Database Credentials screen, select the CouchDB tab.
    The Document Service Couch DB Credentials section appears.

  16. In the Document Service Couch DB Credentials section, enter the Couch DB credentials as described in the following table.
    Credential Description
    CouchDB Server Uri Enter the fully qualified web address of Apache CouchDB in the format: https://<host name or IPaddress>:<port number>.
    Node Enter the name of the node where Apache CouchDB is running. By default, the node value appears.
    Username Enter the user name of the administrator that has permissions to access the database you entered in the Database box.
    Password Enter the password for the user name you entered in the Username box.
    Validate Select Validate Connection to validate the Apache CouchDB database credentials.
    Note: The following table describes each icon indicating a validation status that might appear during the validation process.
    Icon Description
    Indicates that the validation is in progress.
    Indicates that the validation was successful.
    Indicates that the validation was unsuccessful. In this case, make sure you enter the correct password.
    If the Apache CouchDB database connection is successfully validated, the Next button is enabled.
  17. Select Next.
    The Plant Applications Administrator User Credentials screen appears.

  18. In the Plant Applications Administrator User Credentials screen, enter the Plant Applications Administrator credentials as described in the following table.
    Note: Ensure that the user credentials entered here must exist in Plant Applications Server with an administrator role defined and you must use the same credentials to login into the Web Client applications.
    Credential Description
    User Name Enter the user name for an administrator account in Plant Applications.
    Password Enter the password for the user name you entered in the User Name box.
    Validate Select Validate to validate the Plant Applications Administrator credentials.
    Note: The following table describes each icon indicating a validation status that might appear during the validation process.
    Icon Description
    Indicates that the validation is in progress.
    Indicates that the validation was successful.
    Indicates that the validation was unsuccessful. In this case, make sure you enter the correct password.
    If the Plant Applications Administrator connection is successfully validated, the Next button is enabled.
  19. Select Next.
    The Tomcat Installation screen appears.

  20. In the Tomcat Installation screen, enter the Tomcat installation details for a new or existing installation as described in the following table. The installer prompts you to enter details for an existing Tomcat if the Tomcat installation details are available in the registry settings for the Plant Applications Web Client on your computer. Else, the installer prompts you to enter details for a new installation of Tomcat.
    Installation Detail Description
    Port Enter the HTTP port that Tomcat uses to listen for client connections.
    Note: The default port is 8081.
    Redirect Port Enter the HTTPS port that Tomcat uses to redirect all HTTP requests to this port.
    Note: The default redirect port is 8444.
    Username Enter the user name to access Tomcat.
    Note: The default user name is admin.
    Roles Skip this box because it is automatically populated.
    Password Enter the password for the user name you entered in the Username box.
    Re-enter Password Reenter the password for the user name entered in the Username box.
    Note: This box appears only when a new installation of Tomcat is initiated by the installer.
  21. Select Next.
    The Customize Web Client Log Files Location screen appears.

  22. Optional: In the LogFiles Base Folder box, select Browse to browse and select the directory where you want to install the Plant Applications Web Client service logs.
  23. Select Next.
    The RabbitMQ Credentials screen appears.

  24. In the RabbitMQ Credentials screen, perform one of the following steps:
    • Enter the RabbitMQ credentials for the machine that hosts your Plant Applications message bridge as described in the following table, and then select Validate Connection.
      Credential Description
      Server name Enter the computer name or IP address that hosts your Plant Applications Message Bridge.
      Username Enter the Administrator's user name that you set during Plant Applications Message Bridge installation.
      Password Enter the password for the Administrator's user name you entered in the Username box.
      The following table describes each icon indicating a validation status that might appear during the validation process.
      Icon Description
      Indicates that the validation is in progress.
      Indicates that the validation was successful.
      Indicates that the validation was unsuccessful. In this case, make sure you enter the correct password.
  25. Select Next.
    The Kafka Credentials screen appears. Make a note of the kafka port number that is listed for configuring Message Bridge after the Web Client installation.

  26. In the Kafka Credentials screen, enter the credentials to access the Kafka server as described in the following table.
    Credential Description
    Use external Kafka Select this check box if you want to configure an external Kafka instance.
    Server Name Enter the host name of the Kafka server.
    Note: Instead of IP address, it is recommended to use the Kafka host name (computer name).
    Zookeeper Admin Port Enter the Zookeeper Admin port number.
    Zookeeper Client Port Enter the Zookeeper Client port number.
    Note: Ensure that you have entered a valid Zookeeper port number. If you have entered an invalid port number, refer to Changing the Zookeeper Port Number section in Getting Started Guide.
    Kafka Port Enter the Kafka port number.
    Zookeeper Client Port Enter a valid Zookeeper Client port number.
    If all the options are entered correctly, the Next button is enabled.
  27. Select Next.
    The You are ready to install screen appears.

  28. Select Install, and then wait for the installation to complete.
    Depending on the options selected, the installation process may take some time. On successful installation, the Installation Successful screen appears.

  29. Optional: Select View Logs to see the installation details.
  30. In the Installation Successful screen, select Exit to close the wizard.
    The Plant Applications Web Client is successfully installed on your computer.
    Remember: If you upgrade JAVA later, it might create some issues in using the Plant Applications Web Client. To resolve this issue, refer to the Community article 000020691 in the support site http://support.ge-ip.com.
  31. Run Message Bridge Configuration Utility on the Plant Applications Server to update the Kafka details in the Message Bridge configuration.
  32. Run Operations Hub Posting Utility to import the Plant Applications into the Operations Hub.
  33. Once you have completed running Message Bridge Configuration and Operations Hub Posting utilities, Verify the Installation to verify if the Plant Applications Web Client applications are up and running.
  34. Access REST APIs to access the REST APIs for Plant Applications Web Client.

What to do next

Perform the post-installation steps.