Upgrading to Fix Pack 6

For IBM Cloud Pak® for Multicloud Management Fix Pack 6, the following upgrading scenario is supported:

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 or 3.18.x, Red Hat® Advanced Cluster Management for Kubernetes version is 2.4, and IBM Cloud Pak® for Multicloud Management version is 2.4 Fixpack 1, 2, 3, 4 or 5, you are recommended to upgrade all the services to the later available versions as follows.

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

Before you begin

Online upgrading

For online installations, follow the steps:

  1. 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.

  2. Upgrade your IBM Cloud Pak® for Multicloud Management to Fix Pack 6. Ensure that the CatalogSource for IBM Cloud Pak® for Multicloud Management has the following image value:

    • For Fix Pack 6:

      quay.io/cp4mcm/cp4mcm-orchestrator-catalog:2.3.28

      Then, IBM Cloud Pak® for Multicloud Management can be upgraded to later 2.3 Fix Pack 6 automatically.

  3. Upgrade IBM Cloud Pak foundational services to version 3.19.6:

    Note: You need to upgrade IBM Cloud Pak foundational services to version 3.19.6 before you upgrade Red Hat® Advanced Cluster Management for Kubernetes to 2.5.

    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.6

      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

  4. To upgrade Red Hat® Advanced Cluster Management for Kubernetes to version 2.5, 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.5

    Note: After Red Hat® Advanced Cluster Management for Kubernetes is upgraded, the ibm-cert-manager-operator needs to be restarted.

Offline upgrading

For offline (airgap) installations, follow the steps:

  1. 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.

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

    Note: You need to download the ibm-cp-management-100.3.30+2.3.28.tgz archive file for Fix Pack 6.

  3. Upgrade IBM Cloud Pak foundational services in an airgap environment to version 3.19.6. Follow the steps:

    Note: You need to upgrade IBM Cloud Pak foundational services to version 3.19.6 before you upgrade Red Hat® Advanced Cluster Management for Kubernetes to 2.5.

    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.

  4. Upgrade Red Hat® Advanced Cluster Management for Kubernetes to 2.5.

    Note: After Red Hat® Advanced Cluster Management for Kubernetes is upgraded, the ibm-cert-manager-operator needs to be restarted.

What to do next

  1. You need to update the navigation menu by running the following command:

    INDEX=$(kubectl get navconfiguration multicluster-hub-nav -n kube-system -o json  | jq '.spec.navItems | map(.id == "grc") | index(true)')

PATCH="[{\"op\":\"remove\",\"path\":\"/spec/navItems/${INDEX}\"}]"

kubectl patch navconfiguration multicluster-hub-nav -n kube-system --type='json' -p "${PATCH}"

  2. Complete the steps in the Post-upgrade tasks documentation.