Connector Windows Service

Installation

This install script will install connector as Windows service which will be running under virtual Windows account NT Service\\2Ring [instanceName] [connectorName]. Script will also assign this account all required rights and permission needed for this service to run.

Navigate to the connector installation package and run install.ps1 as Administrator.

Use a non-core version of the Powershell (e.g Powershell 5.1).

Through the whole installation process, you can accept default values in parentheses by pressing Enter.

  1. Enter the 2Ring DW application instance name.

    Figure 1: Connector Windows Service Installation

    ../_images/connector-windows-service-1.png

  2. Enter the connector name.

    Figure 2: Connector Windows Service Installation

    ../_images/connector-windows-service-2.png

  3. Choose whether a connector service should be installed.

    Before proceeding with the installation of the connector service, the connector needs to be imported via the Administration Tool. For information about the connector installation, please reach out to 2Ring via support contacts listed on the 2Ring website at https://www.2Ring.com/contact.

    Figure 3: Connector Windows Service Installation

    ../_images/connector-windows-service-3.png

  4. Enter the full path to the connector instance directory.

    Figure 4: Connector Windows Service Installation

    ../_images/connector-windows-service-4.png

  5. Enter the API URL of the 2Ring DW application instance.

    Figure 5: Connector Windows Service Installation

    ../_images/connector-windows-service-5.png

  6. Enter the API key of the 2Ring DW application instance.

    Figure 6: Connector Windows Service Installation

    ../_images/connector-windows-service-6.png

  7. WebService connector Windows service has been successfully installed.

    Figure 7: Connector Windows Service Installation

    ../_images/connector-windows-service-7.png

The connector windows service has to be manually started after the installation.

Figure 8: WebService connector Windows Service

../_images/connector-installation-windows-service.png

Running connector via command prompt

The connector can also run via the command line. To run the connector in the command line, open it and navigate to the connector deploy folder and run the following command:

ConnectorHost.exe --connector=Webservice

Never run more than one instance of the same connector simultaneously, or the data may get corrupted. It is recommended to use the Windows service in a production environment and only use the command line mode for troubleshooting purposes. Do not forget to stop the service before running the command line mode.