Support for multiple brokers

To allow the broker to accept connections from other brokers you can define and configure broker connections using the trc_broker.properties file.

About this task

When you have multiple brokers defined in your environment you should configure broker control connections and define a prefix for each connection parameter to allow the broker to find all required settings for each connection. Broker connections need to be configured between the brokers that will connect to each other. The brokers use the network of control connections to determine which broker has the connection from the target. When the target is located, the controller is reconnected to the same broker as the target. Configure any broker connections when configuring the trc_broker.properties file.
Note:
  1. Do not prefix with # or ! as these are reserved for comments in properties files.
  2. If you want to include spaces in the prefix you have to escape them with \ for example : my connection.ConnectionType should be defined as my\connection.ConnectionType
To configure broker connections complete the following steps.

Procedure

  1. Configure the following parameters within the trc_broker.properties file of the broker that will connect to connect to another broker.
    ConnectionType
    Defines the type of connection. Should be set to Broker For example: my\connection.ConnectionType=Broker
    DestinationAddress
    Defines the hostname of the broker that the connection is being made to. The broker with this address needs to be configured to accept inbound connections. This parameter is required. For example: my\connection.DestinationAddress=mybroker.ibm.com
    Note: Set the AllowBrokers parameter in the configuration file of the broker that this connection is being made to. Set this parameters to allow other brokers to connect to it. For more details, see Allowing endpoints to connect to a broker.
    DestinationPort
    Defines the TCP port of the broker to connect to. This parameter is required.
    PublicBrokerURL
    Determines the public address and port for the broker you are currently configuring. When there are multiple brokers configured, if the target connects to this broker and the controller connects to a different broker, the property is used to identify this broker so that the controller can connect to it and then successfully reach the target. This property should be set to hostname:port where hostname is the hostname of this broker machine and port is the port that this broker is listening for connections on. Default value is <blank.> .
    Note: The hostname used here should be the same as the hostname used when registering the broker on the Remote Control server.
  2. Save the file.

What to do next

When you have created a broker configuration you can register the brokers in the Remote Control database to be used for facilitating remote control connections across the internet. For more details, see Registering a broker on the server.