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 Web 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 Web 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 Web 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 Web 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 Web 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