Maximo Application Suite Customer-managed

Rolling back Maximo Collaborate

Starting in Maximo® Application Suite 9.0, after you upgrade to a later version of Maximo Collaborate, you can roll back to a previous version by updating the version properties.

Note: Starting in Maximo Application Suite 9.1, IBM® Maximo Assist is now named IBM Maximo Collaborate.

About this task

To roll back Maximo Assist, set the primary version properties for the entity manager in the Maximo Assist custom resource definition.

You can roll back to Maximo Assist 9.0 or later. For example, you can roll back Maximo Assist from 9.0.1 to 9.0.0. However, you cannot roll back Maximo Assist from 9.0.0 to 8.11.x.

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 AssistApp.
  4. On the Instances tab, select an instance name.
  5. On the YAML tab, in the spec section, add or update the version property with the version to roll the application back to.

    For example, the version property in the spec section of the following YAML file is 9.0.0, which indicates the version that Assist is to roll back 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

Maximo Collaborate 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 version 9.0.1 is the current version of Maximo Assist. When you first deploy or upgrade Maximo Assist, the reconciled version is also 9.0.1. If you update the version property in the spec section to roll back to 9.0.0, then the reconciled version changes to 9.0.0, and the controller version remains 9.0.1. Maximo Assist 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 Collaborate can be rolled back to.

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