Troubleshooting

Frequently Asked Questions (Non-Docker only)

  • Can I access the log files created after the Plant Applications Universal Client installation or upgrade process?

    Yes. You can access the log files created during the installation process from the following directory: %USERPROFILE%\APPDATA\Local\Temp. The log files are available in the format Plant_Applications_Universal_Client_yyddmmhhmmss.

  • What happens if I upgrade JAVA after installing the Plant Applications Universal Client?

    If you upgrade JAVA later, it might create some issues in using the Plant Applications Universal Client, and Tomcat might stop. To resolve this issue, refer to the Community article 000020691 in the support site http://support.ge-ip.com.

  • What should I do if the installation of GE Proficy Historian Server fails?

    If Transport Layer Security (TLS) 1.1 or 1.2, or the security policy for using the FIPS compliant algorithms is enabled, the Historian installation process fails. To install Historian successfully, you must temporarily disable the required feature, and then after successful Historian installation enable the feature again.

Troubleshoot the Tomcat Error

About This Task

The following Tomcat screen appears when you try to upgrade the Plant Applications Universal Client and there is an issue with the Tomcat service.

To troubleshoot the Tomcat service error, perform the following steps:

Procedure

  1. In the Tomcat window, ensure that you have entered the correct HTTPS port to continue with the installation.
  2. Ensure that the Tomcat service is running.
    1. Log in to the computer where you installed the Plant Applications Universal Client.
    2. Select Start, and then search for the Services application.
    3. In the command prompt, enter services.msc.

      The User Account Control window appears.

    4. Select Yes.

      The Services window appears.

    5. Verify that the Status of the Tomcat service configured during the Plant Applications Universal Client installation appears as Running. If not, start the service.

Troubleshoot Access Issues

This topic describes how to troubleshoot issues when you cannot access Operations Hub UAA, Apache CouchDB, or the Plant Applications database using the host name from the machine on which Docker has been installed. This is applicable only if you have installed Plant Applications Universal Client using Docker.

Procedure

  1. If the Operations Hub UAA server is not accessible using the host name from the machine on which Docker has been installed, perform the following steps:
    1. For each application that will be deployed in Plant Applications Universal Client, add the following line in the plantapps-web-docker/env.yml and plantapps-universal-client/env.yml files:
      extra_hosts:
      - "<host name of the UAA server>:<IP address of the UAA server>"
    2. Using the Command Prompt, change the directory to plantapps-web-docker, and run the following command: ./PA_Services_Start_Lix.sh
    3. Using the Command Prompt, change the directory to plantapps-universal-client, and then run the following command: ./PA_Apps_Start_Lix.sh
  2. If the Apache CouchDB UAA server is not accessible using the host name from the machine on which Docker has been installed, perform the following steps:
    1. For each application that will be deployed in Plant Applications Universal Client, add the following line in the plantapps-web-docker/env.yml and plantapps-universal-client/env.yml files:
      extra_hosts:
      - "<host name of the UAA server>:<IP address of the UAA server>"
    2. Using the Command Prompt, change the directory to plantapps-web-docker, and run the following command: ./PA_Services_Start_Lix.sh
    3. Using the Command Prompt, change the directory to plantapps-universal-client, and then run the following command: ./PA_Apps_Start_Lix.sh
  3. If the Plant Applications Universal Client server is not accessible using the host name from the machine on which Docker has been installed, perform the following steps:
    1. For each application that will be deployed in Plant Applications Universal Client, add the following line in the plantapps-web-docker/env.yml and plantapps-universal-client/env.yml files:
      extra_hosts:
      - "<host name of the UAA server>:<IP address of the UAA server>"
    2. Using the Command Prompt, change the directory to plantapps-web-docker, and run the following command: ./PA_Services_Start_Lix.sh
    3. Using the Command Prompt, change the directory to plantapps-universal-client, and then run the following command: ./PA_Apps_Start_Lix.sh