Starting and stopping the appliance

You can shut down and restart the appliance by using the command line interface or the IBM® MQ Appliance web UI.

Restarting the appliance

You can restart the appliance if you want to clear memory and temporary space. You might restart, for example, before you copy a new firmware image to the appliance.

You can shut down and restart the appliance by using the command line interface. Complete the following steps:

  1. Connect to the IBM MQ Appliance as described in Command line access. Log in as an administrative user.
  2. Type the following command: 
    shutdown reboot
You can also shut down and restart by using the IBM MQ Appliance web UI. Complete the following steps:
  1. Start the web UI as described in Configuring the IBM MQ Appliance web UI.
  2. Click the administration icon Shows the administration icon and select Main > System Control.
  3. Set the Shutdown Mode to Reboot system.
  4. Click Shutdown. The appliance restarts.

When you restart the appliance, any auto-reconnect clients are triggered to attempt reconnection to other instances of queue managers that are ended by this restart.

Shutting down the appliance

You can shut down the appliance without restarting it.

You shut down the appliance by using the command line interface. Complete the following steps:

  1. Connect to the IBM MQ Appliance as described in Command line access. Log in as an administrative user.
  2. Type the following command: 
    shutdown poweroff
You can also shut down the appliance by using the IBM MQ Appliance web UI. Complete the following steps:
  1. Start the web UI as described in Configuring the IBM MQ Appliance web UI.
  2. Click the administration icon Shows the administration icon and select Main > System Control.
  3. Set the Shutdown Mode to Power off system.
  4. Click Shutdown. The appliance shuts down.

When you shut down the appliance, any auto-reconnect clients are triggered to attempt reconnection to other instances of queue managers that are ended by this shut down.

Restarting queue managers by using the command line

Queue managers can be configured to automatically start when the appliance is restarted, or they can be configured to only start when requested by an administrator. Queue managers that are configured for high availability restart automatically by default.

Use the crtmqm command with the -sa option to create a queue manager with the auto-start feature enabled (see crtmqm (create queue manager)).

To check the auto-start capability of an existing queue manager, use the following command: 
dspmqini -m QM_name -s InstanceData

Where QM_name is the name of the queue manager whose auto-start setting you want to check. The command displays the InstanceData stanza of the qm.ini file. This contains the Startup key, which has the following setting:

  • Startup = Automatic, auto-start is enabled.
  • Startup = Manual, auto-start is disabled.

If dspmqini does not report the Startup key in the InstanceData stanza, then a setting of Manual is implied. This means that the queue manager does not start automatically when the appliance is restarted.

A high availability (HA) queue manager has a value of Startup = HA, and you cannot modify this. If the queue manager is removed from HA control, then the value of Startup is set to Manual (and you can set it to Automatic if required).

To change the auto-start setting of an existing queue manager, you must edit the InstanceData stanza of the qm.ini file to change the setting of Startup to the required state. You use the setmqini command to change the setting. The following command enables auto-start: 
setmqini -m QM_name -s InstanceData -k Startup -v Automatic

The following command disables auto-start:

setmqini -m QM_name -s InstanceData -k Startup -v Manual