OMNIA 3 Connector Install Guide

1. Download connector

First you need to download the connector (visit Downloads page);

2. Configure connector

A configuration file (config.json) is distributed together with the connector, that you must fill in in order to use it.

  • Endpoint: The URL of the OMNIA subscription you want the connector to be used on.
  • Client: Click here to know how to get the Client ID and Secret
    • ID: Client ID of the connector configuration you registered on the platform.
    • Secret: Client Secret of the connector configuration you registered on the platform.

It also supports optional parameters:

  • BehavioursManagerPort: The port that the connector will open its behaviours manager on. If omitted, defaults to 49995. If this is already in use (i.e. you want to have two connectors in parallel), you must add this configuration.
  • Logging: The minimum log level. Further details here
  • ReconnectionTimeLimit: The maximum time (in hours) the connector will attempt to establish a connection with the Platform. If not set the default value is 24 hours.
  • LockNewVersions: Boolean value that defines if connector can download new model versions. If defined as true, the connector will not download new model versions.

3. Install connector

After you have downloaded the connector (see our Downloads page) and extracted it, you can either run it directly (not recommended for production environments) or install it as a Windows service.

To run it, you should just do Omnia.Connector.Windows.exe (in cmd) or ./Omnia.Connector.Windows.exe (in powershell) from the folder you extracted it to. In order to install the Windows service, add install to the end of that line. To uninstall it, add uninstall. In both of these scenarios, ensure you are running as an administrator.

NOTE: Depending on the Windows policies, the downloaded zip file containing the Omnia Connector might be locked. To ensure the connector will be properly installed, before unzipping right click on the file and open its properties. If the Unblock button is present, click on it and apply the changes so that the file is properly unblocked.

4. Manage connector

When the connector is installed as a Windows service, it can be started or stopped on Windows Services list.

The connector can also be started through console, by inserting on cmd Omnia.Connector.Windows.exe.

Either way, the connector will launch three different processes on the machine:

  • Omnia.Connector.Windows.exe
  • Omnia.Services.Behaviours.Manager.exe
  • Omnia.Services.Behaviours.Server.exe

All processes are essential and should not be manually closed, so that the connector is always responsive.