|
| 1 | +// Module included in the following assemblies: |
| 2 | +// |
| 3 | +// * installing/installing_bare_metal/ipi/ipi-install-prerequisites.adoc |
| 4 | + |
| 5 | +:_mod-docs-content-type: REFERENCE |
| 6 | + |
| 7 | +[id="installation-overview_{context}"] |
| 8 | += Installation overview |
| 9 | + |
| 10 | +The installation program supports interactive mode, but Red{nbsp}Hat recommends preparing an `install-config.yaml` file in advance, containing the provisioning details for all of the bare-metal hosts, and the relevant cluster details. |
| 11 | + |
| 12 | +The installation program loads the `install-config.yaml` file, while the administrator generates the manifests and verifies all prerequisites. |
| 13 | + |
| 14 | +The installation program enrolls all nodes in the cluster and starts the bootstrap VM. The installation program starts the metal platform components as `systemd` services, which have the following containers: |
| 15 | + |
| 16 | +* Ironic-dnsmasq: The DHCP server responsible for handing over the IP addresses to the provisioning interface of various nodes on the provisioning network. Ironic-dnsmasq is only enabled when you deploy an {product-title} cluster with a provisioning network. |
| 17 | +* Ironic-httpd: The HTTP server used to ship the images to the nodes. |
| 18 | +* Image-customization |
| 19 | +* Ironic |
| 20 | +* Ironic-inspector (available in {product-title} 4.16 and earlier) |
| 21 | +* Ironic-ramdisk-logs |
| 22 | +* Extract-machine-os |
| 23 | +* Provisioning-interface: The service that configures networking when the provisioning interface is enabled. |
| 24 | +* Metal3-baremetal-operator: The operator that provides a higher-level API for Ironic and replaces `terraform-provider-ironic` (available in {product-title} 4.16 and later) |
| 25 | + |
| 26 | +The nodes enter the validation phase, where each node moves to a “manageable” state after Ironic validates the credentials to access the Baseboard Management Controller (BMC). |
| 27 | + |
| 28 | +Once in the “manageable” state, the “inspection” phase starts. The "inspection" phase ensures that the hardware meets the minimum requirements needed for a successful deployment of {product-title}. |
| 29 | + |
| 30 | +The `install-config.yaml` file details the provisioning network. The installation program on the bootstrap VM will try to push a live image by using PXE to every node with the Ironic Python Agent (IPA) loaded. When using virtual media, it connects directly to each node's BMC to virtually attach the image. |
| 31 | + |
| 32 | +When using PXE boot, all nodes reboot to start the process: |
| 33 | + |
| 34 | +* The `ironic-dnsmasq` service running on the bootstrap VM provides the IP address of the node and the TFTP boot server. |
| 35 | +* The first-boot software loads the root file system over HTTP. |
| 36 | +* The `ironic` service on the bootstrap VM receives the hardware information from each node. |
| 37 | + |
| 38 | +The nodes then enter the “cleaning” state, where each node must clean all the disks before continuing with the configuration. |
| 39 | + |
| 40 | +Once the “cleaning” state finishes, the nodes enter the “available” state and the installation program moves the nodes to the “deploying” state. |
| 41 | + |
| 42 | +IPA runs the `coreos-installer` to install the {op-system-first} image on the disk defined by `rootDeviceHints` in the `install-config.yaml` file. The node boots by using {op-system}. |
| 43 | + |
| 44 | +Once the installation program configures the control plane nodes, it moves control from the bootstrap VM to the control plane nodes and deletes the bootstrap VM. |
| 45 | + |
| 46 | +The baremetal-operator continues the deployment of the workers, storage, and infra nodes. Once the installation completes, the nodes move to the "active" state. |
| 47 | + |
| 48 | +Once the installation program finishes installation, you can proceed with postinstallation configuration and other Day 2 tasks. |
0 commit comments