Upgrading the IBM Cloud Pak foundational services (Upgrading from Version 4.5 to Version 4.7)

Before you can upgrade IBM Cloud Pak for Data, you must upgrade the IBM Cloud Pak foundational services that Cloud Pak for Data requires. Each instance of Cloud Pak for Data has its own instance of the IBM Cloud Pak foundational services.

Upgrade phase
You are not here. Updating your client workstation
You are not here. Updating your cluster
You are not here. Collecting required information
You are not here. Preparing to run an upgrade from a private container registry
You are not here. Migrating to the private topology
You are not here. Preparing to upgrade an instance of Cloud Pak for Data
You are here icon. Upgrading an instance of Cloud Pak for Data
Who needs to complete this task?

Instance administrator An instance administrator can complete this task.

When do you need to complete this task?

Repeat as needed If you have multiple instances of Cloud Pak for Data on the cluster, this task for each instance that you plan to upgrade to Version 4.7.

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

You must run the setup-instance-topology command to:

  • Upgrade the required IBM Cloud Pak foundational services software in the operators project.
  • Create the ConfigMap for the NamespaceScope operator.

    The ConfigMap identifies which project or projects the operators should watch.

Procedure

  1. Run the cpd-cli manage login-to-ocp command to log in to the cluster as a user with sufficient permissions to complete this task. For example:
    cpd-cli manage login-to-ocp \
    --username=${OCP_USERNAME} \
    --password=${OCP_PASSWORD} \
    --server=${OCP_URL}
    Tip: The login-to-ocp command takes the same input as the oc login command. Run oc login --help for details.
  2. Run the cpd-cli manage setup-instance-topology command to upgrade IBM Cloud Pak foundational services and create the required ConfigMap.
    Tip: Before you run this command against your cluster, you can preview the oc commands that this command will issue on your behalf by running the command with the --preview=true option.

    The oc commands are saved to the preview.sh file in the work directory.


    Instances without tethered projects
    cpd-cli manage setup-instance-topology \
    --release=${VERSION} \
    --cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --license_acceptance=true
    Important: If the command fails with the error No storage class defined for CommonService CR. Please specify --block_storage_class=<RWO class name>, re-run the command with the --block_storage_class option:
    cpd-cli manage setup-instance-topology \
    --release=${VERSION} \
    --cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --block_storage_class=${STG_CLASS_BLOCK} \
    --license_acceptance=true

    Instances with tethered projects
    cpd-cli manage setup-instance-topology \
    --release=${VERSION} \
    --cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --additional_ns=${PROJECT_CPD_INSTANCE_TETHERED_LIST} \
    --license_acceptance=true
    Important: If the command fails with the error No storage class defined for CommonService CR. Please specify --block_storage_class=<RWO class name>, re-run the command with the --block_storage_class option:
    cpd-cli manage setup-instance-topology \
    --release=${VERSION} \
    --cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --additional_ns=${PROJECT_CPD_INSTANCE_TETHERED_LIST} \
    --block_storage_class=${STG_CLASS_BLOCK} \
    --license_acceptance=true

What to do next

Now that you've upgraded IBM Cloud Pak foundational services, you're ready to complete Checking for expired SSL certificates (Upgrading from Version 4.5 to Version 4.7).