Updating the service-specific software on a remote physical location (Upgrading from Version 5.1.x to a later 5.1 refresh)

After you upgrade the IBM® Software Hub agents on the remote physical location, you must upgrade the service-specific software on the remote physical location.

Who needs to complete this task?: Cluster administrator A cluster administrator must complete this task.

When do you need to complete this task?: Repeat as needed Complete this task for each remote physical location that connects to the hub.

Before you begin

Best practice: You can run the commands in this task exactly as written if you use set up environment variables for the remote physical location in addition to the installation environment variables script. For instructions, see Setting up environment variables for a remote physical location.

Before you run the commands in this task, ensure that you source the environment variables for:

The primary cluster
The remote physical location

Procedure

Log the cpd-cli in to the Red Hat® OpenShift® Container Platform cluster:
```
${REMOTE_CPDM_OC_LOGIN}
```
Remember: REMOTE_CPDM_OC_LOGIN is an alias for the cpd-cli manage login-to-ocp command when you are connecting to a remote cluster.

If you installed the Analytics Engine powered by Apache Spark operator on the remote physical location, upgrade the operator:

Ensure that Docker or Podman is running on the workstation.

Pull the ibm-cpd-analyticsengine-dataplane-operator image from the IBM Entitled Registry:

Docker

docker pull cp.icr.io/cp/ibm-cpd-analyticsengine-dataplane-operator:${VERSION}-amd64,

Podman

podman pull cp.icr.io/cp/ibm-cpd-analyticsengine-dataplane-operator:${VERSION}-amd64,

Inspect the ibm-cpd-analyticsengine-dataplane-operator image to get the image digest:

Docker

docker image inspect cp.icr.io/cp/ibm-cpd-analyticsengine-dataplane-operator:${VERSION}-amd64,

Podman

podman image inspect cp.icr.io/cp/ibm-cpd-analyticsengine-dataplane-operator:${VERSION}-amd64,

The image inspect command returns output with the following format:

[
     {
          "Id": "4db688dab20b4e21cbe3d0db103228ea189911551ae7cf3ca71d35daa7e1d360",
          "Digest": "sha256:41e19e01101dc9a49f89be5b22ccf01b138e89a04dcf0bfe2a6203e0b7266b49",
          "RepoTags": [
               "cp.icr.io/cp/ibm-cpd-analyticsengine-dataplane-operator:#.#.#-amd64"
          ],
          "RepoDigests": [
               "cp.icr.io/cp/ibm-cpd-analyticsengine-dataplane-operator@sha256:41e19e01101dc9a49f89be5b22ccf01b138e89a04dcf0bfe2a6203e0b7266b49"
          ],
          "Parent": "",
          "Comment": "",
          "Created": "2024-11-06T08:01:26.481934712Z",
          "Config": {
               "User": "1001",
               "Env": [
                    "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                    "container=oci",
                    "TINI_VERSION=v0.19.0",
                    "HOME=/opt/ansible",
                    "USER_NAME=ansible",
                    "USER_UID=1001"
               ],

Set the OPERATOR_DIGEST environment variable to the value of the Digest parameter:
```
export OPERATOR_DIGEST=<sha256-string>
```
Download the data plane operator setup script, deploy_operator.sh from the RemoteDataPlane folder in the IBM/AnalyticsEngine repository on GitHub.
Change to the directory where you downloaded the script.

Run the following command to deploy the operator:

./deploy_operatortest.sh \
--namespace ${REMOTE_PROJECT_MANAGEMENT} \
--digest ${OPERATOR_DIGEST} \
--version ${VERSION}

Confirm that the analyticsenginedataplane operator is in the Completed state:

oc get analyticsenginedataplane \
--namespace=${REMOTE_PROJECT_MANAGEMENT}

Upgrade the DataStage operator on the remote physical location:
1. Download the operator deployment script, deploy_operator.sh, from the RemoteDataPlane folder on https://github.com/IBM/DataStage/tree/main/RemoteDataPlane on GitHub.
2. Change to the directory where you downloaded the script.
3. Run the following command to upgrade the operator:
```
./deploy_operator.sh --namespace ${REMOTE_PROJECT_MANAGEMENT}
```
If you installed the DataStage operator on the remote physical location, upgrade the operator:
1. Download the operator deployment script, deploy_operator.sh, from the RemoteDataPlane folder on https://github.com/IBM/DataStage/tree/main/RemoteDataPlane on GitHub.
2. Change to the directory where you downloaded the script.
3. Run the following command to upgrade the operator:
```
./deploy_operator.sh --namespace ${REMOTE_PROJECT_MANAGEMENT}
```