Downloading CASE packages before running IBM Cloud Pak for Data upgrade commands in a restricted network (Upgrading from Version 5.0.x to a later 5.0 refresh)

If you will run the IBM Cloud Pak for Data upgrade commands in a restricted network, you must have the CASE packages for the components that you plan to upgrade on the client workstation from which you will run the upgrade commands.

Upgrade phase

Updating your client workstation
Collecting required information
Preparing to run an upgrade in a restricted network
Preparing to run an upgrade from a private container registry
Upgrading prerequisite software
Upgrading shared cluster components
Preparing to upgrade an instance of Cloud Pak for Data
Upgrading an instance of Cloud Pak for Data

Who needs to complete this task?

All administrators Cluster administrators, registry administrators, and instance administrators must complete this task.

When do you need to complete this task?

In a restricted network, you must ensure that you have the CASE packages for the components that you plan to upgrade before you complete the following tasks:

Repeat as needed Complete this task on each workstation that will be used to complete the preceding tasks. Or, complete this task once and transfer the CASE packages to each workstation from which you will complete upgrade tasks.

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 can download the CASE packages from either of the following locations:

GitHub (github.com)
IBM Cloud Pak Open Container Initiative (icr.io)

Important: The client workstation must be able to access the site from which you plan to download the CASE packages.

Procedure

To prepare to run upgrades in a restricted network:

Run the appropriate command depending on the site from which you plan to download the CASE packages:

GitHub

cpd-cli manage case-download \
--components=${COMPONENTS} \
--release=${VERSION}

IBM Cloud Pak Open Container Initiative

cpd-cli manage case-download \
--components=${COMPONENTS} \
--release=${VERSION} \
--from_oci=true

Results

The CASE packages for the specified components are downloaded to the work directory.

Important: If you transfer the CASE packages to other workstations, ensure that you complete the following steps on each workstation:

Change to the directory that contains the work directory.
Set the following permissions on the work directory:
```
chown -R 1001 ./work
chmod -R 775 ./work
```
Restart the container:
```
cpd-cli manage restart-container
```

What to do next

Now that you've downloaded the CASE packages to your client workstation, you're ready to complete Preparing to run IBM Cloud Pak for Data upgrades from a private container registry (Upgrading from Version 5.0.x to a later 5.0 refresh).