Configuring a Message Broker Cloud

If you plan to run more than one Message Broker, they probably should be configured into a cloud.

To create a Message Broker cloud:

  1. If you have not already done so, install the Message Brokers. Refer to the StarTeam Installation Guide for instructions.
  2. For each Message Broker you want to include in the cloud, open the associated ActiveMQMessageBroker.ini file in a text editor.
  3. Add or edit the following line to list all the Message Brokers you want to include in the cloud:
    server_names=tcp://servername:endpoint

    where

    • servername is the TCP/IP address or computer name where the remote Message Broker is installed.
    • endpoint is the port number on which the remote Message Broker is listening (5101 is the default Message Broker port).

    Separate multiple addresses by a comma (,). For example, the following line creates a cloud consisting of three Message Brokers: the current Message Broker and the two Message Brokers listed below.

    server_names=tcp://ProdServer1:61616,tcp://ProdServer2:61620
    Tip: If a Message Broker operating outside of a firewall must participate with Message Brokers behind a firewall, an inside Message Broker should be directed to establish contact with the outside Message Broker, because the firewall may prohibit the establishment of the connection in the reverse direction.
  4. Save and close the file. The next time you start the Message Broker, it will establish connections with the Message Brokers listed in the server_names parameter.