Determining which components to upgrade (Upgrading from Version 4.8 to Version 5.1)

To successfully upgrade from IBM Cloud Pak® for Data Version 4.8 to IBM® Software Hub Version 5.1, you must determine which components are installed for the instance that you want to upgrade.

Upgrade phase
  • You are not here. Updating your cluster
  • You are not here. Updating your client workstation
  • You are here icon. Collecting required information
  • You are not here. Preparing to run an upgrade in a restricted network
  • You are not here. Preparing to run an upgrade from a private container registry
  • You are not here. Installing and upgrading prerequisite software
  • You are not here. Updating the shared cluster components
  • You are not here. Preparing to upgrade an instance
  • You are not here. Upgrading an instance
Who needs to complete this task?
Operations team The IBM Software Hub operations team must determine:
  • Which components are installed on the cluster
  • Which components are associated with the instance of IBM Cloud Pak for Data that you want to upgrade to IBM Software Hub Version 5.1.
When do you need to complete this task?

Repeat as needed Repeat this task for each instance of IBM Cloud Pak for Data on your cluster that you want to upgrade to IBM Software Hub Version 5.1.

Ensure that you complete this task before you:
  • Mirror images to your private container registry
  • Prepare to upgrade an instance of IBM Cloud Pak for Data to IBM Software Hub Version 5.1

Before you begin

Best practice: You can run the commands in this task exactly as written if you set up environment variables. For instructions, see Setting up installation environment variables.

Ensure that you source the environment variables before you run the commands in this task.

Before you determine which components you need to upgrade, review the following guidance:

Environments with multiple instances of IBM Cloud Pak for Data
You can upgrade each instance of IBM Cloud Pak for Data on the cluster independently. You can optionally leave different instances at different versions. For example, you can have one instance of IBM Cloud Pak for Data at Version 4.8 and upgrade one instance to IBM Software Hub Version 5.1.3.
Version support
Important: All of the components that are associated with an instance of IBM Software Hub must be installed at the same version. You cannot install services from different releases of IBM Software Hub in the same instance.
Options for upgrading services

You have two options for upgrading the services:

Option Benefits Drawbacks
Upgrade each service individually. If you feel more comfortable running upgrades one at a time, this option gives you more granular control over the upgrade process.

Keep in mind that all of the operators are upgraded at the same time. You cannot upgrade the operators individually.
  • You must complete more steps to successfully upgrade the software on your environment.
  • The order in which you upgrade services is important.
Upgrade all of the services at the same time.
  • You can complete the upgrade in fewer steps.
  • The cpd-cli is designed to upgrade the services in the correct order, which reduces the likelihood of errors.

If you encounter an issue when upgrading a service, you can follow the instructions to upgrade the service separately.

Procedure

To determine which components to upgrade:

  1. 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.
  2. Determine whether the scheduling service is installed: 
    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.
  3. Determine which services are installed in the instance that you want to upgrade: 
    cpd-cli manage list-deployed-components \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS}

    The command returns a list of the services that are installed in the project.

    Important: If the command returns the ws component, ensure that you add the ws_runtimes component to the your COMPONENTS environment variable when you update your environment variables script.

What to do next

Now that you've identified which components to upgrade, you're ready to complete Updating your environment variables script (Upgrading from Version 4.8 to Version 5.1).