Configuring the RVIAttach Listener

Reference:

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 RVIAttach listener is to process attach messages from running Execution Channels in order to construct the attachment point list. The RVIAttach 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 RVIAttach listener. To construct a fully populated iSM 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.

To configure the RVIAttach listener:

  1. Perform the steps as described in Configuring Listeners.
  2. Ensure that you select RVIAttach as the listener type you are configuring.

    For a complete description of the configuration parameters that are available for the RVIAttach listener, see RVIAttach Listener Configuration Parameters.


Top of page

x
Reference: RVIAttach Listener Configuration Parameters

The following table lists and describes parameters for the RVIAttach listener.

Property

Description

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.

SSL Context Provider

The defined iWay Security Provider for SSL Context.

Allowable Clients

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.


iWay Software