The process of creating a gateway / connector pair starts with logging into your ThinkIQ instance to configure a gateway and a connector, downloading an installer, and running a local program. The local program accesses the ThinkIQ server and uses your configuration information to create a pair of local objects: a Gateway and a Connector. These objects run locally on a Windows or Linux on-premise computer to enable connecting your local device with a ThinkIQ data ingestion server.

There are several different types of connectors. These instructions apply to every available type.

For information pertaining to a specific connector, see the documentation for that connector.

Prerequisites

Before installing a gateway / connector combination, check that your system is compatible:

  • If your computer is running Microsoft Windows, does it match the following required hardware and software specifications?
    • x64 CPU architecture
    • Windows 10 or Windows 11
  • If your computer is running Linux, does it match the following hardware and software specifications?
  • Is the machine using a modern browser: Edge, Chrome, Firefox, and others? The software will not run on Internet Explorer.
  • Does the machine have appropriate outbound connectivity?
    • Can the machine browse to your instance of the ThinkIQ platform, e.g. https://yourcompany.thinkiq.net?
  • Do you have user credentials that allow you to add Gateways/Connectors? The default User Group for this is Configuration.
  • Can the machine connect to your  machine over a network i.e., can it connect remotely?
    • If it cannot the only choice is to install on the physical machine where the is running. However, sometimes you cannot install locally – on the source machine. For example, when you are running a PLC on a machine, you cannot install the connector on the same machine
  • The "ASP.NET Core Runtime" and the "Windows Desktop Runtime" are required for installation. If needed, you will be prompted to download and install them before the process continues. The install process flows more smoothly if you download and install these files ahead of time. You can download them here.
  • The OPC Classic .Net API is required for OPC Classic connectors that communication locally over HDA. This includes OPC Classic, OSISoft PI and the Rockwell . The install process flows more smoothly if you download and install this ahead of time. Download the OPC Core Components Redistributables (ZIP/MSI/MSM) now by clicking here.

 

Create the Gateway instance.

  1. Browse to your ThinkIQ instance as a user in the Configuration user group.

  2. In the Model Explorer tree on the Instances tab, use the Add Instance  (+) button to add a Gateway. Each connector must be installed under its own gateway. The Gateway is the connection between the on-premise computer and the ThinkIQ platform in the cloud. In principle, you can install the gateway anywhere in your model. 

create gateway

Create the Gateway

  1. Give the Gateway a name.
  2. The Internal Name will be automatically inserted.
  3. Using the type-picker, open the Type system, search for, and select the type Gateway.  Use the search box to find the Gateway type. [Required]
  4. The Parent is automatically filled based on the location in the Tree.
  5. Gateways can be ordered for display purposes. [Optional]
  6. Enter a description. [Optional]. Use the Show Editor button to open and edit the Description.
  7. Edit Status. Defaults to: In Work.
  8. Select the Operating System to install the Gateway in. Options are Windows and Linux. [Required]
  9. Override default access to the Gateway.

    IMPORTANT: the default access for Instances is set in the Admin Console and is set to Engineering users and above. Registered users and Operators can only View the Instance. Be very careful if you choose to change this field.

 

new gateway

Once the gateway is created, it will show in the Model Explorer tree under it's parent instance. Note there are no tags yet. 
Connecting a local machine to the ThinkIQ network requires both a gateway and a connector. The previous section covered the configuration of a new gateway. The next section looks at configuring a new connector.

 

Create the Connector Instance

  1. In the Model Explorer, navigate to the Gateway under which the Connector will operate. (Usually the one you just created.)
  2. Use the Add Instance (+) button to add a connector. The Connector is the connection between the on-premise computer and the .

create connector

Create the Connector

  1. Give the Connector a name.
  2. The Internal Name will be automatically inserted.
  3. The connector Type is a drop-down selection. [Required]
  4. The Parent is automatically filled based on the location in the Tree.
  5. Connectors can be ordered for display purposes. [Optional]
  6. Enter a description. [Optional]
  7. Edit Status. Defaults to: In Work.
  8. Override default access to the Connector.

    IMPORTANT: the default access for Instances is set in the Admin Console and is set to Engineering users and above. Registered users and Operators can only View the Instance. Be very careful if you choose to change this field.

 

 After the connector is created, Activation pending will show in the connector Overview tab. An Activation Code with its expiration date is displayed. You will use the Activation Code when you create the gateway/connector on your local computer. The ThinkIQ system uses the Activation Code to link your local computer to the configuration details that you provided when creating the gateway and connector. The code will expire after four hours. Use the Download link to download the installer. You will need the Ingestion Server Endpoint and the activation Code when you run the installer. 

activation pending2

 

 

Local Gateway / Connector Setup on Microsoft® Windows®

The process of getting a gateway and connector set up on a local machine running Microsoft Windows starts with running the ThinkIQ.Gateway.msi package that was downloaded in the previous steps. It is strongly suggested that you install all prerequisites before starting the installation.

The installer proceeds step by step and will vary based on the connector type being installed. The first screens are introductory and contain accepting the license agreement and other confirmations.

install gateway1

 

To continue the installation, confirm or change the location of the Installation Folder.

install gateway2

 

Installing the Gateway and Connector

The installation of the Gateway and Connector itself starts with a request to enter the Ingestion Server Endpoint and the Activation code displayed on the connector page where the Gateway and Connector were created in the ThinkIQ portal.  After entering the information, use the Test and establish connection button to test connectivity to the Portal.

install gateway3   

Note: If the installer does not move past the activation code entry page there may be network security on the host computer/network blocking communication to the ThinkIQ platform.

The .NET 8.0 runtime is required. When a system does not have the .NET 8.0 runtime – or only a portion of the required runtime – you will receive a message with a link to download .NET Core. The installation will exit and .NET Core must be installed before you can restart the installation. 

 

The installation will continue with configuration steps and prompt for information that is different for each of the connector types.
Refer to the following for details:

 

________________________________________________________________________________________________________

Once the configuration completes, click OK to close the dialog

configurator dialog

Refresh the Connector page. The connector should be updated as shown below. 

connector activated

 

Mapping Tags

To receive time series data from a new connector, its tags must be properly linked to attributes in ThinkIQ system. Learn how to Map Tags to Data Sources.

___________________________________________________________________________________________

 

Windows Services

After installation there will be three services visible in the Window Services control panel: the ThinkIQ OPC UA North Service, the gateway, the ThinkIQ southbound - named for the connector type, for example, 'ThinkIQ OPC UA Connector', or connector, and the ThinkIQ System Monitor, which is responsible for showing that both the northbound and southbound services are running. To stop a connector, simply stop the southbound service. To stop the gateway, stop the northbound service. To stop everything, stop northbound service, southbound service, and the ThinkIQ monitor service.

 

South Service

 After activation, the South Service is set up on the computer where the connector is installed. The South Service Settings box displays the connector settings. These settings are editable by opening the file on the machine where the connector is installed in  C:\Program Files\ThinkIQ\SouthBridgeService\appsettings.json.

Settings that can be customized include the following: 

DataStorer
     In the Params row
         DataRootDir    the location where tag data is stored when the system loses connectivity to the cloud.
        MaxFileCount   the maximum number of files that can be stored in the above location. As connectivity is restored and the data is once again flowing to the cloud, the files are deleted. The individual files are generally quite small, but the maximum number to store during store and forward is limited by disk drive size and can be effected by the number of tags being historized.


App Settings
   
    "AcquiredTagChunkSize": 300
    "AttributeChangeCheckTrigger": 0
    "UseOnPremiseAcquiredTagList": false
    "HistSeizedThresholdInSeconds": "1800"
    "UseAcquiredTagListAsWhiteList": false
    "TagChangeCheckIntervalInSeconds": 0
    "OnPremiseAcquiredTagListFilePath": "./OnPremiseAcquiredTagList.txt"
    "AttributeChangeCheckIntervalInSeconds" 0

 For a deeper dive, read more here.