Upgrading dependencies

Upgrading Cloud Pak foundational services

Starting from version 23.0.17, IBM RPA now supports Cloud Pak foundational services version 4. With this change, you must also upgrade your Cloud Pak foundational services operator.

Follow the steps to upgrade your Cloud Pak foundational services if you are upgrading from a version before 23.0.17:

1. Log in to your cluster web console.
2. Uninstall the IBM RPA operator.
   1. Navigate to Operators > Installed Operators.
   2. Scroll or enter a keyword into the Filter by name field to find the Operator that you want to remove and select it.
   3. On the right side of the Operator Details page, select Uninstall Operator from the Actions list.
   4. Select Uninstall to remove the Operator, Operator deployments, and pods.
3. Delete the namespace that you installed the IBM RPA operator.
   1. Navigate to Home > Projects.
   2. Scroll or enter the name of the IBM RPA namespace into the Filter by name field to find the Project.
   3. On the project, click the vertical ellipsis button > Delete Project.
   4. Click Delete. This removes all the operators, pods, and secrets deployed in the IBM RPA namespace.
4. Recreate the namespace after it was completely removed.
5. Install the cert-manager operator for Red Hat OpenShift.
6. Install the IBM Licensing operator.
7. Install the IBM Cloud Pak foundational services operator.
8. Proceed to install the IBM RPA operator normally. For more information, see Installing the IBM RPA operator in an online environment.
9. Deploy the IBM RPA operator.

Upgrading the IBM MQ operator

Complete the following steps only if you depend on an IBM MQ operator that does is not installed automatically by the IBM RPA operator:

1. From the Red Hat® OpenShift® Container Platform console switch to the namespace where the operator is installed.
2. Click Installed Operators, and select IBM MQ.
3. Under the Subscription tab, set the channel to a new version and save the change. For more information about IBM MQ operator versioning reference, see the Table 2 in Versioning reference.

Extra steps for operand version 1.13.0

Upgrading the IBM RPA operand version to 1.13.0 upgrades the IBM MQ version to 9.3.2.0-r1, which requires that you complete the following steps:

1. Set the operand version to 1.13.0 in the IBM RPA custom resource. For more information, see the step 5 in Preparing and applying upgraded custom resource.
2. Change the IBM MQ operator channel to v2.3.

Uninstalling the deprecated Redis operator

Starting from version 23.0.12, IBM RPA on Red Hat® OpenShift® Container Platform uses a new Redis operator version. After you upgrade to version 23.0.12 or higher, the IBM RPA operator automatically installs the new Redis operator, but it does not uninstall the old Redis operator. You can uninstall it manually, as long as you don't have any other products installed in the same namespace that also use this Redis operator.

To uninstall it, run the following commands from the command line:

1. List the Subscriptions in the namespace:

   oc get subscriptions
   

2. Identify the line where the PACKAGE column contains ibm-cloud-databases-redis-operator.

3. Delete the Subscription, using the name from the previously identified line, for example:

   oc delete sub ibm-cloud-databases-redis-operator-v1.6-ibm-operator-catalog-openshift-marketplace
   

4. List the CSVs in the namespace:

   oc get csv
   

5. Identify the line where the Display column contains the IBM Operator for Redis.

6. Delete the CSV using the value from the Name column:

   oc delete csv ibm-cloud-databases-redis.v1.6.8