Setting up a client workstation

To install IBM Cloud Pak® for Data, 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.

Hardware requirements

You can run the installation commands from a workstation that is running on one of the following types of hardware:
  • x86-64
  • s390x

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)