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.
|