Skip to content

Troubleshooting — Maximo Application Suite

To identify and resolve problems with IBM® Maximo® Application Suite, you can use the troubleshooting and support information. For information regarding the service and support, see the IBM Support Guide on IBM.com.

Continuous Delivery Support

Starting with Maximo Application Suite 8.7, Maximo Application Suite introduced a continuous delivery support model that incrementally delivers regular product fix packs. For more information, see IBM® Maximo® Application Suite product lifecycle.

Release Notes

A maintenance fix might be available to resolve your problem. Review the readme files before you apply fixes to ensure that the version, release, modification, and fix level is appropriate for your requirements. For more information, see Maximo Application Suite release notes.

Product-Specific Help Guides

The following product-specific help guides are available:

Application-Specific Troubleshooting

Application-specific troubleshooting documentation is available to help:

Self-Help

Before you report your problem to IBM Support, see whether the self-help support options resolve your problem:

  • Ensure that your service is available and is not undergoing any maintenance work

  • Maximo Application Suite: Contact your local Maximo Application Suite administrator

  • Search the IBM Support Community knowledge bases and forums for answers to your question or issue

  • Look through open technotes that cover troubleshooting Maximo Application Suite issues

Prometheus and Grafana Support

A number of components of the IoT tool and the suite licensing service generate Prometheus-based metrics. The metrics can be accessed directly or by using a set of sample Grafana dashboards.

For more information about how to use Prometheus and Grafana with Maximo Application Suite, see:

Product, Application, and Tools Version

In communications with your local Maximo Application Suite administrator or with IBM Support, you might need to provide information about the product, application, or tool version that you are inquiring about.

Complete information about your Maximo Application Suite setup is available from the Maximo Application Suite user interface Help > About menu. From there, you can see the version number of each component and also export the full version listing as a .JSON file.

Collecting MustGather Data

Maximo Application Suite provides a MustGather script that you must use to collect information before you raise an issue that requires IBM support.

For more information, see the Collect MustGather data technote.

Specific Troubleshooting Topics

Troubleshooting Amazon Web Services

To get help and support for your IBM Maximo Application Suite product, see the IBM Support Guide on IBM.com.

Troubleshooting Installation Problems for Microsoft Azure

An unsuccessful IBM Maximo Application Suite installation has many possible causes, such as missing or invalid installation parameters, boot node creation failures, or cluster creation problems.

Troubleshooting Installation and Configuration Issues

Installation and configuration troubleshooting information for Maximo Application Suite is available in the Support knowledge base and throughout the documentation.

Troubleshooting Upgrade Issues

Troubleshooting information is available for IBM Maximo Application Suite upgrade issues, such as expired API keys, dropped database connections, or data migration.

Getting Help

If you encounter issues not covered here:

  1. Check the FAQ
  2. Ask your facilitator
  3. Refer to the IBM Support resources listed above

Reference

For more detailed troubleshooting information, visit: IBM Maximo Application Suite Troubleshooting Documentation