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 prompted to deploy the updated topology configuration. Click Delta to perform a delta topology deploy, and save the changes to the Configuration Manager. If user preferences are not set to prompt, the topology deploy is automatic.

    A BIP08921 information message is displayed to show that the request was received by the Configuration Manager. Verify the results of the deployment by opening the Event Log.

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
Broker
Broker domain
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 topology configuration
Viewing broker domain log information
Related reference
Broker Administration perspective
Broker Topology editor