Uninstall Maximo Application Suite

By uninstalling IBM® Maximo® Application Suite, you remove the core application and all deployed applications from your environment.

Uninstallation process

The uninstallation process sequentially removes the Maximo Application Suite components that were installed.

  1. If installed, the Maximo Monitor application and the IoT tool are removed.
    After the applications are removed, all config maps and secrets are also removed.
  2. If you use Strimzi as the Kafka operator, the Kafka topics can be removed if needed.
  3. All entries that are related to the instance can be removed from the MongoDB instance if needed.
    During this phase, double confirmation is required for each database removal to ensure no unexpected data loss. A confirmation string is created at the start of this phase to provide the confirmation for each removal.
  4. The default ClusterIssuer resource is also removed if one was not provided on the installation.
    If you created and provided your own ClusterIssuer resource to the install script, it is not removed.
  5. Finally, all projects and namespaces that are related to this instance are removed.

Even though multiple instances of Maximo Application Suite might be installed on a single cluster, the uninstaller removes just one instance at a time. Run the uninstall multiple times to remove each instance.

Note: Supporting components, such as MongoDB and IBM® Cloud Pak for Data, are not removed by the uninstaller and must be removed separately if needed.

Before you begin

Before you run the uninstaller, make sure you complete the following steps:

Acquire the uninstallation script

If you do not have access to the uninstall.sh script, you must download the installer package, which contains the uninstall script. Ensure you download the package that matches your installed instance.

For more information, see the procedure that is outlined in the Maximo Application Suite download document to download the installer.

Configure logging

By default, logging is output to the console and to the logs directory that is located relative to the directory where you run the uninstall.sh script. You can also define a different logging location when you run the uninstaller:

./uninstall.sh -i mymas -l /var/log/mas-logs

Run the uninstaller

  1. Log in to the Red Hat® OpenShift® web console as an administrator.
  2. Copy the login token.
    1. Click your user account icon and select Copy Login Command.
    2. Copy the login token.
  3. In your local command line, paste in the login token and press enter to log in to the OpenShift cluster.
    Example:
     oc login --token=kiaj2_jkoasunJljsLdsqdsa787asd --server=https://api.myopenshiftcluster.com:6443
    
    Note: You can also use a valid token for a service account if you are using a service account to uninstall. Maximo Application Suite.
  4. Uninstall your Maximo Application Suite instance.
    Use the provided uninstall.sh script to remove a Maximo Application Suite instance from your OpenShift cluster.
    From your OpenShift command line run:
    /uninstall.sh -i instance_name
    Where instance_name is the name of the Maximo Application Suite instance that you want to uninstall.

Important: The uninstaller first removes any installed applications. Depending on the application, this step might take several minutes to complete. Monitor the uninstaller prompts for status. If an application uninstallation takes longer than expected, check the corresponding operator in the application namespace (mas-{instance_name}-application) for potential issues.
Example: For IoT, check the iot-operator in the mas-{instance_name}-iot namespace.