Upgrading foundational services in an air-gapped environment

You can upgrade foundational services that were installed in a prior release in an airgap environment.

Supported upgrade paths

You can upgrade only the following supported paths:

During the upgrade process, you cannot access the services management console.

Upgrading to the latest continuous delivery version

Upgrading from version 4.x or later to the latest continuous delivery version (4.x or later)

Upgrading foundational services Cert-Manager, License Service and License Service Reporter

1. Log in to the cluster as an administrator by using the oc login command.

2. Mirror the images.

3. Create the catalog source.

4. Download the cp3pt0-deployment folder, from the installer_scripts folder in the CASE bundle. For information on downloading the scripts, see Downloading scripts for additional configuration from specific version CASE bundle.

   Go to your downloaded installer_scripts directory.

   cd ${installer_scripts}/cp3pt0-deployment
   

1. Read the script usage instructions by passing the -h flag to the script.

   ./setup_singleton.sh -h
   

   Note: You can specify the required subscription channel v4.x as the command argument to upgrade Cert Manager or Licensing Service version to v4.x.x. For example, if you need to upgrade the Cert Manager or Licensing Service version to 4.2.2, specify -c v4.2 as the command argument.

2. Run the script by passing the parameters.

   Note: You must provide the --license-accept parameters.

   1. Run the following command to upgrade Cert-Manager only:

      ./setup_singleton.sh --license-accept \
        -c v4.2 \
      

   2. Run the following command to upgrade Cert-Manager and License Service:

      ./setup_singleton.sh --license-accept \
        --enable-licensing \
        -c v4.2 \
      

   3. Run the following command to upgrade Cert-Manager, License Service and License Service Reporter:

      ./setup_singleton.sh --license-accept \
        --enable-licensing \
        --enable-license-service-reporter \
        -c v4.2 \
      

Upgrading foundational services services

1. Log in to the cluster as an administrator by using the oc login command.

2. Mirror the images.

3. Create the catalog source.

4. Download the cp3pt0-deployment folder, from the installer_scripts folder in the CASE bundle. For information on downloading the scripts, see Downloading scripts for additional configuration from specific version CASE bundle.

   Go to your downloaded installer_scripts directory.

   cd ${installer_scripts}/cp3pt0-deployment
   

5. Read the script usage instructions by passing the -h flag to the script.

    ./setup_tenant.sh -h
   

   Note: You can specify the required subscription channel v4.x as the command argument to upgrade Cert Manager or Licensing Service version to v4.x.x. For example, if you need to upgrade the Cert Manager or Licensing Service version to 4.2.2, specify -c v4.2 as the command argument.

6. Run the script by passing the parameters.

   Note: You must provide the --license-accept and --operator-namespace parameters.

    ./setup_tenant.sh --license-accept \
      --enable-licensing \
      --operator-namespace <foundational-services-namespace> \
      -c v4.5 \
      -i Automatic \
      -s opencloud-operators \
      -n openshift-marketplace \
      -v 1
   

Upgrade steps

Mirror the images

You must download following CASE files to mirror, and import the images in your private container registry. Then complete the following steps in Installing your IBM Cloud Pak by mirroring Cloud Pak images to a private container registry (with ibm-pak plug-in).

• ibm-cert-manager-4.2.2.tgz
• ibm-licensing-4.2.2.tgz
• ibm-license-service-reporter-bundle-4.2.2.tgz
• ibm-cp-common-services-4.5.0.tgz

For more information, see IBM Catalog Management Plug-in for IBM Cloud Paks.

Create the catalog source

After you mirror the images, complete these steps:

1. Create the catalog source for the new version of foundational services to which you are upgrading.

   oc apply -f ~/.ibm-pak/data/mirror/$CASE_NAME/$CASE_VERSION/catalog-sources.yaml
   

Troubleshooting

If you encounter any issues during your upgrade, review the frequently encountered errors to help you troubleshoot your issue. For more information, see Troubleshooting IBM Cloud Pak foundational services install and upgrade.