Upgrading to Fix Pack 5 - scenario 1

If your Red Hat OpenShift Container Platform version is 4.8, IBM Cloud Pak foundational services (previously called Common services) version is 3.14.x, Red Hat® Advanced Cluster Management for Kubernetes version is 2.3, and IBM Cloud Pak® for Multicloud Management version is 2.3 Fixpack 1, 2, 3 or 4, you are recommended to upgrade all the services to the later available versions as follows. For upgrading steps, see Upgrading to Fix Pack 5 - scenario 1.

Red Hat OpenShift Container Platform 4.8 -> 4.10
IBM Cloud Pak foundational services 3.14.x -> 3.19
Red Hat® Advanced Cluster Management 2.3 -> 2.4
IBM Cloud Pak for Multicloud Management 2.3 Fix Pack 1, 2, 3 or 4 -> 2.3 Fix Pack 5

In this upgrading scenario, all the services are upgraded to the later versions.

Note: You are recommended to upgrade IBM Cloud Pak® for Multicloud Management first, then upgrade IBM Cloud Pak foundational services, then upgrade Red Hat® Advanced Cluster Management for Kubernetes, and finally upgrade Red Hat OpenShift Container Platform.

Online upgrading

For online installations, follow the steps:

Upgrade your IBM Cloud Pak® for Multicloud Management to Fix Pack 5. Ensure that the CatalogSource for IBM Cloud Pak® for Multicloud Management has the following image value:
- For Fix Pack 5:
```
quay.io/cp4mcm/cp4mcm-orchestrator-catalog:2.3.27
```
  Then, IBM Cloud Pak® for Multicloud Management can be upgraded to later 2.3 Fix Pack 5 automatically.
Upgrade IBM Cloud Pak foundational services to version 3.19:

Note: You need to upgrade IBM Cloud Pak foundational services to version 3.19 before you upgrade Red Hat® Advanced Cluster Management for Kubernetes to 2.4.
1. Edit the CatalogSource for IBM Cloud Pak foundational services by running the following command:
```
oc -n openshift-marketplace edit catalogsource opencloud-operators
```
  In the result screen, modify the value of the image field to the following value:
```
  image: quay.io/opencloudio/ibm-common-service-catalog:3.19
```
  Check whether quay.io/opencloudio/* is in the clusterimagepolicy repository by running the following command:
```
oc get clusterimagepolicy ibmcloud-default-cluster-image-policy -o yaml -n management-security-services
```
  Note: The clusterimagepolicy exists only after you enabled securityServices and ibm-management-image-security-enforcement in the previous installation or upgrading process.
  
  If not, you need to add quay.io/opencloudio/* to the clusterimagepolicy repository.
2. Edit the Subscription for IBM Cloud Pak foundational services by running the following command:
```
oc edit -n openshift-operators sub ibm-common-service-operator
```
  In the result screen, modify the value of the channel field to the following value:
```
channel: v3
```
3. Wait for about ten minutes to allow the IBM Cloud Pak foundational services operators to complete the upgrading process. Check whether all IBM Cloud Pak foundational services pods are in running status by running the following command:
```
oc get pods -n ibm-common-services
```
To upgrade Red Hat® Advanced Cluster Management for Kubernetes to version 2.4, edit the Subscription for Red Hat® Advanced Cluster Management for Kubernetes by running the following command:
```
oc edit -n open-cluster-management sub acm-operator-subscription
```
In the result screen, modify the value of the channel field to the following value:
```
channel: release-2.4
```
Note: After Red Hat® Advanced Cluster Management for Kubernetes is upgraded, the ibm-cert-manager-operator needs to be restarted.
Upgrade your Red Hat OpenShift Container Platform to version 4.10:
1. Upgrade your Red Hat OpenShift Container Platform from version 4.8 to version 4.9. See the Red Hat documentation.
2. Upgrade your Red Hat OpenShift Container Platform from version 4.9 to version 4.10. See the Red Hat docuemntation.

Offline upgrading

For offline (airgap) installations, follow the steps:

Upgrade IBM Cloud Pak® for Multicloud Management in an airgap environment to Fix Pack 5. For more information, see Offline (airgap) upgrade.

Note: You need to download the ibm-cp-management-100.3.28+2.3.27.tgz archive file for Fix Pack 5.
Upgrade IBM Cloud Pak foundational services in an airgap environment to version 3.19. Follow the steps:

Note: You need to upgrade IBM Cloud Pak foundational services to version 3.19 before you upgrade Red Hat® Advanced Cluster Management for Kubernetes to 2.4.
1. Log in to your OpenShift Container Platform console.
2. Delete the IBM Cloud Pak foundational services catalog source by running the following command:
```
oc delete catalogsource opencloud-operators -n openshift-marketplace
```
3. Create the catalog source.
```
cloudctl case launch \
--case $OFFLINE_DIR/${CASE_ARCHIVE} \
--inventory ${CASE_INVENTORY_SETUP} \
--action install-catalog \
--namespace ${NAMESPACE} \
--args "--registry ${LOCAL_DOCKER_REGISTRY} --inputDir $OFFLINE_DIR --recursive" \
--tolerance 1
```
  Note: The variable $OFFLINE_DIR is set in Preparing for installation by using a bastion host, and is the directory that serves as the offline store to store this current release installer and image inventory.
Upgrade Red Hat® Advanced Cluster Management for Kubernetes to 2.4.

Note: After Red Hat® Advanced Cluster Management for Kubernetes is upgraded, the ibm-cert-manager-operator needs to be restarted.
Upgrade your Red Hat OpenShift Container Platform to version 4.10:
1. Upgrade your Red Hat OpenShift Container Platform from version 4.8 to version 4.9. See the Red Hat documentation.
2. Upgrade your Red Hat OpenShift Container Platform from version 4.9 to version 4.10. See the Red Hat docuemntation.