Publisher API Express Configuration

As part of the express installation, you can choose to configure the publisher API. You can identify data channels to be used by the publisher API, set the number of message buffers, and enter the JINI server host name.

Publisher API configuration dialog 1

The publisher API sends messages to subscribers over one or more data channels using multicast. Four channels are recommended for a system that handles 300,000 messages per second. Use this dialog to identify the data channels.

Publisher API dialog 1 configuration options

Field name

Default value

Description

Channel Name

Custom Channel 1

Identifies the data channel that publisher API uses to send messages to a subscriber. You can use any value as the channel name.

Supply a channel name to any subsequent data channels you define. Assigning unique names to channels can help you track each one more easily in the event that an error is logged.

Local Interface

None

Identifies the IP address of the network interface to which this channel will be bound. This allows a user to bind various data channels to separate network interfaces to enhance performance.


  • If you plan to install all publishers and subscribers on the same server, you must configure the local interface to use the loopback interface (127.0.0.1).

  • Use the local machine address of the secondary Ethernet network card installed by the system administrator, if you install publishers and subscribers on different servers.

Broadcast IP Address

224.0.2.0

Identifies the Class D multicast IP address that the publisher API uses to send messages to subscribers using multicast. This value should match the multicast address that the subscribers use to receive messages.

Although the installer assigns 224.0.2.0 as a default multicast IP address to all Broadcast IP address fields, your Network Administrator can choose an alternate multicast address. All multicast IP addresses must range from 224.0.2.0 through 224.0.255.0.

Broadcast Port

3250

Identifies the local port on which this data channel will operate.

Publishers can use multicast to send messages to a subscriber on multiple data channels that share the same local interface and broadcast IP address, but the broadcast port must be unique to that 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.

Publisher API configuration dialog 2

Tune the number of message buffers for peak performance.

Publisher API dialog 2 configuration options

Field name

Description

Number of message buffers

Identifies the number of packets the subscriber temporarily stores to track data deliveries. Subscribers track the number of packets delivered by a publisher. If a subscriber suspects that a packet is missing, a resend request is sent to the publisher to retrieve the missing data.

Publisher API configuration dialog 3

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, you must identify the JINI server host name to register the publisher API with the JINI server.

Publisher API dialog 3 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.