Failing over a multi-instance integration node and queue manager

An active integration node instance fails over when its associated active multi-instance queue manager either terminates unexpectedly, or stops in a controlled manner. The action of stopping an active integration node instance on an active multi-instance queue manager does not by itself cause a standby integration node instance to become active.

About this task

The following examples list the 3 failover scenarios, and how to failover:

Procedure

  • Controlled failover.
    • Switch over to a standby instance by stopping an active queue manager with the endmqm command:
      endmqm -s QueueManager
      where QueueManager is the name of the queue manager that you are stopping. As the active instance of the queue managers goes down, the standby instance starts.
  • Immediate failover.
    • Stop an active queue manager process with the kill command on Linux® and UNIX, or end the process with the Windows task manager on Windows:
      kill -9 amqzxma0 ProcessID
      where ProcessID is the process ID of the amqzxma0 process that you need to kill. The standby instance of the queue manager becomes active.
  • Shutting down the server.
    • Restart the server that the active instance of the queue manager is running on. The standby instance of the queue manager becomes active.

Results

If the multi-instance integration node was configured as dependent on an MQ Service, when the multi-instance queue manager restarts, the integration node instance will also start on the computer on which the queue manager is running. Otherwise, the integration node that is in standby node becomes active.