`manage install-rsi`

Install the resource specification injection (RSI) feature on the cluster by creating a cluster-wide webhook.

Extended description

If you want to use the resource specification injection (RSI) feature to customize the specifications of pods on your cluster, you must install the RSI webhook on the cluster. The webhook is installed in the project where IBM Cloud Pak® foundational services is installed.

You must be a cluster administrator to run this command.

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.

Syntax

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

Arguments

The install-rsi command has no arguments.

Options

Option	Description
`--cs_ns`	The project where IBM Cloud Pak foundational services are installed. Status Required if IBM Cloud Pak foundational services are installed in a project other than `ibm-common-services`. Syntax `--cs_ns=<project-name>` Default value `ibm-common-services` If you omit this option, the default value is used. Valid values The name of the project where IBM Cloud Pak foundational services 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 value with the format: `${PRIVATE_REGISTRY_LOCATION}/cpd/zen-rsi-adm-controller:4.6.5-x86_64`
`--preview`	Preview the commands that run when you issue this CLI command. The command issues a series of `oc` commands. You can optionally see the list of `oc` commands that are associated with the command. The `oc` commands are saved to the `preview.sh` file in the `cpd-cli-workspace/olm-utils-workspace/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 optionally 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.

Use a script to create environment variables with the correct values for your environment. For details, see Best practice: Setting up install variables.

Install the RSI feature when IBM Cloud Pak foundational services is installed in ibm-common-services

cpd-cli manage install-rsi

Install the RSI feature when IBM Cloud Pak foundational services is installed in a project other than ibm-common-services

cpd-cli manage install-rsi \
--cs_ns=${PROJECT_CPFS_OPS}