Maximo Application Suite Customer-managed

Uninstalling Maximo Application Suite

Starting in 8.10, you can uninstall the IBM® Maximo® Application Suite with the mas uninstall command by using the CLI command utility. By uninstalling Maximo Application Suite, you remove the core application and all deployed applications from your environment.

About this task

The uninstallation process sequentially removes the Maximo Application Suite applications, industry solutions, add-ons, and tools that were installed.
  • After the industry solutions, add-ons, and tools are removed, all config maps and secrets are also removed.
  • If you use Strimzi as the Kafka operator, the Kafka topics can be removed if needed.
  • 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.
  • 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 installation script, it is not removed.
  • 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.

You can also automate the Maximo Application Suite uninstallation. First run the ansible role suite_app_uninstall to remove the applications and then use the ansible uninstall core playbook to uninstall Maximo Application Suite core platform and its dependencies from your cluster. For more information, see suite_app_uninstall role and uninstall core playbook.

Procedure

Run the mas uninstall [options] command either in interactive or non interactive mode.

  1. Run the command in interactive mode. 
    mas uninstall -i|--id MAS_INSTANCE_ID
    where,

    -i refers to interactive mode

    --id MAS_INSTANCE_ID refers to the Maximo Application Suite that is to be uninstalled

    Other options include --no-confirm to launch the uninstall without prompting for confirmation and -h|--help to display a help message

    Alternatively, you can run the command in non interactive mode.
    mas uninstall -i MAS_INSTANCE_ID -\-no-confirm
  2. If you are not connected to a Red Hat® OpenShift® cluster, you are prompted to provide the server URL and token, and whether to verify the server certificate or not.
    If you are already connected to a cluster you can opt to change to another cluster.