Configure OT Connect Adapter Service

About This Task

To use OT Connect Adapters, you must configure each OT Connect Adapter Service by modifying the appsettings.json configuration file on the OT Connect Process Data Server.

You can make the modifications by opening the file in an application that can modify JSON text (for example, Notepad). The following instructions provide details on making all required modifications at one time using the text editor.

Note: This configuration file defines several endpoints on the GE Digital APM Server with URLs and ports that must be accessible from the OT Connect Process Data Server. Ensure that your firewalls are configured to allow this access.

Procedure

On the OT Connect Process Data Server, open the <Install_Location>/appsettings.json file.

Modify the configuration sections as described in the following table:

Within this section...	Make this change	Notes
Adapter	Replace TenantId with the name of the GE Digital APM database to which you want to connect.	None
OtSource	Replace Name with a descriptive identifier for this Process Historian Source.	This Name must eventually match that of an OT Source system defined in the GE Digital APM Database chosen above.
QueueOptions	Set ActiveMqHost with the fully qualified network address of the server that hosts the ActiveMQ Message Bus.	Typically, the Host of the ActiveMQ Message Bus is the GE Digital APM Server.
	Set ActiveMqPort with the appropriate port of the ActiveMQ host.	The default port is 61616.
	Set Username with the user Id of an authorized user of the ActiveMQ instance on the MqHost.
	Set Password with the encrypted secret of the desired user Id of the ActiveMQ instance on the MqHost.
CacheOptions	Replace Host with the fully qualified network address of the server that hosts the Redis cache instance.	Typically, the Host of the Redis cache instance is the GE Digital APM Server.
	Set Port to the defined port of the Redis cache instance.	The default port is 6379.
	Set Password to the Password of the Redis cache instance, if any.	By default, the password is blank.

The following content is an example of an appsettings.json file.

{
  "Adapter": {
    "TenantId": "V4040000_QA",
    "OtSource": {
      "Name": "Source T1002"
    }
  },
  "Logging": [
    {
      "Pattern": "*",
      "LoggingLevel": "Info",
      "LoggingMode": "All"
    }
  ],
  "MessageBus": {
    "QueueOptions": {
      "ActiveMqHost": "appserver",
      "ActiveMqPort": 61616,
      "Username": "admin",
      "Password": "admin"
    },
    "CacheOptions": {
      "Host": "appserver",
      "Port": 6379,
      "SyncTimeout": 15000,
      "Password": "admin"
    }
  }
}