Jump To Close Expand all Collapse all Table of contents Installing OpenShift Container Platform with the Assisted Installer Preface 1. About the Assisted Installer Expand section "1. About the Assisted Installer" Collapse section "1. About the Assisted Installer" 1.1. Features 1.2. API support policy 2. Preparing to install with the Assisted Installer Expand section "2. Preparing to install with the Assisted Installer" Collapse section "2. Preparing to install with the Assisted Installer" 2.1. Prerequisites 2.2. Assisted Installer prerequisites Expand section "2.2. Assisted Installer prerequisites" Collapse section "2.2. Assisted Installer prerequisites" 2.2.1. CPU architectures 2.2.2. Hardware 2.2.3. Networking 2.2.4. Example DNS configuration Expand section "2.2.4. Example DNS configuration" Collapse section "2.2.4. Example DNS configuration" 2.2.4.1. Example DNS A record configuration 2.2.4.2. Example DNS PTR record configuration 2.2.5. Preflight validations 3. Installing with the Assisted Installer UI Expand section "3. Installing with the Assisted Installer UI" Collapse section "3. Installing with the Assisted Installer UI" 3.1. Preinstallation considerations 3.2. Setting the cluster details 3.3. Optional: Configuring static networks 3.4. Optional: Installing Operators 3.5. Adding hosts to the cluster 3.6. Configuring hosts 3.7. Configuring storage disks 3.8. Configuring networking 3.9. Adding custom manifests 3.10. Preinstallation validations 3.11. Installing the cluster 3.12. Completing the installation 4. Installing with the Assisted Installer API Expand section "4. Installing with the Assisted Installer API" Collapse section "4. Installing with the Assisted Installer API" 4.1. Generating the offline token 4.2. Authenticating with the REST API 4.3. Configuring the pull secret 4.4. Optional: Generating the SSH public key 4.5. Registering a new cluster Expand section "4.5. Registering a new cluster" Collapse section "4.5. Registering a new cluster" 4.5.1. Optional: Installing Operators 4.6. Modifying a cluster Expand section "4.6. Modifying a cluster" Collapse section "4.6. Modifying a cluster" 4.6.1. Modifying Operators 4.7. Registering a new infrastructure environment 4.8. Modifying an infrastructure environment Expand section "4.8. Modifying an infrastructure environment" Collapse section "4.8. Modifying an infrastructure environment" 4.8.1. Optional: Adding kernel arguments 4.9. Adding hosts 4.10. Modifying hosts Expand section "4.10. Modifying hosts" Collapse section "4.10. Modifying hosts" 4.10.1. Modifying storage disk configuration 4.11. Adding custom manifests 4.12. Preinstallation validations 4.13. Installing the cluster 5. Optional: Enabling disk encryption Expand section "5. Optional: Enabling disk encryption" Collapse section "5. Optional: Enabling disk encryption" 5.1. Enabling TPM v2 encryption 5.2. Enabling Tang encryption 5.3. Additional resources 6. Configuring the discovery image Expand section "6. Configuring the discovery image" Collapse section "6. Configuring the discovery image" 6.1. Creating an Ignition configuration file 6.2. Modifying the discovery image with Ignition 7. Booting hosts with the discovery image Expand section "7. Booting hosts with the discovery image" Collapse section "7. Booting hosts with the discovery image" 7.1. Creating an ISO image on a USB drive 7.2. Booting with a USB drive 7.3. Booting from an HTTP-hosted ISO image using the Redfish API 7.4. Booting hosts using iPXE 8. Assigning roles to hosts Expand section "8. Assigning roles to hosts" Collapse section "8. Assigning roles to hosts" 8.1. Selecting a role by using the UI 8.2. Selecting a role by by using the API 8.3. Auto-assigning roles 8.4. Additional resources 9. Preinstallation validations Expand section "9. Preinstallation validations" Collapse section "9. Preinstallation validations" 9.1. Definition of preinstallation validations 9.2. Blocking and non-blocking validations 9.3. Validation types 9.4. Host validations Expand section "9.4. Host validations" Collapse section "9.4. Host validations" 9.4.1. Getting host validations by using the REST API 9.4.2. Host validations in detail 9.5. Cluster validations Expand section "9.5. Cluster validations" Collapse section "9.5. Cluster validations" 9.5.1. Getting cluster validations by using the REST API 9.5.2. Cluster validations in detail 10. Network configuration Expand section "10. Network configuration" Collapse section "10. Network configuration" 10.1. Cluster networking Expand section "10.1. Cluster networking" Collapse section "10.1. Cluster networking" 10.1.1. Limitations Expand section "10.1.1. Limitations" Collapse section "10.1.1. Limitations" 10.1.1.1. SDN 10.1.1.2. OVN-Kubernetes 10.1.2. Cluster network 10.1.3. Machine network 10.1.4. SNO compared to multi-node cluster 10.1.5. Air-gapped environments 10.2. VIP DHCP allocation Expand section "10.2. VIP DHCP allocation" Collapse section "10.2. VIP DHCP allocation" 10.2.1. Example payload to enable autoallocation 10.2.2. Example payload to disable autoallocation 10.3. Additional resources 10.4. Understanding differences between user- and cluster-managed networking Expand section "10.4. Understanding differences between user- and cluster-managed networking" Collapse section "10.4. Understanding differences between user- and cluster-managed networking" 10.4.1. Validations 10.5. Static network configuration Expand section "10.5. Static network configuration" Collapse section "10.5. Static network configuration" 10.5.1. Prerequisites 10.5.2. NMState configuration Expand section "10.5.2. NMState configuration" Collapse section "10.5.2. NMState configuration" 10.5.2.1. Example of NMState configuration 10.5.3. MAC interface mapping Expand section "10.5.3. MAC interface mapping" Collapse section "10.5.3. MAC interface mapping" 10.5.3.1. Example of MAC interface mapping 10.5.4. Additional NMState configuration examples Expand section "10.5.4. Additional NMState configuration examples" Collapse section "10.5.4. Additional NMState configuration examples" 10.5.4.1. Tagged VLAN 10.5.4.2. Network bond 10.6. Applying a static network configuration with the API 10.7. Additional resources 10.8. Converting to dual-stack networking Expand section "10.8. Converting to dual-stack networking" Collapse section "10.8. Converting to dual-stack networking" 10.8.1. Prerequisites 10.8.2. Example payload for Single Node OpenShift 10.8.3. Example payload for an OpenShift Container Platform cluster consisting of many nodes 10.8.4. Limitations 10.9. Additional resources 11. Expanding the cluster Expand section "11. Expanding the cluster" Collapse section "11. Expanding the cluster" 11.1. Prerequisites 11.2. Checking for multiple architectures 11.3. Adding hosts with the UI 11.4. Adding hosts with the API 11.5. Installing a mixed-architecture cluster 11.6. Installing a primary control plane node on a healthy cluster 11.7. Installing a primary control plane node on an unhealthy cluster 11.8. Additional resources 12. Optional: Installing on Nutanix Expand section "12. Optional: Installing on Nutanix" Collapse section "12. Optional: Installing on Nutanix" 12.1. Adding hosts on Nutanix with the UI 12.2. Adding hosts on Nutanix with the API 12.3. Nutanix postinstallation configuration Expand section "12.3. Nutanix postinstallation configuration" Collapse section "12.3. Nutanix postinstallation configuration" 12.3.1. Updating the Nutanix configuration settings 12.3.2. Creating the Nutanix CSI Operator group 12.3.3. Installing the Nutanix CSI Operator 12.3.4. Deploying the Nutanix CSI storage driver 12.3.5. Validating the postinstallation configurations 13. Optional: Installing on vSphere Expand section "13. Optional: Installing on vSphere" Collapse section "13. Optional: Installing on vSphere" 13.1. Adding hosts on vSphere 13.2. vSphere postinstallation configuration using the CLI 13.3. vSphere postinstallation configuration using the UI 14. Optional: Installing on Oracle Cloud Infrastructure (OCI) Expand section "14. Optional: Installing on Oracle Cloud Infrastructure (OCI)" Collapse section "14. Optional: Installing on Oracle Cloud Infrastructure (OCI)" 14.1. Generating an OCI-compatible discovery ISO image 14.2. Assigning node roles and custom manifests 15. Troubleshooting Expand section "15. Troubleshooting" Collapse section "15. Troubleshooting" 15.1. Troubleshooting discovery ISO issues Expand section "15.1. Troubleshooting discovery ISO issues" Collapse section "15.1. Troubleshooting discovery ISO issues" 15.1.1. Verify the discovery agent is running 15.1.2. Verify the agent can access the assisted-service 15.2. Troubleshooting minimal discovery ISO issues Expand section "15.2. Troubleshooting minimal discovery ISO issues" Collapse section "15.2. Troubleshooting minimal discovery ISO issues" 15.2.1. Troubleshooting minimal ISO boot failure by interrupting the boot process 15.3. Correcting a host’s boot order 15.4. Rectifying partially-successful installations 15.5. API connectivity failure when adding nodes to a cluster Legal Notice Settings Close Language: 日本語 简体中文 한국어 English Language: 日本語 简体中文 한국어 English Format: Multi-page Single-page PDF Format: Multi-page Single-page PDF Language and Page Formatting Options Language: 日本語 简体中文 한국어 English Language: 日本語 简体中文 한국어 English Format: Multi-page Single-page PDF Format: Multi-page Single-page PDF Installing OpenShift Container Platform with the Assisted Installer Assisted Installer for OpenShift Container Platform 2024User GuideRed Hat Customer Content ServicesLegal NoticeAbstract Information about the Assisted Installer and its usage Next