Deploying a broker archive file

The following steps show you how to deploy a broker archive (bar) file from the Broker Administration perspective.

  1. Click the bar file shown in the Broker Administration Navigator view to highlight it.
  2. Drag the file onto your target execution group shown in the Domains view. If the chosen bar file is currently edited and not saved, you are asked whether you want to save before deployment. If you click Cancel, the bar file is not saved and deployment does not take place.
The Configuration Manager deploys the bar file contents (message flows and message sets) to the execution group. In the Domains view, the assigned message flows and message sets are added to the appropriate execution group.

Deployment can also be initiated using the mqsideploy command. See mqsideploy command for usage details.

Note: You can deploy only to an execution group that is not ACL restricted.
Look in the Event Log to verify the results of the deployment. Double-click Event Log in the Domains view under the target execution group. Once the deploy has been initiated, a BIP08921 information message is displayed, confirming that the request was received by the Configuration Manager. If the deploy was successful you see the following messages in the Logs view:
  • BIP4040I
  • BIP2056I
If you try to deploy message flows that are larger than 2 MB, a BIP1205 error message is displayed. To solve this problem, run the mqsimigrateconfigxmldata.cmd script to increase the storage available for message flows to 10 MB:
  1. Stop the Configuration Manager.
  2. Open a DB2 Command window by typing db2cmd from a Windows command window.
  3. Run the script providing the Configuration Manager database name, database userid and password. For example: C:>mqsimigrateconfigxmldata domain1 db2admin db2.
  4. Restart the Configuration Manager.
Related concepts
Message flow application deployment
Broker archive file
Related tasks
Creating a Configuration Manager
Creating a domain connection
Adding a broker to a broker domain
Using rapid application development (RAD)
Creating a new broker archive file
Adding message flows to a broker archive
Deploying message flow applications
Related reference
Broker Archive editor
Broker Administration perspective