manage apply-db2-kubelet

Apply the required kubelet configuration to all cluster nodes to allow Db2U to make unsafe sysctl changes for kernel parameters.

Extended description

Restriction: The apply-db2-kubelet command is applicable only if you are installing one or more of the following services:
  • Db2®
  • Db2 Warehouse SMP
  • Watson™ Knowledge Catalog

An alternate procedure is required if you plan to install Db2 Warehouse MPP.

By default, Db2U runs with elevated privileges. If you want to run Db2U with limited privileges, you must run the apply-db2-kubelet command to change the kernel parameter settings.

To ensure sufficient performance, Db2U needs to manage memory settings on cluster nodes. Db2U uses kubelet to make unsafe sysctl calls to manage these settings.

Run this command to apply the required kubelet configuration to your cluster nodes.

You can run this command only on self-managed Red Hat® OpenShift® Container Platform environments.

You cannot change the kernel parameter settings on managed Red Hat OpenShift Container Platform environments, such as:
  • Red Hat OpenShift on IBM Cloud®
  • Red Hat OpenShift Service on AWS (ROSA)
  • Azure Red Hat OpenShift (ARO)

Review the guidance in Changing kernel parameter settings before you run this command.

Syntax

cpd-cli manage apply-db2-kubelet \
[--force=true|false] \
[--preview=true|false]

Arguments

The apply-db2-kubelet 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.
--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.
Note: Versions 12.0.0 - 12.0.2 of the cpd-cli included the --openshift_type option. This option was removed in Version 12.0.3 of the cpd-cli because the command can be run only on self-managed Red Hat OpenShift Container Platform.

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 kubelet settings on your cluster
cpd-cli manage apply-db2-kubelet
Override the existing kubelet settings on your cluster
cpd-cli manage apply-db2-kubelet \
--force=true
Preview the oc commands that you can run to apply the kubelet settings on your cluster
cpd-cli manage apply-db2-kubelet \
--preview=true