The Qubinode Project


An easy to set up OpenShift development kit powered by Red Hat Ansible.

View the Project on GitHub Qubinode/qubinode-installer

Installing an OpenShift 4.x Cluster on a Single Node

The following documentation will help you deploy an OpenShift Container Platform (OCP) 4.3 cluster, on a single node. The installation steps deploys a production like OCP4 cluster, in a environment with 3 controlplane and 3 computes on a KVM hosts running Red Hat Enterprise Linux (RHEL)


Refer to the Getting Started Guide to ensure RHEL 7 is installed.

Get Subscriptions

Getting the OpenShift Pull Secret

Using Token Downloading
Navigate to OpenShift Cluster Manager API Token to generate a token and save it as ocp_token. This token will be used to download your pull secret. From your web browser, navigate to Red Hat OpenShift Cluster Manager. Find the Pull secret heading to either download or copy your pull secret, save it as pull-secret.txt.

Install OpenShift

The qubinode-installer

Download and extract the qubinode-installer as a non root user.

cd $HOME
mv qubinode-installer-master qubinode-installer

Place your pull secret and the rhel qcow image under the qubinode-installer directory.

If you are using tokens it should be:

* $HOME/qubinode-installer/ocp_token
* $HOME/qubinode-installer/rhsm_token

If you downloaded the files instead it should be:

* $HOME/qubinode-installer/pull-secret.txt
* $HOME/qubinode-installer/rhel-server-7.8-x86_64-kvm.qcow2
* $HOME/qubinode-installer/rhel-8.2-x86_64-kvm.qcow2

Install Options

Choose one of the below options. The quick start is ideal if you meet your resource requirements documented in our hardware guide. The advanced option will provide the most flexibilty as you can decide which modules you want to execute and also customize your OCP4 cluster size.

Standard Deployment Custom Deployment
Answer questions from the installer to deploy a 6 node OpenShift 4.x cluster, 3 controlplane and 3 computes. This option will allow you to deploy a 3 only or 4 node cluster or to customize the size of the cluster.

Additional Documentation

Troubleshooting Tips

Troubleshooting installation