`manage install-rsi`

Install the resource specification injection (RSI) feature by creating an instance-scoped webhook.

Required role: Cluster administrator A cluster administrator must run this command.

Extended description

If you want to use the resource specification injection (RSI) feature to customize the specifications of pods, you must install the RSI webhook. The webhook is installed in the project where IBM Cloud Pak for Data control plane is installed.

Important: Install the RSI webhook only if you are an advanced user on Red Hat® OpenShift® Container Platform. It is your responsibility to ensure that any patches that you apply to not introduce issues to your Cloud Pak for Data installation.

If you have multiple instances of Cloud Pak for Data on the cluster, you must run this command for each instance where you want to use the RSI feature.

Syntax

cpd-cli manage install-rsi \
--cpd_instance_ns=<project-name> \
[--rsi_image=<image-location-and-name>] \
[--preview=true|false] \
[-v][-vv][-vvv]

Arguments

The install-rsi command has no arguments.

Options

Table 1: Command options

Option	Description
`--cpd_instance_ns`	The project (namespace) where IBM Cloud Pak® for Data is installed. Status Required. Syntax `--cpd_instance_ns=<project-name>` Default value No default. User-defined. Valid values The project where the IBM Cloud Pak for Data control plane is installed. The RSI webhook will be created in this project.
`--rsi_image`	The location and name of the RSI image in the private container registry. Status Required if you mirrored the `zen-rsi-adm-controller` image to a private container registry. Syntax `--rsi_image=<image-location-and-name>` Default value No default. User-defined. Valid values Specify the image name based on your cluster hardware: x86-64 `${PRIVATE_REGISTRY_LOCATION}cpopen/cpd/zen-rsi-adm-controller:${VERSION}-x86_64` ppc64le `${PRIVATE_REGISTRY_LOCATION}cpopen/cpd/zen-rsi-adm-controller:${VERSION}-ppc64le` s390x `${PRIVATE_REGISTRY_LOCATION}cpopen/cpd/zen-rsi-adm-controller:${VERSION}-s390x`
`--preview`	Preview the commands that run when you issue this CLI command. The command issues a series of `oc` commands. You can see the list of `oc` commands that are associated with the command. The `oc` commands are saved to the `preview.sh` file in the `work` directory. Status Optional. Syntax `--preview=true\|false` Default value false If you omit this option, the default value is used. Valid values false Run the commands to apply the changes to your cluster. true Preview the commands without running them. You can copy the `oc` commands from the output and run them yourself. However, this method is not recommended. When you run the commands manually, you do not have access to the additional helper scripts that are included in the underlying Ansible® playbook.
`-v` `-vv` `-vvv`	Display verbose output. Options are listed from least verbose to the most verbose. Status Optional. Syntax Verbose output `-v` Very verbose output `-vv` Most verbose output `-vvv` Default value Not applicable. Valid values Not applicable.

Examples

Note: The following example uses the recommended installation environment variables.

It is strongly recommended that you use a script to create environment variables with the correct values for your environment. For details, see Setting up installation environment variables.

Install the RSI feature in the specified instance of Cloud Pak for Data

cpd-cli manage install-rsi \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS}

Install the RSI feature in the specified instance of Cloud Pak for Data when the cluster pulls images from a private container registry

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