manage install-rsi

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

Required role

Instance administrator An instance administrator can 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

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 value with the format: ${PRIVATE_REGISTRY_LOCATION}cpopen/cpd/zen-rsi-adm-controller:${VERSION}-x86_64
--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.

Table 1: Command options

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 Best practice: 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