Removing a broker from a broker domain

Before you start:

You must complete the following task:

Removing a broker from a broker domain deletes its broker reference in the configuration repository. The broker is not deleted from the system when you perform this task; it simply marks the broker as logically deleted from the configuration repository.

If you want to move a broker from one topology to another, you need to delete and recreate the broker physically (using the mqsideletebroker and mqsicreatebroker commands) even if the Configuration Manager in both domains are at the same product and service release level. See Deleting a broker for further information.

The following steps show you how to remove a broker from a broker domain.

  1. Switch to the Broker Administration perspective.
  2. In the Domains view, expand the broker domain to reveal the broker that you want to remove.

    To remove more than one broker from the same broker domain, select each broker while holding down the Ctrl key.

  3. Right-click the broker and click Delete.
  4. Click OK at the prompt to confirm that you want to remove the broker from the broker domain.
  5. You are, by default, prompted to deploy the updated publish/subscribe topology configuration.

    You only need to deploy the topology if you are using publish/subscribe and want to share publications or subscriptions.

    If you are not using publish/subscribe, click None, as a deployment is not necessary; when removing a broker from the domain, the Configuration Manager automatically requests the broker component to stop message flows that are running and to tidy up any resources being used. (Although if this operation fails for any reason, you can again request the broker to tidy up by deploying a delta topology.)

    You can set user preferences so that you are not prompted to deploy the publish/subscribe topology. Instead, you can choose for either a complete or delta deployment to be performed automatically. Alternatively, if you are not using publish/subscribe, you might prefer to set the preference so that no automatic deployment takes place.

The broker and its execution groups are removed as components of the broker domain. Confirmation of the broker's deletion is in two places:
  • The broker is removed from the Domains view.
  • The broker icon is removed from the Broker Topology editor. If the broker was connected to another broker, this connection is also removed.

To delete the physical broker after you have removed the broker from the domain, refer to Deleting a broker.

Related concepts
Brokers
Broker domains
Configuration Manager
Related tasks
Adding a broker to a broker domain
Deleting a broker
Copying a broker
Modifying broker properties
Renaming a broker
Deploying a publish/subscribe topology
Viewing broker domain log information
Changing Broker Administration preferences
Related reference
Broker Administration perspective
Broker Topology editor