RAPCache Subscriber Configuration

Operations Console communicates with the RAPCache subscriber through an intermediary UAF agent. Use this dialog to set the UAF agent listening port and optional UAF component name.

RAPCache subscriber dialog 1 configuration options
Field name	Default value	Description
Listening Port	3401	Identifies the listening port that the UAF agent uses to communicate with Operations Console. You can use any free port on your system.
Component Name	None	Identifies the component. This name appears on the Operations Console monitor. Although the component name is optional, naming the component provides an identity that distinguishes this component from other components of the same type. Projects may include several subscribers or publishers. Assign unique component names to more easily track them.

This is an optional dialog that appears only if you install the RAPCache subscriber separately from the RAPCache database server. Use this dialog to set the connection parameters to the RAPCache database server.

RAPCache subscriber dialog 2 configuration options
Field name	Default value	Description
Port	5000	Identifies the port that RAPCache uses to service connection requests. This value must match the port you defined when you installed the RAPCache server.
User Name	RAP_USER	Identifies the default RAP user, `RAP_USER`. You cannot change this value.

Note:

If you install the RAPCache server and RAPCache subscriber as a group, the server settings you have already defined automatically appear in this wizard.

RAPCache subscriber listens to one or more data channels for data sent by publishers. Use this dialog to identify each channel that you want RAPCache subscriber to monitor.

RAPCache subscriber dialog 3 configuration options
Field name	Description
Channel Name	Identifies a specific data channel that a particular publisher uses to send multicast messages to RAPCache subscriber. The channel name depends on the data channel you want RAPCache subscriber to monitor. For example, if you want RAPCache subscriber to monitor FAST feed handler, if you selected the defaults when you defined the FAST feed data channels, use FAST channel 1 as the first channel name. Subsequent channel names would match those of other data channel names.
Publisher Name	Identifies the publisher that sends messages to this subscriber, if an error is logged.
Local Interface	Identifies the IP address of the network interface that the publisher uses to send multicast messages to RAPCache subscriber. This value must match the local interface value that the publisher uses to send multicast messages. For example, if you want RAPCache subscriber to monitor a particular FAST feed handler data channel, the local interface value you use here must match the local interface value for the data channel you defined for FAST feed handler.
Broadcast IP Address	Identifies the Class D multicast IP address that the publisher uses to send multicast messages to RAPCache subscriber. This value must match the multicast address that the publisher uses to send multicast messages to RAPCache subscriber. For example, if you want RAPCache subscriber to monitor a FAST feed handler data channel that sends multicast messages on 224.0.2.0, use that address for this field. All multicast IP addresses must range from 224.0.2.0 – 224.0.255..
Broadcast Port	Identifies the port from which the publisher sends multicast messages to RAPCache subscriber. Publishers can send multicast messages to a RAPCache subscriber on multiple data channels that share the same local interface and broadcast IP address, but the broadcast port must be unique to each data channel.

Note:

After you define the first channel, do one of the following:

Click Next, making sure that "I would like to define another data channel" is selected.
Unselect "I would like to define another data channel", and click Next to display the next set of configuration options.

RAPCache subscriber listens for administrative requests from Operations Console. Use this dialog to set the administrative listening port and some performance options.

RAPCache subscriber dialog 4 configuration options
Field name	Default value	Description
Administration Listening Port	3402	Identifies the listening port that the subscriber uses to monitor administrative requests (shutdown, restart, and refresh commands) from Operations Console.
Local Interface	Machine hostname	Identifies the local interface that the subscriber uses to monitor administrative requests.
Number of Packet Buffers	8000	Identifies the number of packet buffers. The subscriber holds onto arriving packets of messages until the packets are processed. The specified number of packet buffers are created per data stream. This setting can have a value between 1 and 4 billion, but the machine must have enough memory to hold the number of packets specified. Adjust this setting if resend requests from publishers are failing, because the packet no longer exists. The number of packet buffers should be between 80 to 90 percent of the number of packet buffers that publishers use.

RAPCache subscriber communicates with one or more publishers. Use this dialog to identify the publishers you want RAPCache subscriber to monitor.

RAPCache subscriber dialog 5 configuration options
Field name	Description
Publisher Name	Identifies the publisher that publishes to this subscriber, in the event that an error is logged.
IP Address	Identifies the IP address of the machine on which the publisher resides. Used to connect to the publisher to request packet resends.
Resend Listener Port	Identifies the port on which the publisher uses to resend cached message packets to the subscriber. Publishers maintain a cache of recently sent message packets to ensure that the subscriber processes all message deliveries.

Note:

After you define the first publisher, do one of the following:

Click Next, making sure that "I would like to define another publisher" is selected.
Unselect "I would like to define another publisher", and click Next to display the next set of configuration options.

If you install the RAPCache subscriber at a different time than the RAPCache database server, this optional dialog appears and prompts you for the server’s location. If you install the RAPCache subscriber and the RAPCache database server at the same time, this dialog does not appear.

RAPCache subscriber dialog 6 configuration options
Field name	Default value	Description
RAPCache Server installation location	Defaults to the install machine name	Identifies the host name of the server where you installed the RAPCache server.

Installing Operations Console also installs a JINI server that tracks RAP components. This dialog appears only if you install components separately. If you install multiple components at the same time, and previously identified the JINI server host name, this dialog does not appear.

If this dialog appears, identify the JINI server host name to register the RAPCache subscriber with the JINI server.

RAPCache subscriber dialog 7 configuration options
Field name	Description
JINI Server Host Name	Identifies the host name of the server where the RAP JINI server resides. This is the machine on which Operations Console is installed.