Installing or upgrading the IBM Cloud Pak for Data resource specification injection webhook (Upgrading from Version 5.0.x to a later 5.0 refresh)

The resource specification injection (RSI) webhook is required if you plan to use node pinning to manage entitlement or if you want to apply your cluster-level HTTP proxy configuration to your IBM Cloud Pak for Data. If you installed the RSI webhook in Cloud Pak for Data Version 5.0.x, a cluster administrator must upgrade the webhook as part of the upgrade to a later Version 5.0 refresh. If you want to add the RSI webhook to the instance of Cloud Pak for Data, a cluster administrator must install it.

Upgrade phase
  • You are not here. Updating your client workstation
  • You are not here. Collecting required information
  • You are not here. Preparing to run an upgrade in a restricted network
  • You are not here. Preparing to run an upgrade from a private container registry
  • You are not here. Upgrading prerequisite software
  • You are not here. Upgrading shared cluster components
  • You are here icon. Preparing to upgrade an instance of Cloud Pak for Data
  • You are not here. Upgrading an instance of Cloud Pak for Data
Who needs to complete this task?

Cluster administrator A cluster administrator must complete this task.

When do you need to complete this task?
Complete this task if either of the following statements are true:
  • You installed the RSI webhook on Cloud Pak for Data Version 5.0.x and you need to upgrade the webhook.
  • You want to add the RSI webhook to your Cloud Pak for Data deployment so that you can:
    • Use node pinning to manage entitlement
    • Apply your cluster-level HTTP proxy configuration to your Cloud Pak for Data deployment

Repeat as needed If you have multiple instances of Cloud Pak for Data, repeat this task for each instance of Cloud Pak for Data where you want to use the RSI webhook.

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

The resource specification injection (RSI) feature is a mutating webhook that enables you to extend Kubernetes resources that are associated with IBM Cloud Pak for Data by applying patches directly to pods that are associated with Kubernetes deployments, StatefulSets, replicasets, replicacontrollers, jobs, and cronjobs.

Use the install-rsi and enable-rsi commands to install and enable the webhook.

Procedure

  1. Log the cpd-cli in to the Red Hat® OpenShift® Container Platform cluster:
    ${CPDM_OC_LOGIN}
  2. Install or upgrade the RSI webhook:

    The cluster pulls images from the IBM Entitled Registry
    cpd-cli manage install-rsi \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS}

    The cluster pulls images from a private container registry
    x86_64 clusters
    cpd-cli manage install-rsi \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --rsi_image=${PRIVATE_REGISTRY_LOCATION}/cpopen/cpd/zen-rsi-adm-controller:${VERSION}-x86_64
    ppc64le clusters
    cpd-cli manage install-rsi \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --rsi_image=${PRIVATE_REGISTRY_LOCATION}/cpopen/cpd/zen-rsi-adm-controller:${VERSION}-ppc64le
    s390x clusters
    cpd-cli manage install-rsi \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --rsi_image=${PRIVATE_REGISTRY_LOCATION}/cpopen/cpd/zen-rsi-adm-controller:${VERSION}-s390x

  3. Enable the RSI webhook:
    cpd-cli manage enable-rsi \
    --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS}
  4. Disable the zen-rsi-evictor-cron-job CronJob:
    oc patch CronJob zen-rsi-evictor-cron-job \
    --namespace=${PROJECT_CPD_INST_OPERANDS} \
    --type=merge \
    --patch='{"spec":{"suspend": true}}'

What to do next

Now that you've installed or upgraded the RSI webhook, you're ready to complete Applying your entitlements to monitor and report use against license terms (Upgrading from Version 5.0.x to a later 5.0 refresh).