Change the UAA Server

Before you begin

Install Web-based Clients, specifying the details of the new UAA server.

About this task

The Historian server and Web-based Clients must always point to the same UAA server. Only then you can access Web-based Clients (such as Configuration Hub, Trend Client, the Web Admin console, and REST APIs). Therefore, if you have changed the UAA server used by Web-based Clients, the Historian server must point to the same UAA server.

This topic describes how to update the UAA server details for the Historian server without the need to reinstall it.

Procedure

  1. Access the UAAConfiguration.exe file. By default, it is located at C:\Program Files\Proficy\Proficy Historian\x64\Server.
    The UAA Configuration tool window appears, displaying the UAA server name and port number that you specified while installing the Historian server.
  2. In the UAA server name and Public https port fields, provide the values of the UAA server used by Web-based Clients.
  3. Select Test.
    The test results appear. Only if the connection test is successful, you can modify the details.
  4. Select Configure.
    The UAA server and port number details are updated for the Historian server. The changes are reflected as soon as you refresh the browser in which you have opened any of the Web-based Clients components (such as Configuration Hub, the Web Admin console, Trend Client).
If testing the connection fails, try these steps:
  • Verify that you can ping the UAA server. If you cannot ping the UAA server, add the IP address and the server name in the hosts file located in C:\Windows\System32\drivers\etc.
  • Ensure that the following services are running on the UAA server machine:
    • GE Operations Hub Httpd Reverse Proxy
    • GE Operations Hub UAA Tomcat Web Server
  • Verify that the UAA server details provided during Web-based Clients installation match the ones you have specified in the UAA Configuration tool.