Deploying a broker configuration

If you have modified runtime properties, including details of execution groups, and multicast and inter-broker settings, use a broker configuration deployment to inform the broker of your changes.

Using the Message Brokers Toolkit

You do not need to deploy a broker configuration manually from the workbench. If you modify multicast or interbroker settings in the Broker Administration perspective, a broker configuration deployment starts automatically when you apply the changes. This process runs in the background.

Using the mqsideploy command

Follow these steps to deploy a broker configuration using the mqsideploy command:

  1. Open a command window that is configured for your environment.
  2. Using the examples below, enter the appropriate command, specifying the broker to which you want to deploy:
    On distributed platforms:
    mqsideploy -i ipAddress -p port -q qmgr -b broker

    where -i (IP address), -p (port), and -q (queue manager) represent the connection details of the queue manager workstation.

    On z/OS®:
    /f MQ01CMGR,dp b=broker

    where MQ01CMGR is the name of the Configuration Manager component.

    If you specify the broker to which you want to deploy (-b or b=), without indicating a BAR file (-a), the broker configuration is deployed, rather than a message flow application.

Next:

Continue by checking the results of the deployment.

Using the Configuration Manager Proxy

Use the deploy method of the BrokerProxy class. By default, the deploy method performs an incremental (delta) deployment. To deploy the complete hierarchy, use a variant of the method that includes the Boolean isDelta parameter set to false. Setting this parameter to true indicates an incremental deployment.

To perform an incremental deployment, for example:
import com.ibm.broker.config.proxy.*;

public class DeployBrokerConfig {
  public static void main(String[] args) {
    ConfigManagerConnectionParameters cmcp =
            new MQConfigManagerConnectionParameters
                ("localhost", 1414, "QM1");
    try {
      ConfigManagerProxy cmp = ConfigManagerProxy.getInstance(cmcp);
      TopologyProxy t = cmp.getTopology();
      BrokerProxy b = t.getBrokerByName("BROKER1");
      if (b != null) {
        b.deploy();
      }
    }
    catch (ConfigManagerProxyException e) {
      e.printStackTrace();
    }
  }
}

Next:

Continue by checking the results of the deployment.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Last updated : 2009-01-07 15:21:53

af35110_