Upgrading watsonx.data from version 1.0.x to 1.1.x

Complete the following steps to upgrade watsonx.data:

1. Log in to the Red Hat OpenShift Container Platform cluster:

   cpd-cli manage login-to-ocp \
   --username=${OCP_USERNAME} \
   --password=${OCP_PASSWORD} \
   --server=${OCP_URL}

2. Update the custom resource for watsonx.data.
   The command that you run depends on the storage on your cluster:

   • Red Hat OpenShift Data Foundation Storage

     Run the following command to create the custom resource.

     cpd-cli manage apply-cr \
     --components=watsonx_data \
     --release=${VERSION} \
     --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
     --block_storage_class=${STG_CLASS_BLOCK} \
     --file_storage_class=${STG_CLASS_FILE} \
     --license_acceptance=true \
     --upgrade=true

   • IBM Storage Fusion Data Foundation storage

     Run the following command to create the custom resource.

     cpd-cli manage apply-cr \
     --components=watsonx_data \
     --release=${VERSION} \
     --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
     --block_storage_class=${STG_CLASS_BLOCK} \
     --file_storage_class=${STG_CLASS_FILE} \
     --license_acceptance=true \
     --upgrade=true

   • IBM Storage Fusion Global Data Platform storage

     Remember: When you use IBM Storage Fusion storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class, typically ibm-spectrum-scale-sc or ibm-storage-fusion-cp-sc.

     Run the following command to create the custom resource.

     cpd-cli manage apply-cr \
     --components=watsonx_data \
     --release=${VERSION} \
     --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
     --block_storage_class=${STG_CLASS_BLOCK} \
     --file_storage_class=${STG_CLASS_FILE} \
     --license_acceptance=true \
     --upgrade=true

   • IBM Storage Scale Container Native storage

     Remember: When you use IBM Storage Scale Container Native storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class, typically ibm-spectrum-scale-sc.

     Run the following command to create the custom resource.

     cpd-cli manage apply-cr \
     --components=watsonx_data \
     --release=${VERSION} \
     --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
     --block_storage_class=${STG_CLASS_BLOCK} \
     --file_storage_class=${STG_CLASS_FILE} \
     --license_acceptance=true \
     --upgrade=true

   • Portworx storage

     Run the following command to create the custom resource.

     cpd-cli manage apply-cr \
     --components=watsonx_data \
     --release=${VERSION} \
     --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
     --storage_vendor=portworx \
     --license_acceptance=true \
     --upgrade=true

   • NFS storage

     Remember: When you use NFS storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class, typically managed-nfs-storage.

     Run the following command to create the custom resource.

     cpd-cli manage apply-cr \
     --components=watsonx_data \
     --release=${VERSION} \
     --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
     --block_storage_class=${STG_CLASS_BLOCK} \
     --file_storage_class=${STG_CLASS_FILE} \
     --license_acceptance=true \
     --upgrade=true

   • AWS with EFS and EBS storage

     Run the following command to create the custom resource.

     cpd-cli manage apply-cr \
     --components=watsonx_data \
     --release=${VERSION} \
     --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
     --block_storage_class=${STG_CLASS_BLOCK} \
     --file_storage_class=${STG_CLASS_FILE} \
     --license_acceptance=true \
     --upgrade=true

   • NetApp Trident

     Remember: When you use NetApp Trident storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class.

     Run the following command to create the custom resource.

     cpd-cli manage apply-cr \
     --components=watsonx_data \
     --release=${VERSION} \
     --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
     --block_storage_class=${STG_CLASS_BLOCK} \
     --file_storage_class=${STG_CLASS_FILE} \
     --license_acceptance=true \
     --upgrade=true

   Note: To upgrade watsonx.data service from version 1.0.1 to 1.1.0, you must patch the following components after running the apply-cr command.

   • wxdEngine
   • wxd
   • wxdAddon

   Run the following command to patch the components. Do not run it for version 1.1.1 and later.

   oc get wxdaddon,wxd,wxdengine -o name -n ${PROJECT_CPD_INST_OPERANDS} | xargs -n 1 oc patch --type=merge -n ${PROJECT_CPD_INST_OPERANDS} -p '{ "spec": { "version": "1.1.0" } }'

3. Validate the upgrade.
   watsonx.data is upgraded when the apply-cr command returns:

   [SUCCESS]... The apply-cr command ran successfully

   If you want to confirm that the custom resource status is Completed, you can run the cpd-cli manage get-cr-status command:

   cpd-cli manage get-cr-status \
   --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --components=watsonx_data