Troubleshooting Configuration Hub Issues

Unable to Access External Configuration Hub if Public Https Port is Different

Issue: During Web-based Clients installation, if you provide an external UAA and Configuration Hub, and if the public https port numbers of these two machines do not match, you cannot access the external Configuration Hub from the current machine.

For example, suppose you have installed Web-based Clients on machine A, which points to the UAA and Configuration Hub installed on machine B. If the public https port numbers of machines A and B do not match, you cannot access Configuration Hub of machine B from machine A (although you can access it locally from machine B).

Workaround: Perform the following steps on the machine on which you have installed Configuration Hub (machine B):
  1. Access the following folder: C:\Program Files (x86)\GE\ConfigurationHub\Web\conf\confighub
  2. Access the file that contains the details of the machine from which you want to access external Configuration Hub (machine A). The file name begins with the host name of machine A.
  3. In the line that contains the details of the UAA server (for example, proxy_pass https://machine_B.Domain.com:Port/uaa/), change the port number to match the public https port number of machine B.
  4. Save and close the file.
  5. Restart the following services:
    • ConfigHubContainerService
    • ConfigHubNGINXService
    • ConfigHubStorageService

Issue: You can install Configuration Hub only in the C drive

Workaround:
  1. Create Configuration Hub server certificates.
  2. Start the ConfigHubNGINXService service.
  3. Using the Web Based Clients Configuration tool, provide the UAA and Configuration Hub details, test the connection, and select Resgister to re-register the Historian plugin with Configuration Hub.

Issue: Error Occurs When Historian Plugin is Registered with an External Configuration Hub

Description: If you install Configuration Hub using iFIX, then install Web-based Clients on another machine with local UAA, and then register the Historian plugin with Configuration Hub, testing the connection to Configuration Hub fails. Even after you add the IP addresses of both the machines to the hosts file, the issue is not resolved.

Error Message: Error while getting token in ConfigAuth App

Workaround: Register the Historian plugin on the machine on which you have installed Web-based Clients, install the UAA certificate, and then restart the browser.

Issue: Cannot Access the Collectors Section or Add a Collector Instance

Possible cause - user credentials not provided while installing collectors or Remote Collector Manager: While installing collectors and the Historian server on the same machine, if strict collector authentication is enabled, providing the user credentials is mandatory. Otherwise, an error occurs when you access the list of collectors or add a collector instance using Configuration Hub or the RemoteCollectorConfigurator utility.

To fix this issue, disable the strict collector authentication using Historian Administrator, and then restart the Historian Remote Collector Management Agent service.

Issue: Cannot Access or Add a System in Configuration Hub

Possible Causes:
  • User does not have security privileges: During installation of the Historian server, if you have allowed the installer to create security groups, you must create a user with the name in the following format: <UAA host name>.admin. Verify that this user has been created and added to the ihSecurityAdmins group.
    If the UAA server hostname is long, resulting in a username longer than 20 characters, Windows does not allow you to create the user. In that case, you can create a UAA user, and then create the corresponding Windows user, using the uaa_config_tool utility:
    1. Access the uaa_config_tool utility. By default, it is located at C:\Program Files\GE Digital\Historian Config.
    2. Run the following command: uaa_config_tool add_user -u <username> -p <password> -s <the client secret you provided while installing the Historian server> -c

      Example: uaa_config_tool add_user -u adminuser -p Password123 -s pwd@123 -c

  • Incorrect UAA details: You must provide the host name of the UAA server while installing the Historian server. In the Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Intellution, Inc.\iHistorian\SecurityProviders\OAuth2 registry path, verify that the URI value is in the following format: https://<UAA host name>:<port number>/uaa/check_token.

    If needed, modify the value, and then restart the Data Archiver service.

Issue: Error Appears When Creating a Collector Instance

Description: When you add a collector instance, the following error message appears: The server encountered an error processing the request. Please try again. The collector instance is added successfully, but it does not appear in the Collectors section.

Possible causes: When you add a collector instance, the collector service is started and stopped so that it is connected to the Historian server. The collector then appears in the table in the Collectors section. Sometimes, however, the collector service does not respond to these commands on time, resulting in the error message. If you attempt to add the same collector instance again, a message appears, stating that it exists.

Workaround: Select Cancel, and refresh the Collectors section. If the collector instance still does not appear, access the collector machine, and start the collector manually.