`manage apply-icsp`

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.

Required for private container registries. If you mirrored images to a private container registry, create the required image content source policy to enable the cluster to pull the images from your private container registry.

Restriction: The apply-icsp command is applicable only if you mirror the IBM Cloud Pak for Data software images to a private container registry.

Extended description

If you mirror images to a private container registry, you must tell your cluster where to find the software images by creating an image content source policy. For more information, see Configuring an image content source policy.

Run this command to apply the required image content source policy to your cluster.

Important: This process will temporarily disable scheduling on each node in the cluster, so you might notice that resources are temporarily unavailable. However, this process happens on one node at a time. The cluster will temporarily disable scheduling on a node, apply the configuration change, and then re-enable scheduling before starting the process on the next node.

After you run the command, get the status of the nodes:

oc get nodes

Wait until all the nodes are Ready before you run other commands. For example, if you see Ready,SchedulingDisabled, wait for the process to complete:

NAME                           STATUS                     ROLES    AGE     VERSION
master0                        Ready                      master   5h57m   v1.20.0
master1                        Ready                      master   5h57m   v1.20.0
master2                        Ready                      master   5h57m   v1.20.0
worker0                        Ready,SchedulingDisabled   worker   5h48m   v1.20.0
worker1                        Ready                      worker   5h48m   v1.20.0
worker2                        Ready                      worker   5h48m   v1.20.0

You can use the watch oc get nodes command to monitor the status of the nodes. The command provides an update every 2 seconds. When all of the nodes return Ready you can exit the command by pressing Ctrl+C.

Alternatively, if you find that the oc get nodes command returns Ready prematurely, you can use the oc get mcp command to get the real-time status of the nodes.

Syntax

cpd-cli manage apply-icsp \
PRIVATE_REGISTRY_LOCATION

Arguments

Argument	Description
`PRIVATE_REGISTRY_LOCATION`	The host name or IP address of the private container registry.

Options

The apply-icsp command has no options.

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 required image content source policy on your cluster

cpd-cli manage apply-icsp \
${PRIVATE_REGISTRY_LOCATION}