Start of change

Canceling a deployment that is in progress

Before you start:

Canceling a deployment should only be a last resort if you are sure that a broker, or several brokers in a domain, will never be able to process a previous deployment request. For this reason, make sure that you understand the implications of this action, described in the Cancel deployment overview topic.

It is possible to cancel all outstanding deployments in the domain, or just those to a particular broker.

You must be a member of the mqbrops group to cancel an in-progress deployment.

If you want to ensure that previous deployment messages are not processed when an affected broker is restarted, first remove any deployment messages:
  1. Stop the broker
  2. Check the broker's SYSTEM.BROKER.ADMIN.QUEUE and SYSTEM.BROKER.EXECUTIONGROUP.QUEUE, and manually remove any deployment messages.
  3. Proceed to cancel the deployment.
There are two ways to cancel a deployment:

Using the Message Brokers Toolkit

Follow these steps to cancel the deployment to all outstanding deployments in a domain, using the workbench:

  1. Switch to the Broker Administration perspective.
  2. Start of changeIn the Domains view, right-click a connected domain.End of change
  3. Click Cancel Deployment.

Deployments to the broker or domain are canceled.

Next:

Continue by checking the results. (A BIP0892I information message is displayed to show that the request was received by the Configuration Manager.)

Using the mqsideploy command

Follow these steps to cancel a deployment using the mqsideploy command:

  1. Open a command window.
  2. Using this as an example, enter the appropriate command, typed on a single line:
    mqsideploy -i ipAddress -p port -q qmgr –c –b B1

    This cancels deployment to the broker called B1. Omit the -b parameter to cancel all outstanding deployments in the domain.

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

Next:

Continue by checking the results. (A BIP0892I information message is displayed to show that the request was received by the Configuration Manager.)



End of change