Troubleshooting and support

Learn how to troubleshoot a problem with your IBM® software.

If your deployment fails

If your deployment fails, you can search for errors in the log files:

See the topics Collecting IBM MQ error logs from a virtual system instance and Viewing IBM MQ error logs from a virtual system instance to find out how to access error logs.
Click Logging and expand the Operating system node and then the IWD Agent node.
Search for the logs for the IBM MQ patterns part.
Note: The name of the IBM MQ patterns part matches the name of the software component.
Review the contents of the trace.log file.

If the General Parallel File System (GPFS) server gets out of sync

If you delete a pattern instance and then create a new one, reusing the virtual machine IP address in another pattern instance, the GPFS server can get out of sync. As a result, the volume will no longer mount. You can avoid this happening by shutting down the virtual machine instances cleanly before deletion. For more information, see GPFS Troubleshooting and tuning.

If the pattern you created fails to deploy and the trace.log file shows the IBM MQ error (893)

You created an IBM MQ Virtual System Pattern Type pattern with multiple queue managers but the GPFS storage limitation value is set too low and the deployment fails. You can avoid this happening by changing the GPFS storage maximum to 1G, to allow enough space for different scenarios, for example, when configuring two IBM MQ components into an IBM MQ Multi-Instance pattern with active and standby queue managers.

Note: Each queue manager requires just over 100M of space when created but this storage requirement will increase with further configuration and runtime processing of messages. The same GPFS partition might be used in multiple deploys, so you need to allow enough storage for the workload you require.

If you have problems that relate to IBM MQ IBM MQ Multi-Instance

For errors that relate to IBM MQ, see IBM MQ troubleshooting and support.

If the /usr file system is not large enough to install IBM MQ and an upgrade fix pack

On AIX®, the storage for the /usr file system might not be large enough for you to be able to install the IBM MQ product and an upgrade fix pack. There are two options that you can use to fix this issue:

Create an AIX OS image that gives enough space for /usr, which is the default installation and upgrade path for IBM MQ. The amount of space that you create must be more than 10G.
Use the OS add-on component to add additional disk and mount to /usr for IBM MQ installation and upgrade.