IBM Support

Image "cpfs-oadp-plugins:4.10.0" is required to backup and restore tools in IBM Software Hub 5.2.x

Troubleshooting


Problem

Install the Red Hat OADP operator with the command following to the document 3.3 Installing backup and restore components on a Red Hat OpenShift Container Platform cluster
 

5.Install the Red Hat OADP operator.
cpd-cli oadp install 
--component oadp-operator 
--namespace oadp-operator 
--oadp-version v1.4.4 
--log-level trace 
--velero-cpu-limit 2 
--velero-mem-limit 2Gi 
--velero-cpu-request 1 
--velero-mem-request 256Mi 
--node-agent-pod-cpu-limit 2 
--node-agent-pod-mem-limit 2Gi 
--node-agent-pod-cpu-request 0.5 
--node-agent-pod-mem-request 256Mi 
--uploader-type ${UPLOADER_TYPE} 
--bucket-name=velero 
--prefix=cpdbackup 
--access-key-id ${OBJECT_STORAGE_ACCESS_KEY} 
--secret-access-key ${OBJECT_STORAGE_SECRET_KEY} 
--s3force-path-style=true 
--region=minio 
--s3url ${OBJECT_STORAGE_ROUTE} 
--cpfs-oadp-plugin-image "icr.io/cpopen/cpfs/cpfs-oadp-plugins:4.10.0" 
--swhub-velero-plugin-image "icr.io/cpopen/cpd/swhub-velero-plugin:5.2.2" 
--cpdbr-velero-plugin-image "icr.io/cpopen/cpd/cpdbr-velero-plugin:5.2.2" 
--extra-custom-plugins "db2u-velero-plugin=icr.io/db2u/db2u-velero-plugin:5.2.2" 
--verbose

The velero pod fails with ImagePullBackOff error in air-gapped cluster in pulling the image "icr.io/cpopen/cpfs/cpfs-oadp-plugins:4.10.0".

Resolving The Problem

IBM Software Hub 5.2.x Backup & Restore is validated using "cpfs-oadp-plugins:4.10.0", which is the default plugin image version used by the tooling. It needs to be mirrored manually to the private registry.

1. Save the image "icr.io/cpopen/cpfs/cpfs-oadp-plugins:4.10.0" using the command:

cpd-cli manage save-image --from=icr.io/cpopen/cpfs/cpfs-oadp-plugins:4.10.0

2. Transfer the compressed file to a client workstation and place it in the work/offline directory.
icr.io_cpopen_cpfs_cpfs-oadp-plugins_4.10.0.tar.gz

3. Copy the relevant image to the private container registry using the command:

cpd-cli manage copy-image --from=icr.io/cpopen/cpd/k8s-storage-perf:${VERSION} --to=${PRIVATE_REGISTRY_LOCATION}/cpopen/cpfs/cpfs-oadp-plugins:4.10.0.tar.gz

Refer to Moving images for cpd-cli plug-ins to a private container registry for detailed instructions and command sample.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB76","label":"Data Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSNFH6","label":"IBM Software Hub"},"ARM Category":[{"code":"a8m3p000000UoTDAA0","label":"Recovery-\u003EBackup"}],"ARM Case Number":"TS020477993","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.2.0;5.2.1"}]

Document Information

Modified date:
10 November 2025

UID

ibm17250762

Page Feedback