Apply the required Container Runtime Interface (CRI-O) settings to your cluster nodes.
Extended description
Restriction: The
apply-crio
command is
applicable only if you are installing one or more of the following services:
- Cognos® Analytics
- Data Virtualization
- Db2®
- Db2 Big SQL
- Db2
Warehouse
- Watson™ Discovery
- Watson Knowledge
Catalog
- Watson Studio
- Watson Machine Learning
Accelerator
These settings are required on all deployment environments except IBM® Cloud.
To ensure that the preceding services can run correctly, you must adjust the CRI-O container settings to specify the maximum number
of processes.
These settings are required for the CRI-O
container runtime on the OpenShift® Container Platform
cluster.
Run this command to apply the required CRI-O
settings to your cluster nodes.
Important: This command performs a rolling restart of the worker nodes on the
cluster.
Syntax
cpd-cli manage apply-crio \
[--force=true|false] \
[--openshift-type=self-managed|roks|rosa|aro] \
[--preview=true|false]
Arguments
The apply-crio
command has no arguments.
Options
Option |
Description |
--force |
Apply the node settings, even if they have already been applied.
- Status
- Optional.
- Syntax
--force=true|false
- Default value
- false
If you omit this option, the default value is
used.
- Valid values
-
- false
- If the node settings have already been applied, no changes will be made.
- true
- Apply the node settings, even if they have already been applied.
You might need to use this
setting if you upgraded OpenShift Container Platform after you
applied the node settings and the upgrade prevents the node settings from taking effect.
|
--openshift-type |
The type of Red Hat® OpenShift Container Platform cluster that you are running.
- Status
- Optional.
- Syntax
--openshift-type=self-managed|roks|rosa|aro
- Default value
- self-managed
If you omit this option, the default value is
used.
- Valid values
-
- aro
- You are running a managed Azure Red Hat
OpenShift
(ARO) cluster.
- roks
- You are running a managed Red Hat
OpenShift on IBM Cloud®
cluster.
- rosa
- You are running a managed Red Hat OpenShift Service on AWS
(ROSA) cluster.
- self-managed
- You are running a self-managed Red Hat OpenShift Container Platform cluster in a supported deployment environment.
|
--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.
|
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.
- Apply the CRI-O settings on your
cluster
-
cpd-cli manage apply-crio \
--openshift-type=${OPENSHIFT_TYPE}
- Override the existing CRI-O settings on
your cluster
-
cpd-cli manage apply-crio \
--openshift-type=${OPENSHIFT_TYPE} \
--force=true
- Preview the
oc
commands that you can run to apply the CRI-O settings on your cluster
-
cpd-cli manage apply-crio \
--openshift-type=${OPENSHIFT_TYPE} \
--preview=true