Deleting a multi-instance integration node

Delete a multi-instance integration node without affecting the shared multi-instance configuration.

About this task

Important: The order of deletion of a multi-instance integration node and its associated instances affects the shared configuration. Take care to use the correct command for each step in the process.

You must remove the integration node instances by using the mqsiremovebrokerinstance command before you attempt to remove the integration node itself. This command removes all local references to the integration node instance, but does not affect the shared configuration for the multi-instance integration node on the shared work path. The mqsiremovebrokerinstance command cannot be run against the standby integration node instance when it is running; stop the integration node instance before you run this command.

If you unintentionally remove an integration node instance, it can be re-created by using the mqsiaddbrokerinstance command, providing that the mqsideletebroker command was not already used to delete the integration node.

If the multi-instance integration node was removed by using the mqsideletebroker command before the associated integration node instances were removed, it will not be possible to start the integration node instances. To recover from this situation, re-create the multi-instance integration node by using the mqsicreatebroker command with the -e parameter, specifying the original shared work path location.

The following procedure gives an overview of how to delete a multi-instance integration node:

Procedure

  1. Stop the multi-instance integration node on computer A.
  2. Stop the integration node instance on computer B.
  3. Remove the integration node instance on computer B.
    Use the following command, where IBNODE represents the name of the integration node:
    mqsiremovebrokerinstance IBNODE
    For more information, see mqsiremovebrokerinstance command.

    Repeat this step for all integration node instances.

  4. Remove the multi-instance integration node on computer A.
    Use the following command:
    mqsideletebroker IBNODE
    This process removes all references to the integration node on both the local and shared work paths. For more information, see mqsideletebroker command.

Results

You have deleted the multi-instance integration node, and removed all of its instances.