Updating the olm-utils image on a single client workstation (Upgrading from Version 4.5 to Version 4.6)

When you installed IBM Cloud Pak® for Data Version 4.5, you set up a client workstation that can connect to the Red Hat® OpenShift® Container Platform cluster. Before you upgrade IBM Cloud Pak for Data, you must download the latest version of the cpd-cli and ensure that the cpd-cli manage plug-in is using the latest image.

Upgrade phase
You are here icon. Setting up a client workstation
You are not here. Collecting required information
You are not here. Preparing your cluster
You are not here. Upgrading the Cloud Pak for Data platform and services
Who needs to complete this task?
User Purpose
Cluster administrators Required to create updated catalog sources and operator subscriptions.
Project administrators Required to upgrade IBM Cloud Pak for Data.
Private container registry administrators Required to mirror images to the private container registry.
When do you need to complete this task?
You must complete this task before you upgrade IBM Cloud Pak for Data.

Before you begin

To complete this task, the client workstation must be connected to the internet.

About this task

The image for the cpd-cli manage plug-in includes software version and dependency information. You must run the cpd-cli manage restart-container command to update the plug-in to get the latest version and dependency information.

Procedure

The steps that you complete depend on whether your cluster is in a restricted network and whether you plan to use the same workstation in the cluster network:

Your cluster is not in a restricted network
  1. Run the following command to update the olm-utils image on the workstation:
    cpd-cli manage restart-container
  2. Confirm that the latest image is available:
    cpd-cli manage versioninfo

    The command should return information with the following format:

    BUILD_ID: X.X.X.X (TIMESTAMP) CLIENT_OS

oc: Client Version: X.X.X
Server Version: X.X.X
Kubernetes Version: vX.X.X

cloudctl: Client Version: vX.X.X

+ /usr/bin/skopeo --version
skopeo: skopeo version X.X.X

registry: registry github.com/docker/distribution vX.X.X
You plan to use the same workstation inside a restricted cluster network

When the workstation is connected to the internet:

  1. Run the following command to update the olm-utils image on the workstation:
    cpd-cli manage restart-container
  2. Confirm that the latest image is available:
    cpd-cli manage versioninfo

    The command should return information with the following format:

    BUILD_ID: X.X.X.X (TIMESTAMP) CLIENT_OS

oc: Client Version: X.X.X
Server Version: X.X.X
Kubernetes Version: vX.X.X

cloudctl: Client Version: vX.X.X

+ /usr/bin/skopeo --version
skopeo: skopeo version X.X.X

registry: registry github.com/docker/distribution vX.X.X

The olm-utils image is available on the workstation. You can move the workstation behind the cluster firewall.

You plan to use a different workstation inside the cluster network
Before you begin

You must have the cpd-cli installed on a workstation in the cluster network

  1. From a workstation that can connect to the internet:
    1. Ensure that Docker or Podman is running on the workstation.
    2. Run the following command to save the olm-utils image to the client workstation:
      x86-64 clusters
      cpd-cli manage save-image \
--from=icr.io/cpopen/cpd/olm-utils:latest

      This command saves the image as a compressed TAR file named icr.io_cpopen_cpd_olm-utils_latest.tar.gz in the cpd-cli-workspace/olm-utils-workspace/work/offline directory.

      s390x clusters
      cpd-cli manage save-image \
--from=icr.io/cpopen/cpd/olm-utils:latest.s390x

      This command saves the image as a compressed TAR file named icr.io_cpopen_cpd_olm-utils_latest.s390x.tar.gz in the cpd-cli-workspace/olm-utils-workspace/work/offline directory.

  2. Transfer the compressed file to a client workstation that can connect to the cluster.

    Ensure that you place the TAR file in the cpd-cli-workspace/olm-utils-workspace/work/offline directory:

    x86-64 clusters
    icr.io_cpopen_cpd_olm-utils_latest.tar.gz
    s390x clusters
    icr.io_cpopen_cpd_olm-utils_latest.s390x.tar.gz
  3. From the workstation that can connect to the cluster:
    1. Ensure that Docker or Podman is running on the workstation.
    2. Run the following command to load the olm-utils image on the client workstation:
      x86-64 clusters
      cpd-cli manage load-image \
--source-image=icr.io/cpopen/cpd/olm-utils:latest

      The command returns the following message when the image is loaded:

      Loaded image: icr.io/cpopen/cpd/olm-utils:latest
      s390x clusters
      cpd-cli manage load-image \
--source-image=icr.io/cpopen/cpd/olm-utils:latest.s390x

      The command returns the following message when the image is loaded:

      Loaded image: icr.io/cpopen/cpd/olm-utils:latest.s390x