Adding Brokers to a Conventional Cluster

The procedure for adding a new broker to a conventional cluster depends on whether the cluster uses a cluster configuration file.

To Add a New Broker to a Conventional Cluster Using a Cluster Configuration File

1. Add the new broker to the imq.cluster.brokerlist property in the cluster configuration file.

2. Issue the following command to any broker in the cluster:

      imqcmd reload cls
   

   This forces each broker to reload the imq.cluster.brokerlist property. It is not necessary to issue this command to every broker in the cluster; executing it for any one broker will cause all of them to reload the cluster configuration.

3. (Optional) Set the value of the imq.cluster.url property in the new broker’s instance configuration file (config.properties) to point to the cluster configuration file.

4. Start the new broker.

   If you did not perform step 3, use the -D option on the imqbrokerd command line to set the value of imq.cluster.url to the location of the cluster configuration file.

To Add a New Broker to a Conventional Cluster Without a Cluster Configuration File

1. (Optional) Set the values of the following properties in the new broker’s instance configuration file (config.properties) :

   imq.cluster.brokerlist

   
   

   imq.cluster.masterbroker (if necessary)

   
   

   imq.cluster.transport (if you are using a secure cluster connection service)

   
   

   When the newly added broker starts, it connects and exchanges data with all the other brokers in the imq.cluster.brokerlist value.

2. Modify the imq.cluster.brokerlist property of other brokers in the cluster to include the new broker.

   This step is not strictly necessary to add a broker to a functioning cluster. However, should any broker need to be restarted, its imq.cluster.brokerlist value must include all other brokers in the cluster, including the newly added broker.

3. Start the new broker.

   If you did not perform step 1, use the -D option on the imqbrokerd command line to set the property values listed there.