Configuring the RVI Attach Listener

How to:

Each Relay server maintains a list of attachment points, which is used to direct relayed messages to available Execution engines. Attachment points are characterized by a service name, an IP address, and a port. The Relay service channel is configured with the service name, which is resolved at run time to the target IP and port. Service names should be descriptive, but need not be related to a message type, channel name or host name. Multiple attach points for the same service name may be registered with one relay server, in which case, the connections they represent are assigned to relay events using algorithms which maintain a balanced work distribution (for example, Least Recently Used).

The purpose of the RVI Attach listener is to process attach messages from running Execution Channels in order to construct the attachment point list. The RVI Attach logic maintains the integrity of the attach point list by removing connections which have become unavailable. When that happens, other attach points offering the same named service are not affected.

Note: This section describes how to configure an RVI Attach listener. To construct a fully populated iWay Service Manager channel, incorporate the listener into an inlet and then use the inlet in a channel. For more information on how to design and build a channel, see the iWay Service Manager User's Guide.


Top of page

x
Procedure: How to Configure the RVI Attach Listener

To configure the RVI Attach listener:

  1. In the left console pane of the Registry menu, select Listeners.

    The Listeners pane opens, as shown in the following image.

    The provided table lists any existing listeners and a short description for each.

  2. Click Add.

    The Select listener type pane opens.

  3. Select the RVIAttach listener from the drop-down list, then click Next.

    The Configuration parameters for new listerner of type RVIAttach opens.

  4. Provide the appropriate property values for the RVI Attach listener, as defined in the following table.

    Note: An asterisk indicates a required property.

    Property

    Definition

    Port*

    The port on which the attach listener is listening to receive service attachments.

    Local bind address

    On a server with multiple physical network interfaces, this specifies which interface the listener is bound to. This can usually be left blank.

    Allowable Client

    An optional host name or IP address, which, if entered, limits connections to those from the designated host or IP address. Only one host name or IP address is allowed per RVI Attach listener. If you wish to allow a set of Executor hosts to connect, one RVI Attach listener must be configured for each.

    Timeout

    The frequency with which the attach point checks for stop requests.

    Keep Alive

    The interval at which to poll to ensure that a connection is still available. If an interval is specified, the attach point sends a keep alive message on each attached link. Care should be taken in setting this property, as overly short polling intervals can impact bandwidth and CPU utilization.

  5. Click Next.

    The Select listener type pane opens.

  6. Provide a name and optionally, a description for the RVI Attach listener, and click Finish.

    The newly created RVI Attach listener is added to the list in the Listeners pane, as shown in the following image.


iWay Software