Chapter 9. Installing on a single node

Procedure

1. On the administration node, open a browser and navigate to Install OpenShift with the Assisted Installer.
2. Click Create Cluster to create a new cluster.
3. In the Cluster name field, enter a name for the cluster.

4. In the Base domain field, enter a base domain. For example:

   example.com

   All DNS records must be subdomains of this base domain and include the cluster name. You cannot change the base domain after cluster installation. For example:

   <cluster-name>.example.com

5. Select Install single node OpenShift (SNO).
6. Read the 4.9 release notes, which outline some of the limitations for installing OpenShift Container Platform on a single node.
7. Select the OpenShift Container Platform version.
8. Optional: Edit the pull secret.
9. Click Next.
10. Click Generate Discovery ISO.
11. Select Full image file to boot with a USB drive or PXE. Select Minimal image file to boot with virtual media.
12. Add SSH public key of the administration node to the Public key field.
13. Click Generate Discovery ISO.
14. Download the discovery ISO.
15. Make a note of the discovery ISO URL for installing with virtual media.

Procedure

1. Download the OpenShift Container Platform client (oc) and make it available for use by entering the following command:

   $ curl -k https://mirror.openshift.com/pub/openshift-v4/clients/ocp/latest/openshift-client-linux.tar.gz > oc.tar.gz

   $ tar zxf oc.tar.gz

   $ chmod +x oc

2. Set the OpenShift Container Platform version:

   $ OCP_VERSION=<ocp_version> 1

   1

   Replace <ocp_version> with the current version. For example. latest-4.9

3. Download the OpenShift Container Platform installer and make it available for use by entering the following commands:

   $ curl -k https://mirror.openshift.com/pub/openshift-v4/clients/ocp/$OCP_VERSION/openshift-install-linux.tar.gz > openshift-install-linux.tar.gz

   $ tar zxvf openshift-install-linux.tar.gz

   $ chmod +x openshift-install

4. Retrieve the RHCOS ISO URL:

   $ ISO_URL=$(./openshift-install coreos print-stream-json | grep location | grep x86_64 | grep iso | cut -d\" -f4)

5. Download the RHCOS ISO:

   $ curl -L $ISO_URL > rhcos-live.x86_64.iso

6. Prepare the install-config.yaml file:

   apiVersion: v1
   baseDomain: <domain> 1
   compute:
   - name: worker
     replicas: 0 2
   controlPlane:
     name: master
     replicas: 1 3
   metadata:
     name: <name> 4
   networking:
     networkType: OVNKubernetes
     clusterNetwork:
     - cidr: <IP_address>/<prefix> 5
       hostPrefix: <prefix> 6
     serviceNetwork:
     - <IP_address>/<prefix> 7
   platform:
     none: {}
   bootstrapInPlace:
     installationDisk: <path_to_install_drive> 8
   pullSecret: '<pull_secret>' 9
   sshKey: |
     <ssh_key> 10

   1

   Add the cluster domain name.

   2

   Set the compute replicas to 0. This makes the control plane node schedulable.

   3

   Set the controlPlane replicas to 1. In conjunction with the previous compute setting, this setting ensures the cluster runs on a single node.

   4

   Set the metadata name to the cluster name.

   5

   Set the clusterNetwork CIDR.

   6

   Set the clusterNetwork host prefix. Pods receive their IP addresses from this pool.

   7

   Set the serviceNetwork CIDR. Services receive their IP addresses from this pool.

   8

   Set the path to the installation disk drive.

   9

   Copy the pull secret from the Red Hat OpenShift Cluster Manager. In step 1, click Download pull secret and add the contents to this configuration setting.

   10

   Add the public SSH key from the administration host so that you can log in to the cluster after installation.

7. Generate OpenShift Container Platform assets:

   $ mkdir ocp

   $ cp install-config.yaml ocp

   $ ./openshift-install --dir=ocp create single-node-ignition-config

8. Embed the ignition data into the RHCOS ISO:

   $ alias coreos-installer='podman run --privileged --pull always --rm \
           -v /dev:/dev -v /run/udev:/run/udev -v $PWD:/data \
           -w /data quay.io/coreos/coreos-installer:release'

   $ cp ocp/bootstrap-in-place-for-live-iso.ign iso.ign

   $ coreos-installer iso ignition embed -fi iso.ign rhcos-live.x86_64.iso

Procedure

1. On the administration node, insert a USB drive into a USB port.

2. Create a bootable USB drive:

   # dd if=<path-to-iso> of=<path/to/usb> status=progress

   For example:

   # dd if=discovery_image_sno.iso of=/dev/sdb status=progress

   After the ISO is copied to the USB drive, you can use the USB drive to install OpenShift Container Platform.

3. On the server, insert the USB drive into a USB port.
4. Reboot the server and enter the BIOS settings upon reboot.
5. Change boot drive order to make the USB drive boot first.
6. Save and exit the BIOS settings. The server will boot with the discovery image.

Procedure

1. On the administration host, return to the browser and refresh the page. If necessary, reload the Install OpenShift with the Assisted Installer page and select the cluster name.
2. Click Next until you reach step 3, Networking.
3. Select a subnet from the available subnets.
4. Keep Use the same host discovery SSH key checked. You can change the SSH public key, if necessary.
5. Click Next to proceed to the Review and Create step.
6. Click Install cluster.
7. Monitor the installation’s progress. Watch the cluster events. After the installation process finishes writing the discovery image to the server’s drive, the server will restart. Remove the USB drive and reset the BIOS to boot to the server’s local media rather than the USB drive.

Procedure

1. Monitor the installation:

   $ ./openshift-install --dir=ocp wait-for install-complete

   The server will restart several times while deploying the control plane.

2. Optional: After the installation is complete, check the environment:

   $ export KUBECONFIG=ocp/auth/kubeconfig

   $ oc get nodes

   $ oc get clusterversion