Maximo Application Suite Customer-managed

Restoring applications to earlier patch releases

If your Maximo® Application Suite application is updated or upgraded, the suite administrator can restore the application to a previous version by changing the version properties for the controller manager in the custom resource definition (CRD) and restoring the database.

About this task

If you updated an application and the database was updated to a later version, restoring to an earlier version does not automatically restore the database. To revert the database to an earlier version, you must apply the database backup that was done before the upgrade. For more information see, Backing up and restoring IBM Maximo Application Suite

You can restore the versions of the following applications.
  • Maximo Application Suite
    • You can restore to an earlier version of Maximo Application Suite only in 8.11 and later. For example, you can restore Maximo Application Suite from 8.11.1 or 8.11.2 to 8.11.0. However, you cannot restore Maximo Application Suite from 8.11.x to 8.10.x.
  • Maximo Manage
    • From Maximo Manage 8.7.1 and later, if Maximo Application Suite is upgraded, you can restore the Maximo Manage application to a previous version, for example, 8.7.2 to 8.7.1 or 8.7.0.
  • Maximo Health
  • Maximo Collaborate
    Note: Starting in Maximo Application Suite 9.1, IBM® Maximo Assist is now named IBM Maximo Collaborate.
    • Starting in Maximo Application Suite 9.0 after you upgrade to a later version of Maximo Assist, you can restore to a previous version of Maximo Assist. For example, you can restore Maximo Assist from 9.0.1 to 9.0.0. However, you cannot restore Maximo Assist from 9.0.0 to 8.11.
  • IoT
    • Starting in Maximo Application Suite 9.1 after you upgrade to a later version of IoT, you can restore to a previous version of IoT. You can restore to IoT 9.1 or later. For example, you can restore IoT from 9.1.1 to 9.1. However, you cannot restore IoT from 9.1 to 9.0.

Procedure

  1. Log in to Red Hat OpenShift Container Platform.
  2. From the side navigation menu, click Administration > CustomResourceDefinitions.
  3. On the CustomResourceDefinitions page, click the application that you want to restore.
    • Suite
    • ManageApp
    • AssistApp
    • IoT
    • AssetData Dictionary
  4. On the Instances tab, select an instance name.
  5. On the YAML tab, in the spec section, add the version property with the version that you want to restore.

    For example, the version property in the spec section of the following YAML file is 9.0.0, which indicates the version that the application is to revert to.

    -----
apiVersion: apps.mas.ibm.com/v1
kind: ManageApp
metadata:
    name: rollback
namespace: mas-rollback-assist
spec:
  bindings:
    objectstorage: system
  components: {}
  settings:
    deployment: {}
  version: 9.0.0
status:
    versions: 
       generation: '1'
       reconciled: 9.0.0
       controller: 9.0.1
       supported: 
          - 9.0.1
          - 9.0.0
-----
  6. Save your changes.

Results

The application uses the specified version. In the YAML file, the reconciled attribute in the status section is updated to the specific version.

Example

For example, in the following file, the controller property is set to version 9.0.1, which is the current version of the application. When you first deploy or upgrade the application, the reconciled property is also set to version 9.0.1.

If you update the version property in the spec section to revert to 9.0.0, then the reconciled version changes to 9.0.0, and the controller version remains 9.0.1. The application uses version 9.0.0.
-----
apiVersion: apps.mas.ibm.com/v1
kind: ManageApp
metadata:
    name: rollback
namespace: mas-rollback-assist
spec:
  bindings:
    objectstorage: system
  components: {}
  settings:
deployment: {}
  version: 9.0.0
status:
    versions: 
       generation: '1'
       reconciled: 9.0.0
       controller: 9.0.1
       supported: 
          - 9.0.1
          - 9.0.0
-----
The status.versions section specifies the versions that the application can be restored to.

The versions, which are supported by the controller manager, are listed in the status.versions.supported section.