Cancel deployment

The Configuration Manager allows only one deployment to be in progress to each broker at any one time. If for some reason a broker does not respond to a deployment request, subsequent requests cannot reach the broker, because, to the Configuration Manager, a deployment is still in progress.

Canceling deployment tells the Configuration Manager to assume that a broker will never respond to an outstanding deploy. In most cases, the action does not remove any deployment messages that have been sent to the broker, nor does it alter the running configuration of the broker. (Thus, for any brokers that have successfully deployed a configuration, the deployed information remains on the broker.)

If a broker subsequently does provide a response to an outstanding deployment that has been canceled, the response is ignored by the Configuration Manager and there is then an inconsistency between what is running on the broker and the information that is provided by the Configuration Manager.

Because of this risk of inconsistency, only cancel a deployment as a last resort, and only if you are sure that a broker will never be able to process a previous deployment request. However, before canceling deployment, you can manually remove any outstanding deployment messages to ensure that they are not processed.

When canceling deployment across the domain, the locks for all outstanding deploys in the domain are removed. When canceling deployment for a specific broker, only the lock for that broker is removed.

Canceling deployment is the equivalent of the 'force deploy' action in previous versions, except that cancel does not redeploy domain information.

You can cancel a deployment:

Cancel deployment to a domain

Canceling the deployment to a domain tells the Configuration Manager to assume that all brokers in the domain that have outstanding deployments will not respond. If a broker then does provide a response to an outstanding deploy that has been canceled, it will be ignored and there will be an inconsistency between what is running on the broker and the information that is provided by the Configuration Manager.

When applied to a domain, canceling deployment does not remove deployment messages that have been sent to the brokers, and does not change the brokers' running configuration.

When to use it
Cancel a domain deployment only if these two conditions are both met:
  • You attempt a deployment and you receive error message BIP1510.
  • Any of the brokers that have outstanding deployments are not responding.
When not to use it
  • If a broker is simply taking a long time to respond to a deployment request. The broker might have been temporarily stopped, for example.
  • If other users might be deploying to the domain at the same time.
  • If only one broker is not responding, or a small number of brokers are not responding. In this case, cancel the broker deployment instead.

Cancel deployment to a broker

Canceling the deployment to a single broker tells the Configuration Manager to assume that a specific broker in the domain that has an outstanding deployment will not respond. If the broker then does provide a response to an outstanding deploy that has been canceled, it will be ignored and there will be an inconsistency between what is running on the broker and the information that is provided by the Configuration Manager.

When applied to an individual broker, canceling deployment causes the Configuration Manager to attempt to remove from the broker, deployment messages that have not yet been processed. This only succeeds if the broker and the Configuration Manager share the same queue manager and if the message has not already been processed by the broker.

When to use it
Cancel a domain deployment only if these two conditions are both met:
  • You attempt a deployment and you receive error message BIP1510.
  • The broker is not responding.
When not to use it
  • If the broker is simply taking a long time to respond to a deployment request. The broker might have been temporarily stopped, for example.
  • If the version of the connected Configuration Manager is earlier than Version 6.0. In this case, canceling deployment to a specific broker has no effect; you must cancel the entire domain deployment instead.
Related concepts
Deployment overview