A network relay is a setting on an IBM® UrbanCode™ Deploy
server that opens a Java™ Message Service (JMS) port for
communication with other servers.
About this task
Network relays create a JMS mesh, which facilitates JMS communication between
servers in a clustered high-availability server configuration.
Network relays are required only if you have more than one server. Also, network relays
facilitate communication only among servers; network relays are not used for agents or agent
relays. Because the servers use the same database, you can create relays on any server; the
other servers all have access to those network relays.
Note: The use of network relays to reverse the direction of JMS communication through a
firewall is deprecated.
Procedure
- On any server in the cluster, click . The Create Network Relay dialog box is
displayed.
- Enter a name for the network relay.
- In the Host field, enter the host name or IP address of the
target server.
- In the Port field, enter the JMS communication port of the
target server. The default server JMS communication port number is 7918.
- Select the Active check box.
- Click Save.
- On the same server, repeat the process to create a network relay to each server in the
cluster, including a relay that points to the current server itself.
Results
The servers can now communicate via JMS.
Example
If you have four
IBM UrbanCode Deploy
servers in a clustered high-availability configuration, on only one of the servers, create
four network relays. One relay points to each server, including a relay to connect to the
server on which you create the network relays. A JMS request from any agent or agent relay is
routed to the appropriate
IBM UrbanCode Deploy
server by using the JMS mesh and these network relays.