Maximo Application Suite
Customer-managed

Setting version lock in Maximo Application Suite

Starting in Maximo® Application Suite 8.11, if IBM® Maximo Application Suite is updated or upgraded, as a Suite administrator, you can roll back Maximo Application Suite to a previous version. You can lock Maximo Application Suite to use that specific version by updating the version properties.

About this task

If Maximo Application Suite is updated or upgraded, the administrator can roll back to a specific version by updating the controller manager version properties in the Suite custom resource definition.

The locked version is displayed in the Maximo Application Suite header. To view details, such as the controller manager version and compatible application versions, click the version lock message.

Note: You can roll back to an earlier version of Maximo Application Suite only in 8.11 and later. For example, you can roll back Maximo Application Suite from 8.11.1 or 8.11.2 to 8.11.0. However, you cannot roll back Maximo Application Suite from 8.11.x to 8.10.x.

In Red Hat® OpenShift® Container Platform, update the version properties for the controller manager in the Suite custom resource definition (CRD) for your project.

Procedure

Log in to Red Hat OpenShift Container Platform.
From the side navigation menu, click Administration > CustomResourceDefinitions.
On the custom resource definitions page, click Suite.
On the Instances tab, click an instance name.
The instance page is displayed.
On the YAML tab, add or update the version property in the spec section.
For example, add the version property in the yaml file.
```
-----
apiVersion: core.mas.ibm.com/v1
kind: Suite
metadata:
  name: prod
  namespace: mas-prod-core
spec:
  version: 8.11.0
-----
    
```
Where, version specifies the version that Maximo Application Suite can be rolled back to.

Note: The versions supported by the controller manager are listed in the Maximo Application Suite status.
Click Save.

Results

Maximo Application Suite is locked to use the specified version. In the yaml file, the reconciled attribute in status section is updated to the locked version.

For example, in the following configuration, the Maximo Application Suite is running the 8.11.1 controller manager. However, the Suite administrator has rolled the version of the core platform back to 8.11.0 by using version lock.

-----
apiVersion: core.mas.ibm.com/v1
kind: Suite
metadata:
  name: prod
  namespace: mas-prod-core
status:
  versions:
    generation: '1'
    reconciled: 8.11.0
    controller: 8.11.1
    supported:
      - 8.11.2
      - 8.11.1
      - 8.11.0
-----

You can also verify the locked version in the Maximo Application Suite status bar.

Attention: If you remove the version field in the spec, the version lock is removed and Maximo Application Suite reverts back to the current version of the controller manager.