manage setup-instance-ns

Enable the project (namespace) where the IBM Cloud Pak for Data operators are installed to watch the project where you plan to install the control plane and services.

Extended description

Specialized installations only.

If you installed the Cloud Pak for Data operators in a separate project (namespace) from the IBM Cloud Pak® foundational services operators, you must enable the project where the Cloud Pak for Data operators are installed to watch the project where you plan to install the control plane and services.

The setup-instance-ns command creates or updates the nss-cpd-operators NamespaceScope object in the project where the Cloud Pak for Data operators are installed. The command adds the name of the project where you plan to install the control plane and services to the namespaceMembers list.

Syntax

cpd-cli manage setup-instance-ns \
--cpd_instance_ns=<project-name> \
--cpd_operator_ns=<project-name> \
[--preview=true|false] \
[-v][-vv][-vvv]

Arguments

The setup-iam-integration command has no arguments.

Options

Option Description
--cpd_instance_ns The project (namespace) where you want to install the control plane and services.
Status
Required.
Syntax
--cpd_instance_ns=<project-name>
Default value
No default. User-defined.
Valid values
The project (namespace) where you want to install the control plane and services.
--cpd_operator_ns The project (namespace) where the IBM Cloud Pak for Data operators exist.
Status
Required.
Syntax
--cpd_operator_ns=<project-name>
Default value
No default. User-defined.
Valid values
The project (namespace) where the IBM Cloud Pak for Data operators exist.
--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.

Enable the operators project to watch the instance project
cpd-cli manage setup-instance-ns \
--cpd_instance_ns=${PROJECT_CPD_INSTANCE} \
--cpd_operator_ns=${PROJECT_CPD_OPS}
Preview the oc commands to enable the operators project to watch the instance project
cpd-cli manage setup-instance-ns \
--cpd_instance_ns=${PROJECT_CPD_INSTANCE} \
--cpd_operator_ns=${PROJECT_CPD_OPS} \
--preview=true