From 24.0.0-IF001 You
can upgrade multiple Cloud Pak for Business Automation instances in
All Namespaces
from 23.0.2-IF006 to 24.0.0.
Before you begin
- The steps in the Procedure section are applicable to your Cloud Pak for Business Automation deployment if:
- You configured your Cloud Pak for Business Automation in 23.0.2-IF006 in
All Namespaces
.
- Your Cloud Pak for Business Automation
and Cloud Pak foundational services are installed in
openshift-operators namespace
.
- You have multiple instances of Cloud Pak for Business Automation installed.
Note: You must upgrade all instances of Cloud Pak for Business Automation one by
one.
- Download
cert-kubernetes
to a Linux®
based machine (RHEL or macOS) to update the catalog sources for the new release. All the
installation and upgrade artifacts are contained in the cert-kubernetes
repository.
It is recommended to use the latest interim fix of the release, but if you do need a previous
version then you can find them all in the Cloud Pak for Business Automation download document.
Tip: Use the move right arrow

in the
24.0.0 release to find all
the available interim fixes.
To download the cert-kubernetes
repository.
- Open the Cloud Pak for Business Automation
download
document, find the card for the latest 24.0.0 interim fix, click
Cert Kubernetes, and then select and copy the displayed command.
- Run the copied
git clone
command to download the files.
- If your Cloud Pak for Business Automation includes Business Automation Insights,
make sure that you evaluated your migration and chosen a strategy before you start your migration.
For more information, see Premigrating Business Automation Insights data to OpenSearch.
About this task
You can upgrade all the Cloud Pak for Business Automation 23.0.2-IF006
deployments that you created from the operators in All Namespaces
to Cloud Pak for Business Automation
24.0.0-IF001.
The procedure assumes that you have two Cloud Pak for Business Automation instances and you
want to upgrade to 24.0.0. You can follow the
same steps for more than two Cloud Pak for Business Automation instances.
When you run the script, the script output displays some details. Steps that are tagged as:
- [INFO]: Provides details of the actions that the script takes.
- [ATTENTION]: Provides important details that you need to know or do during the
upgrade.
- [NEXT ACTION]: Provides the commands or script that you need to run to proceed
with upgrade.
Procedure
-
Log in to the target cluster from a client.
oc login https://<CLUSTERIP>:<port> -u <ADMINISTRATOR>
- Open multiple CLI windows and keep them open side by side. Each CLI window is used to
upgrade one Cloud Pak for Business Automation instance.
- Change the directory to the scripts folder
under cert-kubernetes/scripts.
-
In the first CLI window, run the
cp4a-deployment.sh
script
from cert-kubernetes in the upgradeOperator
mode.
./cp4a-deployment.sh -m upgradeOperator -n <first_project_name>
Where <first_project_name> is the namespace of the first Cloud Pak for Business Automation instance you want
to upgrade.
- If the script detects Elasticsearch and IBM Business Automation Insights, the script then asks
if you completed the migration from Elasticsearch to OpenSearch. Select
No if you did not complete the migration and then go to Installing OpenSearch and migrating Elasticsearch data. Select Yes if you
completed migration from Elasticsearch to OpenSearch.
Remember: Business Automation Insights uses
Elasticsearch, and so does
Process Federation Server. If you have either of
these components in the cluster and you want to upgrade them, then you must migrate from Elasticsearch to OpenSearch.
Note: If your
Cloud Pak for Business Automation includes
IBM Business Automation Workflow without Business Automation Insights, you do not need to
migrate Elasticsearch to
OpenSearch because
IBM Process Federation Server is removed in the
upgrade. If you want to continue to use IBM Process Federation Server after the upgrade, then
you do need to migrate your Elasticsearch data.
- If the script detects Elasticsearch and no Business Automation Insights component, then the
script asks if you are planning to use IBM Process Federation Server after the upgrade and if
you want to perform the migration of Elasticsearch to OpenSearch?
(
Yes/No
).
- If you select
Yes
, the script asks if you completed the migration from Elasticsearch to OpenSearch. Select
No
if you did not complete the migration and then go to Installing OpenSearch and migrating Elasticsearch data. Select Yes if you
completed migration from Elasticsearch to OpenSearch.
- If you select
No
, continue to upgrade the CP4BA operators without migrating
Elasticsearch.
- In the second CLI window, do the following steps.
- If Business Automation Insights is
installed.
Run the following
command.
./cp4a-deployment.sh -m upgradeOperator -n <second_project_name>
Where
<second_project_name> is the namespace of the second Cloud Pak for Business Automation instance you want
to upgrade.
If the script detects Elasticsearch and IBM Business Automation Insights, the script then asks
if you completed the migration from Elasticsearch to OpenSearch. Select
No if you did not complete the migration and then go to Installing OpenSearch and migrating Elasticsearch data. Select Yes if you
completed migration from Elasticsearch to OpenSearch
- If Business Automation Insights is
not installed.
Run the following
command.
./cp4a-deployment.sh -m upgradeOperator -n <second_project_name> --cpfs-upgrade-mode <mode> --original-cp4ba-csv-ver 23.2.6
Where
- <second_project_name> is the namespace of the second Cloud Pak for Business Automation instance you want
to upgrade..
- <mode> must be
shared2shared
.
shared2shared
is the only supported path of upgrade when you upgrade from an
All Namespaces
deployment.
Run the following command to verify the original version of the
Cloud Pak for Business Automation
CSV.
oc get csv -n <second_project_name> |grep ibm-cp4a-operator | awk {'print $1'} | xargs oc get csv -ojsonpath='{.spec.replaces}
Note: The script output displays the following command that you need to run as the next action. Do
not run the command now. You need to run this command
later.
./cp4a-deployment.sh -m upgradeDeployment -n <second_project_name>
- In the first CLI window, run the following command if you have Business Automation Insights and you completed the
migration of Elasticsearch to
OpenSearch. Otherwise, you
can skip this step.
./cp4a-deployment.sh -m upgradeOperator -n <first_project_name>
Where <first_project_name> is the namespace of the first Cloud Pak for Business Automation instance you want
to upgrade.
Note: The script output displays the following command that you need to run as the next action. Do
not run the command now. You need to run this command later.
./cp4a-deployment.sh -m upgradeDeployment -n <first_project_name>
- In the second CLI window, run the following command if you have Business Automation Insights and you completed the
migration of Elasticsearch to
OpenSearch. Otherwise, you
can skip this step.
./cp4a-deployment.sh -m upgradeOperator -n <second_project_name> --cpfs-upgrade-mode shared2shared --original-cp4ba-csv-ver 23.2.6
Where <second_project_name> is the namespace of the second Cloud Pak for Business Automation instance you want
to upgrade.
Run the following command to verify the original version of the
Cloud Pak for Business Automation
CSV.
oc get csv -n <second_project_name> |grep ibm-cp4a-operator | awk {'print $1'} | xargs oc get csv -ojsonpath='{.spec.replaces}
Where
<second_project_name> is the namespace of the second
Cloud Pak for Business Automation instance you want
to upgrade.
Note: The script output displays the following command that you need to run as the next
action. Do not run the command now. You need to run this command
later.
./cp4a-deployment.sh -m upgradeDeployment -n <second_project_name>
What to do next
Go to and complete the steps in Upgrading your CP4BA deployment version from 23.0.2 for each
of your Cloud Pak for Business Automation
instances. Perform the steps on each of the CLI windows.