Configuration

To overcome a network barrier between Core and Connector services, a Relay Service based bridge can be configured using DataStudio. The type of the bridge will depend on the underlying connection mode (ACTIVE or PASSIVE) of the remote Connector Service. To support these modes of inmation Intercomponent Communication the bridge can be setup using :

  • Active Relay Service: Establishes a connection to the Core Service, to relay an active Connector connection to the Core Component

  • Passive Relay Service: Establishes a connection to the remote Connector Service, to relay a Passive Connector connection from the Core to the Connector component

Example

Relay service configuration scenario
Figure 1. Relay service configuration scenario

In the above example, a Connector service on machine A (IP: 172.0.0.2) shall be added to the I/O model, below a Core service on machine B (IP: 168.0.0.1). Since there is no direct network connection available, a Relay service must be installed to bridge the connection between the two components.

The Relay service is installed on machine C, which has two separate network adapters (IPs: 168.0.0.2 and 172.0.0.1). Therefore, the Relay service is able to reach both machines hosting the server components. Based on the connection mode of the Connector Service, ACTIVE or PASSIVE, the Relay Service must be installed as ACTIVE or PASSIVE Relay Service respectively.

Also, the I/O model of the system:inmation is configured as follows:

  1. Add a Relay Object under the Core and specify the IP = 168.0.0.1

  2. Add a Connector Object under the Relay to represent the remote Connector Service at IP: 172.0.0.2. Also, specify the connection mode at : Connector Object’s Property Panel > Properties > Communication > Connection Mode

Please note that in case of an Active Relay based communication infrastructure, the I/O model of the system:inmation must be pre-configured before the corresponding Active Connector service is started on the remote machine.

Service Installation

The Relay Service can be installed in either PASSIVE or ACTIVE mode corresponding to the connection mode of the Remote Connector Service as described above.

Table 1. Command line argument description for Relay Service installation
Action Options Description

help

Provides information about available actions and options.

-i

Install the inmation Relay Service

--corehost

Specifies the Core’s host address (required only for ACTIVE mode).

--coreport

Specifies a particular setting for the Core Service Port (required only for ACTIVE mode).

--instance

Optional, specifies the instance name of the Windows service to remove, by default "inmation Relay Service".

--relayport

Optional, specifies the port where the Relay Service will be listening for new connections, default is 6511.

--connect

Optional, specifies whether theRelay Service will be started in ACTIVE (Value: 0) or Passive mode (Value: 1). Default is 0.

-r

Removes the inmation Relay Service.

--instance

Optional, specifies the instance name of the Windows service to remove, by default "inmation Relay Service".



Example command to install the Relay Service in PASSIVE mode:

inmation.exe -i relay --relayport 6511

Example command to install the Relay Service in ACTIVE mode:

inmation.exe -i relay --relayport 6511 --corehost 168.0.0.1 --coreport 6512 --connect 1