Upgrading IBM Cloud Pak for AIOps on OpenShift

Upgrade an existing online or offline deployment of IBM Cloud Pak® for AIOps 4.7.0 or later to 4.8.1.

You cannot use these instructions to upgrade deployments of IBM Cloud Pak for AIOps 4.6.1 or earlier.

Important: If IBM® Netcool® Operations Insight® is deployed on the same cluster as IBM Cloud Pak for AIOps, ensure that Netcool Operations Insight is at version 1.6.13 or later before you upgrade IBM Cloud Pak for AIOps. Failure to do so may result in a broken Netcool Operations Insight deployment, as the IBM Cloud Pak for AIOps upgrade process updates a shared component that is used by both applications.

Upgrade paths

IBM Cloud Pak for AIOps uses a versioning system of X.Y.Z, where X=version, Y=release, and Z=patch. For example, IBM Cloud Pak for AIOps 4.8.1 is version 4, release 8, patch 1. IBM Cloud Pak for AIOps upgrades can be release upgrades or patch upgrades.

You can upgrade by a maximum of one release at a time. If the release that you want to upgrade from is more than one release behind the release that you are upgrading to, then you must upgrade sequentially. For example, you cannot upgrade directly from IBM Cloud Pak for AIOps 4.4.0 to v4.8.1, you must use the following sequence:

  1. Use the v4.5.1 documentation to upgrade from IBM Cloud Pak for AIOps 4.4.0 to v4.5.1.
  2. Use the v4.6.1 documentation to upgrade from IBM Cloud Pak for AIOps 4.5.1 to v4.6.1.
  3. Use the v4.7.1 documentation to upgrade from IBM Cloud Pak for AIOps 4.6.1 to v4.7.1.
  4. Use this documentation, the v4.8.1 documentation to upgrade from IBM Cloud Pak for AIOps 4.7.1 to v4.8.1.

Controlling upgrade

From IBM Cloud Pak for AIOps 4.7.0 onwards, all upgrades must be initiated manually. Automatic upgrade of IBM Cloud Pak for AIOps does not occur. For more information, see Whats New in the IBM Cloud Pak for AIOps 4.7.0 documentation.

Guidance for upgrades that require an Red Hat OpenShift upgrade

Before you upgrade IBM Cloud Pak for AIOps, ensure that you are on a version of Red Hat® OpenShift® Container Platform that your current and target versions of IBM Cloud Pak for AIOps both support. This helps to ensure compatibility and avoid potential issues caused by platform API changes.

If you already have a version of Red Hat OpenShift that your current and target versions of IBM Cloud Pak for AIOps both support but you want to upgrade Red Hat OpenShift, then complete the IBM Cloud Pak for AIOps upgrade before you upgrade Red Hat OpenShift.

Example upgrade scenario

You have IBM Cloud Pak for AIOps 4.7.0 deployed on Red Hat OpenShift 4.13, and you want to upgrade to IBM Cloud Pak for AIOps 4.8.1 on Red Hat OpenShift 4.17.

The following table shows the supported Red Hat OpenShift versions for your current and target versions of IBM Cloud Pak for AIOps:

Table 1. Supported Red Hat OpenShift versions for current and target application versions
IBM Cloud Pak for AIOps version Supported Red Hat OpenShift versions
4.7.0 4.10, 4.11, 4.12, 4.13, 4.14, 4.15, 4.16
4.8.1 4.14, 4.15, 4.16, 4.17

The upgrade steps for this example upgrade scenario are:

  1. Upgrade Red Hat OpenShift 4.13 to v4.14, v4.15, or v4.16.
  2. Upgrade IBM Cloud Pak for AIOps 4.7.0 to v4.8.1.
  3. Upgrade Red Hat OpenShift to v4.17.

Upgrade procedure

The upgrade procedure depends on whether your deployment is an online or offline (air-gapped) deployment:

For more information about online and offline deployments, see Installing IBM Cloud Pak for AIOps.