Configuration Guide

Special Notes

# Configuring Multi-Homed Hosts <-

By default, UM will select the first multicast-capable, non-loopback interface for multicast topic resolution. If you are fortunate, on a multi-homed host, the correct interface will be selected. However, this fortuitous selection should not be relied upon. Moving the interface card to a different slot, a change in the operating system kernel, and numerous other factors can lead to a different ordering of interfaces as reported by the operating system. This in turn can lead UM to a select a different interface after the change.

It is strongly recommended that the actual interface be specified. The resolver_multicast_interface (context) option allows you to explicitly specify the multicast interface. Note that this also changes the interface for LBT-RM and multicast immediate messaging.

Other interface options:
  resolver_unicast_interface (context) when using the unicast resolver
  request_tcp_interface (context) when using the request/response messaging
  transport_lbtru_interface (receiver)
  transport_lbtru_interface (source)
  transport_tcp_interface (receiver)
  transport_tcp_interface (source)

TCP transport:
  transport_tcp_port_low (context)
  transport_tcp_port_high (context)
  transport_tcp_port (source)

LBT-RM transport:
  transport_lbtrm_source_port_low (context)
  transport_lbtrm_source_port_high (context)
  transport_lbtrm_destination_port (source)

LBT-RU transport:
  transport_lbtru_port_low (context)
  transport_lbtru_port_high (context)
  transport_lbtru_port (source)
  transport_lbtru_port_low (receiver)
  transport_lbtru_port_high (receiver)

Multicast immediate messaging:
  mim_destination_port (context)
  mim_incoming_destination_port (context)
  mim_outgoing_destination_port (context)

Requests:
  request_tcp_port (context)
  request_tcp_port_low (context)
  request_tcp_port_high (context)

In addition, since machines acting as a firewall are often multi-homed as well, see Configuring Multi-Homed Hosts for additional considerations.

# Traversing a Firewall <-

To use UM across a firewall, several port options may need to be changed. The options of interest include:

Multicast resolver:
  resolver_multicast_port (context)

Unicast resolver:
  resolver_unicast_port (context)
  resolver_unicast_port_low (context)
  resolver_unicast_port_high (context)
  resolver_unicast_destination_port (context)