Troubleshooting Configuration Hub Issues

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.