Troubleshooting Enterprise Edition Web Client Installation Issues

IssueResolution

Unable to access Plant Applications Enterprise Edition Web Client.

When you install Enterprise Edition Web Client for the first time, a self-signed certificate for the applications and services to support HTTPS is created, by default. If you have not changed or reconfigured the Plant Applications Enterprise Edition Web Client installation with a CA certificate that is added to your trust stores across the local network, you cannot access Enterprise Edition Web Client.

  1. Access the following URLs:
    • https://<Enterprise Edition Web Client node IP address or system name>:5059/443
    • https://<Enterprise Edition Web Client node IP address or system name>:5051/

    A message appears to accept the insecure URL to proceed. Choose to do so.

  2. Select Not Secure in the address bar. A Certificate window appears.
  3. Import the certificate and add it to your trusted store.
  4. Refresh the Plant Applications Enterprise Edition Web Client window.
When you run the installer (setup.sh) and select an option, the following error message appears: Unexpected Exception, this is probably a bug: No closing quotation Access the ansible.cfg file, and comment out the following lines of code:
strategy_plugins = ./tmp/mitogen-0.2.9/ansible_mitogen/plugins/strategy
strategy = mitogen_linear 
Multiple container restart issue. If you have multiple container restart issue, run the following command in the web client (linux server) node:
docker swarm update --dispatcher-heartbeat 120s
Unable to access the Enterprise Edition Web Client after successful installation, and Haproxy service logs displays the following errors:

[NOTICE] (6) : haproxy version is 2.5.1-86b093a

[NOTICE] (6) : path to executable is /usr/local/sbin/haproxy

[ALERT] (6) : [haproxy.main()] Cannot raise FD limit to 8251, limit is 1024

Note: This issue is specific to the Web Client that runs on Amazon Linux OS.
  1. Modify /etc/sysconfig/docker

    OPTIONS=”--default-ulimit nofile=1024:4096”

    Replace with

    OPTIONS=”--default-ulimit nofile=10000:15000”

  2. Restart the docker.

While installing the Enterprise Web Client, the system did not display the progress of the installation and displayed the following errors:

awk: options '-W interactive' unrecognized, ignored

awk: options '-W interactive' unrecognized, ignored

awk: options '-W interactive' unrecognized, ignored

If the Linux machine has multiple awk versions available, then switch to mawk by typing the following command: sudo update-alternatives --config awk..

This command lists the available awk versions, and you must select the mawk version only.

Note:

If the installer does not show any progress, then open another console and navigate to the plantapps-enterprise-webclient-2023 directory and refer to the log by typing the following command in the installer path: tail -f log/ansible.log.