Setting up a client workstation

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.

To install IBM Cloud Pak for Data backup and restore utilities, you must have a client workstation that can connect to the Red Hat® OpenShift® Container Platform cluster.

Before you begin

Before you install any software on the client workstation, ensure that the workstation meets the requirements in:

After you confirm that the workstation meets these requirements, you can install the required command-line interfaces.

Internet connection requirements

Some installation and upgrade tasks require a connection to the internet. If your cluster is in a restricted network, you can either:
  • 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.
When the workstation is connected to the internet, the workstation must be able to access the following sites:
  • GitHub (https://github.com/IBM)

    If your company does not permit access to GitHub, contact IBM® Support.

  • IBM Entitled Registry (http://icr.io)

    To validate that you can connect to the IBM Entitled Registry, run the following command:

    curl -v https://icr.io
    The command returns a message similar to:
    * Connected to icr.io (169.60.98.86) port 443 (#0)
    Note: The IP address might be different.

Operating system requirements

The client workstation must be running a supported operating system:
Operating system x86-64 s390x Notes
Linux® ✓ ✓  
Mac OS ✓    
Windows ✓   To run on Windows, you must install Windows Subsystem for Linux.

Container runtime requirements

The workstation must have a supported container runtime.

Operating system Docker Podman Notes
Linux ✓ ✓  
Mac OS ✓ ✓  
Windows ✓ ✓
Set up the container runtime inside Windows Subsystem for Linux.

Required command-line interfaces

To install or upgrade the Cloud Pak for Data platform, you must have the following command-line interfaces:
  • OpenShift command-line interface (oc)
  • Cloud Pak for Data command-line interface (cpd-cli)