⚡ SNO Quick Start Guides
Automated Quick Start
Install SNO using the Ansible automation built into this repository. Recommended for most users — a single playbook command handles everything.
Manual Step-by-Step Quick Start
Manually configure each service (dnsmasq, httpd, PXE, ignition). Useful for learning the internals or for custom environments.
🎨 Architecture & Design
Architecture Diagrams
Visual representations of OpenShift deployment architectures including SNO setup, LPAR configurations, and bastion services.
Why Bastion Services?
Comprehensive explanation of why dedicated bastion LPARs are essential, comparing corporate infrastructure vs bastion approach, and x86 vs PowerVM differences.
🔧 SNO Troubleshooting & Tips
SNO Quick Tips & Commands
Essential commands for SNO installation, bootstrap tracking, status checks, and common issue fixes. Includes copy-paste ready commands and useful aliases.
SNO Installation Verification
Complete guide for verifying SNO installation status, checking logs, troubleshooting common issues, and confirming successful deployment.
SNO Troubleshooting Guide
Comprehensive troubleshooting guide covering SSH timeouts, network issues, installation failures, and recovery procedures.
SNO Quick Fix - Missing Kernel
Step-by-step fix for the "kernel not found" PXE boot error, including manual file download and verification steps.
SNO Automation Fixes
Documentation of automation improvements including enhanced file downloads, verification tasks, and error handling.
📄 Additional Documentation
Agent-based Installer Guide
Install an HA OpenShift cluster using the OpenShift Agent-based installer (OCP 4.15+).
Assisted Installer Guide
Install OpenShift using Red Hat's Assisted Installer via Web UI or REST API.
vars.yaml Reference
Full documentation of all configuration variables in example-vars.yaml.
Day 2 Operations
Add worker nodes and perform post-installation customization tasks.