Upgrading

You can upgrade your Cloud Pak for Business Automation (CP4BA) production deployment to 24.0.0. You might not be able to upgrade installations of continuous delivery (CD) releases directly, but you can upgrade to a version that does support a direct upgrade. If you do not want to upgrade twice, you can migrate to a new operator instance that points to your existing persistent stores.

Supported upgrading paths

Restriction: An upgrade of CP4BA starter deployments is not supported.
Important: Upgrading a cluster-scoped Cloud Pak foundational services instance in specific namespaces like ibm-common-services to a cluster-scoped instance of Cloud Pak foundational services in specific namespaces like ibm-common-services is not supported.

The following table shows how you can upgrade your installed CP4BA multi-pattern production deployments to the current version.

Table 1. Upgrading paths to 24.0.0
Installed version How to upgrade to 24.0.0 Notes
24.0.0 or 24.0.0-IF00x An upgrade to a higher interim fix 24.0.0-IF00x is supported. It is recommended to upgrade to the latest interim fix of the release. For more information and access to all the interim fix readme files, see the Cloud Pak for Business Automation download document. You can always upgrade to the latest interim fix version 24.0.0-IF00x.
Tip: If you want an interim fix that is not the latest, use the move right arrow Move right arrow in the 24.0.0 release to find all the available interim fixes.
23.0.2-IF006 A direct upgrade to any of the 24.0.0 interim fixes is supported. You can directly upgrade to the latest interim fix of 24.0.0 if your current Cloud Pak for Business Automation deployment version is 23.0.2-IF006. If you are on an earlier version, you need to upgrade to 23.0.2-IF006. For more information, see Upgrading CP4BA multi-pattern clusters from 23.0.2.
23.0.1 A direct upgrade to 24.0.0 is not supported. Incrementally upgrade to 23.0.2-IF006, and then upgrade to 24.0.0.

23.0.1 → 23.0.2-IF006 → 24.0.0

For more information, see Upgrading CP4BA multi-pattern clusters from 23.0.1.
22.0.2-IF006 A direct upgrade to 24.0.0-IF004 or later is supported.
Note: If you want to upgrade to 24.0.0- IF002 or 24.0.0-IF003, then first upgrade your Cloud Pak for Business Automation deployment version to 24.0.0-IF001 and then upgrade to 24.0.0-IF002 or 24.0.0-IF003. For more information, see Cloud Pak for Business Automation download document.
You can directly upgrade to 24.0.0-IF004 or later if your current Cloud Pak for Business Automation deployment version is 22.0.2-IF006. If you are on an earlier version, you need to upgrade to 22.0.2-IF006. For more information, see Upgrading CP4BA multi-pattern clusters from 21.0.3 or 22.0.2.
22.0.1 A direct upgrade to 24.0.0 is not supported. If you have a namespace-scoped instance of Cloud Pak foundational services, you can incrementally upgrade to 22.0.2-IF006, and then upgrade to 24.0.0-IF001.

22.0.1 → 22.0.2-IF006 → 24.0.0-IF001

For more information, see Upgrading CP4BA multi-pattern clusters from 22.0.1.
21.0.3-IF031 or later A direct upgrade to 24.0.0-IF004 or later is supported.
Note: If you want to upgrade to 24.0.0- IF002 or 24.0.0-IF003, then you must first upgrade your Cloud Pak for Business Automation deployment version to 24.0.0-IF001 and then upgrade to 24.0.0-IF002 or 24.0.0-IF003. For more information, see Cloud Pak for Business Automation download document.
You can directly upgrade to 24.0.0-IF004 or later if your current Cloud Pak for Business Automation deployment version is 21.0.3-IF031 or later. If you are on an earlier version, you need to upgrade to 21.0.3-IF031 or later. For more information, see Upgrading CP4BA multi-pattern clusters from 21.0.3 or 22.0.2.
Important: There is a known issue when you upgrade directly from 21.0.3-IF035, 21.0.3-IF036, 21.0.3-IF037, 21.0.3-IF038 or 21.0.3-IF039 to 24.0.0-IF004 or later if your Cloud Pak for Business Automation deployment includes any of the following capabilities:
  • Automation Decision Services
  • Automation Document Processing Development
  • Automation Workstream Services
  • Business Automation Workflow Runtime
  • Business Automation Workflow Authoring
You can directly upgrade from 21.0.3-IF031, 21.0.3-IF032, 21.0.3-IF033, or 21.0.3-IF034 to 24.0.0-IF004 or later. For more information, see technote.
Releases before 21.0.3 A direct upgrade to 24.0.0 is not supported. Upgrade to 21.0.3-IF031 or later, and then upgrade to 24.0.0.

Releases before 21.0.3 → 21.0.3-IF031 or later → 24.0.0

You can directly upgrade to 24.0.0 or 24.0.0-IF001 if your current Cloud Pak for Business Automation deployment version is 21.0.3-IF031 or later. If you are on an earlier version, you need to upgrade to 21.0.3-IF031 or later. For more information, see Upgrading CP4BA multi-pattern clusters from 21.0.3 or 22.0.2.