Client workstation requirements

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.

You can use a client workstation, such as a laptop, to run the IBM Cloud Pak for Data command-line interface (cpd-cli).

The cpd-cli is comprised of several plug-ins. Some of the plug-ins have different hardware requirements, container runtime requirements, and internet access requirements. Use the information in the following table to determine which plug-ins you will need to run based on your role in installing and administering Cloud Pak for Data:
Plug-in How is this plug-in used? Related documentation
config Create a local user configuration and profile to enable you to run the following cpd-cli commands against an existing Cloud Pak for Data instance:
  • cpd-cli diag
  • cpd-cli export-import
  • cpd-cli service-instance
  • cpd-cli user-mgmt
cpdbr Backup and restore Cloud Pak for Data volumes.
cpdbr-oadp Backup and restore Cloud Pak for Data deployments, including volumes.
cpdtool Export and import platform and service data, including metadata.
manage Install and upgrade Cloud Pak for Data
migrate Migrate your LDAP configuration from Cloud Pak for Data to the IBM Cloud Pak foundational services IAM Service.
platform-diag Gather diagnostic information about a Cloud Pak for Data deployment.
platform-mgmt Manage the service instances and users associated with a Cloud Pak for Data deployment.
Service instances
Users

Hardware requirements for client workstations

Some of the cpd-cli plug-ins support a subset of the hardware that Cloud Pak for Data supports.

Note: The hardware on the client workstation does not need to be the same as the hardware on the cluster. For example, if your cluster is running s390x hardware, you can run the cpd-cli on an x86-64 client workstation.

Use the following table to determine whether you have the appropriate operating system to run the plug-ins that you plan to use:

Plug-in x86-64 ppc64le s390x
config ✓ ✓ ✓
cpdbr ✓ ✓  
cpdbr-oadp ✓ ✓  
cpdtool ✓ ✓  
manage ✓   ✓ *
migrate ✓ ✓  
platform-diag ✓ ✓ ✓
platform-mgmt ✓ ✓ ✓

* The olm-utils image for the manage plug-in is available on x86-64 and s390x hardware. The zen-rsi-adm-controller image, which is required only if you want to use the resource specification injection (RSI) feature, is available only on x86-64 hardware.

Operating system requirements for client workstations

The hardware that you are running determines which operating system the client workstation can run.

Operating system x86-64 ppc64le s390x Notes
Linux® ✓ ✓ ✓  
Mac OS ✓      
Windows ✓     To run on Windows, you must install Windows Subsystem for Linux.

Container runtime requirements for client workstations

Some of the cpd-cli plug-ins require a container runtime, such as Docker or Podman.

It is strongly recommended that you use the latest version of the container runtime that is compatible with your operating system.

The minimum recommended versions are:
Plug-in Runtime required Runtimes supported
config    
cpdbr ✓
  • Docker
cpdbr-oadp ✓
  • Docker
cpdtool ✓
  • Docker
manage ✓
  • Docker
  • Podman
migrate    
platform-diag    
platform-mgmt    
Windows users: If you are running the cpd-cli on the Windows operating system, you must set up the container runtime inside Windows Subsystem for Linux.

Internet access requirements for client workstations

The cpd-cli plug-ins have various internet access requirements. At a minimum, the workstation must be able to access the cluster network. However, some of the plug-ins require public internet access to complete a subset of tasks, such as downloading files and containerized software images. Use the following table to determine whether the plug-ins that you plan to use require internet access:

Plug-in Requires public internet connection?
config No.
cpdbr Required to obtain the cpdbr image.

Also required if your S3 storage is not in your cluster network.
cpdbr-oadp Required to obtain the cpdbr-velero-plugin and ubi8/ubi-minimal images.

Also required if your object storage is not in your cluster network.
cpdtool Required to obtain the cpdtool image.
manage Required to:
  • Obtain the olm-utils-play image.
  • Download the required CASE packages
  • Mirror images to a private container registry or to an intermediary container registry on the workstation.
migrate Required to obtain the zen-ldapmigrate image.
platform-diag No.
platform-mgmt No.

If your cluster is in a restricted network, you can:

  • Move the workstation behind the firewall after you complete the tasks that require an internet connection.
  • Prepare a client workstation that can connect to the internet and a client workstation that can connect to the cluster and transfer any files from the internet-connected workstation to the cluster-connected workstation.