Recovering after the broker fails

Try to get to the root of the problem first, using the diagnosis techniques described throughout the Troubleshooting and support section of the information center. If your problem cannot be resolved using these techniques, contact your IBM Support Center. Use the procedure in this section only as a last resort.

Start of changeIf a broker's database becomes corrupted, follow the instructions described in Recovering after the broker database fails. If the database is not corrupted, but the problem cannot be corrected using problem determination, perform the following sequence of operations to re-create the broker: End of change

  1. Ensure that no workbench users are deploying to brokers. You must wait until these actions have completed.
  2. Stop the broker using the mqsistop command.
  3. Stop the broker's queue manager using the endmqm command.
  4. Start of changeTake a backup of the broker database tables. These tables are interdependent and must all be in a consistent state when restored. You cannot backup or restore individual tables.End of change
  5. Find the BrokerUUID value in the following way:
    • On Windows systems, use the regedit command to examine HKLM\SOFTWARE\IBM\WebSphereMQIntegrator\<BROKER_NAME>\BrokerUUID and note the BrokerUUID value.
    • On Linux and UNIX systems, use cat $MQSI_REGISTRY/registry/<BROKER_NAME>/BrokerUUID and note the BrokerUUID value.
  6. Delete the broker using the mqsideletebroker command.
  7. Recreate the broker using the mqsicreatebroker command.
  8. Set the BrokerUUID to the value that you noted during backup in the following way:
    • On Windows systems, use the regedit command to set HKLM\SOFTWARE\IBM\WebSphereMQIntegrator\<BROKER_NAME>\BrokerUUID to the value that you noted during backup.
    • On Linux and UNIX systems, use print -n <VALUE_NOTED> <$MQSI_REGISTRY/registry/<BROKER_NAME>/BrokerUUID.
  9. Restore the broker database tables, either from the backup you have just taken, or from a previously successful backup version.
  10. Start the broker using the mqsistart command.
  11. Redeploy the domain configuration to ensure that the configuration across the broker domain is consistent.
Related tasks
Creating a broker
Deleting a broker
Recovering after failure
Related reference
mqsicreatebroker command
mqsideletebroker command
mqsistart command
mqsistop command