Before troubleshooting the installation environment, it is critical to understand the overall flow of the installer-provisioned installation on bare metal. The following diagrams illustrate a troubleshooting flow with a step-by-step breakdown for the environment.
Workflow 1 of 4 illustrates a troubleshooting workflow when the install-config.yaml file has errors or the {op-system-first} images are inaccessible. See Troubleshooting install-config.yaml for troubleshooting suggestions.
Workflow 2 of 4 illustrates a troubleshooting workflow for bootstrap VM issues, bootstrap VMs that cannot boot up the cluster nodes, and inspecting logs. When installing an {product-title} cluster without the provisioning network, this workflow does not apply.
Workflow 3 of 4 illustrates a troubleshooting workflow for cluster nodes that will not PXE boot. If installing using Redfish virtual media, each node must meet minimum firmware requirements for the installation program to deploy the node. See Firmware requirements for installing with virtual media in the Prerequisites section for additional details.
Workflow 4 of 4 illustrates a troubleshooting workflow from a non-accessible API to a validated installation.
modules/ipi-install-troubleshooting-install-config.adoc modules/ipi-install-troubleshooting-bootstrap-vm.adoc modules/ipi-install-troubleshooting-bootstrap-vm-cannot-boot.adoc modules/ipi-install-troubleshooting-bootstrap-vm-inspecting-logs.adoc modules/ipi-install-troubleshooting-investigating-an-unavailable-kubernetes-api.adoc modules/ipi-install-troubleshooting-troubleshooting-failure-to-initialize-the-cluster.adoc modules/ipi-install-troubleshooting-troubleshooting-failure-to-fetch-the-console-url.adoc modules/ipi-install-troubleshooting-troubleshooting-failure-to-add-the-ingress-certificate-to-kubeconfig.adoc modules/ipi-install-troubleshooting-troubleshooting-ssh-access-to-cluster-nodes.adoc modules/ipi-install-troubleshooting-cluster-nodes-will-not-pxe.adoc modules/ipi-install-troubleshooting-installing-creates-no-worker-nodes.adoc modules/ipi-install-troubleshooting-troubleshooting-the-cluster-network-operator.adoc modules/ipi-install-troubleshooting_unable-to-discover-new-bare-metal-hosts-using-the-bmc.adoc modules/ipi-install-troubleshooting_proc_worker-nodes-cannot-join-the-cluster.adoc modules/ipi-install-troubleshooting-cleaning-up-previous-installations.adoc modules/ipi-install-troubleshooting-registry-issues.adoc modules/ipi-install-troubleshooting-misc-issues.adoc modules/ipi-install-troubleshooting-failed-ignition-during-firstboot.adoc modules/ipi-install-troubleshooting-ntp-out-of-sync.adoc modules/ipi-install-troubleshooting-reviewing-the-installation.adoc