Preparing a client to connect to the cluster

Make sure that the client that you intend to use to connect to the Red Hat OpenShift cluster has all the necessary tools.

About this task

A Red Hat OpenShift Kubernetes Service (ROKS) cluster, a Red Hat OpenShift Kubernetes Service on AWS (ROSA) cluster, an Azure Red Hat OpenShift (ARO) cluster, and a private Red Hat OpenShift cluster have different requirements.

Client-side requirements
Table 1. Client-side requirements step by step
Requirement More information
(For OCP deployments) OCP CLI For more information, see the OpenShift documentation and the download link. Download the latest version for your OCP cluster.

The CLI has commands for managing your applications, and lower-level tools to interact with each component of your system.

Place the oc binary in a directory that is on your PATH. To check your PATH, run the following command.

echo $PATH

When the CLI is in your PATH, it is available by running the oc command.

(For CNCF deployments) Kubernetes 1.16+ CLI For more information, see https://kubernetes.io/docs/tasks/tools/install-kubectl/.
You must use a kubectl version that is within one minor version difference of your cluster. Using the latest version of kubectl helps avoid unforeseen issues. Download the latest release with the command:
export KUBECTL_VERSION=curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt
curl -LO "https://storage.googleapis.com/kubernetes-release/release/${KUBECTL_VERSION}/bin/linux/amd64/kubectl"

To check the version, run the following command.

kubectl version --client
Podman CLI If you plan to use an OpenShift-based platform and want to download the container images to a private registry, you must install the Podman CLI. You can install Podman by running the following command.
yum -y install podman
Note: The podman CLI is needed on an OCP registry, as OCP does not support a Docker login. If you plan to run the scripts on macOS or you want to stick with docker, you must install the Docker CLI and add the following line to the /etc/sysconfig/docker file.
INSECURE_REGISTRY='--insecure-registry=route'
Where route is the name of the route for your image registry. For example, INSECURE_REGISTRY='--insecure-registry=default-route-openshift-image-registry.apps.<hostname>'.

Use this solution for isolated testing or in tightly controlled environments only. For more information, see Deploy a plain HTTP registry.

What else is needed before you run the installation scripts
Table 2. Script requirements
Requirement More information
Operating system Can be run on any machine with Python 3.8 and above.
Python Python 3.8 and above. For more information, see Download Python
Java™ version (FNCM prerequisites script only)
FNCM container image version Supported Java version
5.5.8 Java™ 8
5.5.11 Java™ Semuru 11. For download information, see Semeru Runtimes getting started.
from 5.5.12 until 5.6.0 Java™ Semeru 17. For download information, see Semeru Runtimes getting started.
Note: Only the FNCM prerequisites script requires Java™.
Skopeo CLI For more information about skopeo CLI version 1.x, see Installing skopeo from packages.

What to do next

Go to and complete the next step in Downloading the container-samples repository.