manage apply-crio

Important: IBM Cloud Pak® for Data Version 4.6 will reach end of support (EOS) on 31 July, 2025. For more information, see the Discontinuance of service announcement for IBM Cloud Pak for Data Version 4.X.

Upgrade to IBM Software Hub Version 5.1 before IBM Cloud Pak for Data Version 4.6 reaches end of support. For more information, see Upgrading IBM Software Hub in the IBM Software Hub Version 5.1 documentation.

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
  • Db2®
  • Db2 Big SQL
  • Db2 Warehouse
  • Watson Discovery
  • Watson Knowledge Catalog
  • Watson Query
  • 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