Install the Plant Applications Web Client Without Using Docker

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.1 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 8.1.
    The Plant Applications Web Client installation wizard appears, displaying the Welcome to Plant Applications Web Client 8.1 screen.

  4. In the Welcome to Plant Applications Web Client 8.1 screen, select Next.
    The Prerequisites screen appears.
    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.
  5. In the Prerequisites screen, select Next to view all installed prerequisites and install any missing prerequisites.
    The Read and accept the license agreement to continue screen appears.

  6. Read the license agreement, select Accept, and then select Next to continue the installation.
    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.
    CredentialDescription
    Server NameThis 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).
    PortEnter the Operations Hub port number.
    Tenant UsernameEnter the tenant Hub username to access the Operations Hub server instance.
    Note: The default user name is OphubAdmin.
    Tenant PasswordEnter 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 Install Model Selection screen appears.

  11. In the Install Model Selection screen, select any of the following options based on the requirement.
    • PROCESS: Installs only the Process applications along with the web services.
    • DISCRETE: Installs only the Discrete applications along with the web services.
    • BOTH: Installs both the Process and Discrete applications.
  12. Select Next.
    The UAA Credentials screen appears.

  13. In the UAA Credentials screen, enter the credentials to access the UAA server as described in the following table.
    CredentialDescription
    Server NameEnter the host name of the UAA server.
    Note: Instead of IP address, it is recommended to use the UAA host name (computer name).
    PortEnter the UAA port number.
    Admin Client IDEnter the admin Client ID to access the UAA server instance.
    Note: The default user name is admin.
    Admin Client SecretEnter the Client Secret for the user name you entered in the Admin Client ID box.
    ValidateSelect 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.
    IconDescription
    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.
  14. Select Next.

    The Plant Applications Database Credentials screen appears.

    Note: If you have selected either DISCRETE or BOTH in the Install Model Selection screen, the following screen appears that allows you to enter the Couch DB details.

  15. In the Plant Applications Database Credentials screen, in the Plant Applications Data Base section, enter the Plant Applications database credentials as described in the following table.
    CredentialDescription
    Server nameEnter 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.
    DatabaseEnter the name of the Plant Applications database that you want to connect with the Plant Applications Web Client.
    UsernameEnter the user name that has permissions to access the database you entered in the Database box. By default, the user name appears as sa.
    PasswordEnter the password for the user name you entered in the Username box.
    PortOptional: Enter the number of the port that the instance uses to listen for client connections.
    Note: The default port is 1433.
  16. 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.
    IconDescription
    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 you have selected PROCESS in the Install Model Selection screen and the database connection is successfully validated, the Next button is enabled. Skip to Step 19.
  17. If you have selected either DISCRETE or BOTH in the Install Model Selection screen, in the Plant Applications Database Credentials screen, select the CouchDB tab.
    The Document Service Couch DB Credentials screen appears.

  18. In the Document Service Couch DB Credentials screen, enter the Couch DB credentials as described in the following table.
    CredentialDescription
    CouchDB Server UriEnter the fully qualified web address of Apache CouchDB in the format: https://<host name or IPaddress>:<port number>.
    NodeEnter the name of the node where Apache CouchDB is running. By default, the node value appears.
    UsernameEnter the user name of the administrator that has permissions to access the database you entered in the Database box.
    PasswordEnter the password for the user name you entered in the Username box.
    Couch CertificateSelect Browse to locate the Apache CouchDB server certificate (couch_server.crt) that you have generated and upload it.
    ValidateSelect Validate 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.
    IconDescription
    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.
  19. Select Next.
    The Plant Applications Administrator User Credentials screen appears.

  20. 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.
    CredentialDescription
    User NameEnter the user name for an administrator account in Plant Applications.
    PasswordEnter the password for the user name you entered in the User Name box.
    ValidateSelect 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.
    IconDescription
    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.
  21. Select Next.
    The Tomcat Installation screen appears.

  22. 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 DetailDescription
    PortEnter the HTTP port that Tomcat uses to listen for client connections.
    Note: The default port is 8081.
    Redirect PortEnter the HTTPS port that Tomcat uses to redirect all HTTP requests to this port.
    Note: The default redirect port is 8444.
    UsernameEnter the user name to access Tomcat.
    Note: The default user name is admin.
    RolesSkip this box because it is automatically populated.
    PasswordEnter the password for the user name you entered in the Username box.
    Re-enter PasswordReenter 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.
  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.
      CredentialDescription
      Server nameEnter the computer name or IP address that hosts your Plant Applications Message Bridge.
      UsernameEnter the Administrator's user name that you set during Plant Applications Message Bridge installation.
      PasswordEnter 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.
      IconDescription
      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.

    Note: You must provide the Kafka and Zookeeper details that were defined during the Message Bridge installaton.
  26. In the Kafka Credentials screen, enter the credentials to access the Kafka server as described in the following table.
    CredentialDescription
    Server NameEnter the host name of the Kafka server.
    Note: Instead of IP address, it is recommended to use the Kafka host name (computer name).
    Kafka PortEnter the Kafka port number.
    ValidateSelect Validate to validate the Kafka server connection.
    Note: The following table describes each icon indicating a validation status that might appear during the validation process.
    IconDescription
    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.
    Zookeeper Client PortEnter 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 Operations Hub Posting Utility to import the Plant Applications into the Operations Hub.

What to do next

Perform the post-installation steps.