Upgrading shared cluster components (Upgrading from Version 4.7 to Version 4.8)

Important: IBM Cloud Pak® for Data Version 4.8 will reach end of support (EOS) on 31 July, 2025. For more information, see the Discontinuance of service announcement for IBM Cloud Pak for Data Version 4.X.

Upgrade to IBM Software Hub Version 5.1 before IBM Cloud Pak for Data Version 4.8 reaches end of support. For more information, see Upgrading from IBM Cloud Pak for Data Version 4.8 to IBM Software Hub Version 5.1.

Before you upgrade IBM Cloud Pak for Data, you must upgrade the Certificate manager, License Service, and scheduling service.

Upgrade phase

Updating your cluster

Updating your client workstation

Collecting required information

Preparing to run an upgrade in a restricted network

Preparing to run an upgrade from a private container registry

Installing prerequisite software

Updating the shared cluster components

Preparing to upgrade an instance of Cloud Pak for Data

Upgrading an instance of Cloud Pak for Data

Who needs to complete this task?

Cluster administrator A cluster administrator must complete this task.

Remember: If you gave another user the minimum role-based access control (RBAC) to install the scheduling service and you want that user to upgrade the scheduling service, you must complete Giving a user the minimum RBAC to install the scheduling service before you complete this task.

When do you need to complete this task?

One-time setup You must complete this task before you upgrade IBM Cloud Pak for Data.

If you have multiple instances of Cloud Pak for Data on the cluster, it is strongly recommended that you upgrade the shared components to the same release as the latest version of Cloud Pak for Data that you plan to install on the cluster.

For example, if you have two instances of Cloud Pak for Data at Version 4.8.8 and you plan to upgrade one of the instances to Version 4.8.9, upgrade the shared cluster components to Version 4.8.9.

Before you begin

Best practice: You can run the commands in this task exactly as written using the installation environment variables. Ensure that you added the new environment variables from Updating your environment variables script.

In addition, ensure that you source the environment variables before you run the commands in this task.

About this task

Certificate manager

If you are using the Red Hat® OpenShift® cert-manager or a community certificate manager, the IBM Cloud Pak foundational services Certificate manager upgrade will be skipped.

License Service

The location of the License Service depends on whether you installed Cloud Pak for Data with the private topology or whether you migrated to the private topology.

If you installed with the private topology, the License Service is in the project defined by the ${PROJECT_LICENSE_SERVICE} environment variable.
If you migrated to the private topology, the License Service is in the project defined by the ${PROJECT_CS_CONTROL} environment variable.

If you're not sure which project the License Service is in, run the following command:

oc get deployment -A |  grep ibm-licensing-operator

Compare the project that is returned by the command to the projects that are in your installation environment variables script.

Scheduling service

If you're not sure whether the scheduling service is installed on the cluster, run the following command:

oc get scheduling -A

If the scheduling service is installed, the command returns information about the project where the scheduling service is installed and the version that is installed.
Ensure that the COMPONENTS variable in your environment variables script includes the scheduler component.
If the scheduling service is not installed, the command returns an empty response.

Procedure

Log the cpd-cli in to the Red Hat OpenShift Container Platform cluster:
```
${CPDM_OC_LOGIN}
```
Remember: CPDM_OC_LOGIN is an alias for the cpd-cli manage login-to-ocp command.

Upgrade the Certificate manager and License Service.

The command that you run depends on where the License Service is installed:

The License Service is in the ${PROJECT_LICENSE_SERVICE} project

cpd-cli manage apply-cluster-components \
--release=${VERSION} \
--license_acceptance=true \
--cert_manager_ns=${PROJECT_CERT_MANAGER} \
--licensing_ns=${PROJECT_LICENSE_SERVICE}

The License Service is in the ${PROJECT_CS_CONTROL} project

cpd-cli manage apply-cluster-components \
--release=${VERSION} \
--license_acceptance=true \
--cert_manager_ns=${PROJECT_CERT_MANAGER} \
--licensing_ns=${PROJECT_CS_CONTROL}

Wait for the cpd-cli to return the following message before proceeding to the next step:

[SUCCESS] ... The apply-cluster-components command ran successfully.

Confirm that the Certificate manager pods in the ${PROJECT_CERT_MANAGER} project are Running or Completed:
```
oc get pods --namespace=${PROJECT_CERT_MANAGER}
```
Confirm that the License Service pods are Running or Completed:
The License Service is in the ${PROJECT_LICENSE_SERVICE} project
```
 oc get pods --namespace=${PROJECT_LICENSE_SERVICE}
```
The License Service is in the ${PROJECT_CS_CONTROL} project
```
 oc get pods --namespace=${PROJECT_CS_CONTROL}
```

Upgrade the scheduling service:

cpd-cli manage apply-scheduler \
--release=${VERSION} \
--license_acceptance=true \
--scheduler_ns=${PROJECT_SCHEDULING_SERVICE}

Confirm that the scheduling service pods are Running or Completed:
```
oc get pods --namespace=${PROJECT_SCHEDULING_SERVICE}
```

What to do next

Minimum RBAC The following guidance applies only to environments that use the minimum role-based access control configuration.
If Cloud Pak for Data will be upgraded by an instance administrator, complete Giving a user the minimum RBAC to install Cloud Pak for Data components.
Now that you've upgraded the shared cluster components, you're ready to complete Preparing to upgrade an instance of IBM Cloud Pak for Data (Upgrading from Version 4.7 to Version 4.8).