OpenShift Single Node (SNO) Installation Guide

This project provides the configuration files and instructions required to deploy a Single Node OpenShift (SNO) cluster using the Agent-based Installer.

🚀 Overview

The Agent-based installer generates a bootable ISO image that contains the discovery agent and required services to automate the installation of OpenShift on a single node (bare-metal or VM).

📋 Prerequisites

Before you begin, ensure you have the following tools installed on your jump host:

• OpenShift Installer (openshift-install): Download here
• OpenShift CLI (oc): Download here
• Pull Secret: Get yours from Red Hat Hybrid Cloud Console.

🛠️ Configuration Files

Update the following files in this directory with your specific environment details:

1. install-config.yaml

Defines the cluster settings.

• metadata.name: Your cluster name.
• baseDomain: Your base domain.
• pullSecret: Paste your Red Hat pull secret.
• sshKey: Your public SSH key for debugging.
• controlPlane.replicas: Must be set to 1 for SNO.
• compute.replicas: Must be set to 0 for SNO.

2. agent-config.yaml

Defines host-specific network and hardware configurations.

• rendezvousIP: The IP address of the node.
• hosts: Configure network interfaces, MAC addresses, and disk hints.

📦 Installation Steps

Step 1: Generate the ISO Image

Run the following command to create the bootable ISO:

./openshift-install agent create image --dir .

This will create an agent.iso file in your current directory.

Step 2: Boot the Node

1. Mount the agent.iso to your target node (via virtual media, USB, or PXE).
2. Power on the node and ensure it boots from the ISO.

Step 3: Monitor the Installation

You can track the progress of the deployment using these commands:

# Wait for the bootstrap process to complete
./openshift-install agent wait-for bootstrap-complete --log-level info --dir .

# Wait for the full installation to finish
./openshift-install agent wait-for install-complete --log-level info --dir .

🔐 Post-Installation

Once the installation is complete, you can access your cluster:

• Kubeconfig: Found in ./auth/kubeconfig.
• Admin Password: Found in ./auth/kubeadmin-password.
• Console URL: https://console-openshift-console.apps.<cluster-name>.<base-domain>

---

Tip

Ensure your DNS records (API and Ingress) are correctly configured pointing to the node's IP before starting the installation.