Jump To Close Expand all Collapse all Table of contents Installing OpenShift Container Platform with the Assisted Installer Preface 1. Installing an on-premise cluster using the Assisted Installer Expand section "1. Installing an on-premise cluster using the Assisted Installer" Collapse section "1. Installing an on-premise cluster using the Assisted Installer" 1.1. Using the Assisted Installer 1.2. API support for the Assisted Installer 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. Configuring 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 4.6. Modifying a cluster 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. Optional: Installing and modifying Operators Expand section "6. Optional: Installing and modifying Operators" Collapse section "6. Optional: Installing and modifying Operators" 6.1. Installing OpenShift Virtualization 6.2. Installing the MCE operator 6.3. Installing OpenShift Data Foundation 6.4. Installing Logical Volume Manager Storage (LVM Storage) 6.5. Modifying Operators 7. Configuring the discovery image Expand section "7. Configuring the discovery image" Collapse section "7. Configuring the discovery image" 7.1. Creating an Ignition configuration file 7.2. Modifying the discovery image with Ignition 8. Booting hosts with the discovery image Expand section "8. Booting hosts with the discovery image" Collapse section "8. Booting hosts with the discovery image" 8.1. Creating an ISO image on a USB drive 8.2. Booting with a USB drive 8.3. Booting from an HTTP-hosted ISO image using the Redfish API 8.4. Booting hosts using iPXE 9. Assigning roles to hosts Expand section "9. Assigning roles to hosts" Collapse section "9. Assigning roles to hosts" 9.1. Selecting a role by using the UI 9.2. Selecting a role by by using the API 9.3. Auto-assigning roles 9.4. Additional resources 10. Preinstallation validations Expand section "10. Preinstallation validations" Collapse section "10. Preinstallation validations" 10.1. Definition of preinstallation validations 10.2. Blocking and non-blocking validations 10.3. Validation types 10.4. Host validations Expand section "10.4. Host validations" Collapse section "10.4. Host validations" 10.4.1. Getting host validations by using the REST API 10.4.2. Host validations in detail 10.5. Cluster validations Expand section "10.5. Cluster validations" Collapse section "10.5. Cluster validations" 10.5.1. Getting cluster validations by using the REST API 10.5.2. Cluster validations in detail 11. Network configuration Expand section "11. Network configuration" Collapse section "11. Network configuration" 11.1. Cluster networking Expand section "11.1. Cluster networking" Collapse section "11.1. Cluster networking" 11.1.1. Limitations Expand section "11.1.1. Limitations" Collapse section "11.1.1. Limitations" 11.1.1.1. SDN 11.1.1.2. OVN-Kubernetes 11.1.2. Cluster network 11.1.3. Machine network 11.1.4. SNO compared to multi-node cluster 11.1.5. Air-gapped environments 11.2. VIP DHCP allocation Expand section "11.2. VIP DHCP allocation" Collapse section "11.2. VIP DHCP allocation" 11.2.1. Example payload to enable autoallocation 11.2.2. Example payload to disable autoallocation 11.3. Additional resources 11.4. Understanding differences between user- and cluster-managed networking Expand section "11.4. Understanding differences between user- and cluster-managed networking" Collapse section "11.4. Understanding differences between user- and cluster-managed networking" 11.4.1. Validations 11.5. Static network configuration Expand section "11.5. Static network configuration" Collapse section "11.5. Static network configuration" 11.5.1. Prerequisites 11.5.2. NMState configuration Expand section "11.5.2. NMState configuration" Collapse section "11.5.2. NMState configuration" 11.5.2.1. Example of NMState configuration 11.5.3. MAC interface mapping Expand section "11.5.3. MAC interface mapping" Collapse section "11.5.3. MAC interface mapping" 11.5.3.1. Example of MAC interface mapping 11.5.4. Additional NMState configuration examples Expand section "11.5.4. Additional NMState configuration examples" Collapse section "11.5.4. Additional NMState configuration examples" 11.5.4.1. Tagged VLAN 11.5.4.2. Network bond 11.6. Applying a static network configuration with the API 11.7. Additional resources 11.8. Converting to dual-stack networking Expand section "11.8. Converting to dual-stack networking" Collapse section "11.8. Converting to dual-stack networking" 11.8.1. Prerequisites 11.8.2. Example payload for Single Node OpenShift 11.8.3. Example payload for an OpenShift Container Platform cluster consisting of many nodes 11.8.4. Limitations 11.9. Additional resources 12. Expanding the cluster Expand section "12. Expanding the cluster" Collapse section "12. Expanding the cluster" 12.1. Prerequisites 12.2. Checking for multiple architectures 12.3. Adding hosts with the UI 12.4. Adding hosts with the API 12.5. Installing a mixed-architecture cluster 12.6. Installing a primary control plane node on a healthy cluster 12.7. Installing a primary control plane node on an unhealthy cluster 12.8. Additional resources 13. Optional: Installing on Nutanix Expand section "13. Optional: Installing on Nutanix" Collapse section "13. Optional: Installing on Nutanix" 13.1. Adding hosts on Nutanix with the UI 13.2. Adding hosts on Nutanix with the API 13.3. Nutanix postinstallation configuration Expand section "13.3. Nutanix postinstallation configuration" Collapse section "13.3. Nutanix postinstallation configuration" 13.3.1. Updating the Nutanix configuration settings 13.3.2. Creating the Nutanix CSI Operator group 13.3.3. Installing the Nutanix CSI Operator 13.3.4. Deploying the Nutanix CSI storage driver 13.3.5. Validating the postinstallation configurations 14. Optional: Installing on vSphere Expand section "14. Optional: Installing on vSphere" Collapse section "14. Optional: Installing on vSphere" 14.1. Adding hosts on vSphere 14.2. vSphere postinstallation configuration using the CLI 14.3. vSphere postinstallation configuration using the UI 15. Optional: Installing on Oracle Cloud Infrastructure (OCI) Expand section "15. Optional: Installing on Oracle Cloud Infrastructure (OCI)" Collapse section "15. Optional: Installing on Oracle Cloud Infrastructure (OCI)" 15.1. Generating an OCI-compatible discovery ISO image 15.2. Assigning node roles and custom manifests 16. Troubleshooting Expand section "16. Troubleshooting" Collapse section "16. Troubleshooting" 16.1. Troubleshooting discovery ISO issues Expand section "16.1. Troubleshooting discovery ISO issues" Collapse section "16.1. Troubleshooting discovery ISO issues" 16.1.1. Minimal ISO Image Expand section "16.1.1. Minimal ISO Image" Collapse section "16.1.1. Minimal ISO Image" 16.1.1.1. Troubleshooting minimal ISO boot failures 16.1.2. Verify the discovery agent is running 16.1.3. Verify the agent can access the assisted-service 16.2. Correcting a host’s boot order 16.3. Rectifying partially-successful installations 16.4. 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