Merge pull request #57178 from johnwilkins/OCPBUGS-2630

OCPBUGS-2630: Unable to discover new BM hosts using BMC (Metal)

Author: stevsmit

installing/installing_bare_metal_ipi/ipi-install-prerequisites.adoc

@@ -32,6 +32,11 @@ include::modules/virt-planning-bare-metal-cluster-for-ocp-virt.adoc[leveloffset=
 
 include::modules/ipi-install-firmware-requirements-for-installing-with-virtual-media.adoc[leveloffset=+1]
 
+[role="_additional-resources"]
+.Additional resources
+
+xref:ipi-install-troubleshooting.adoc#unable-to-discover-new-bare-metal-hosts-using-the-bmc_ipi-install-troubleshooting[Unable to discover new bare metal hosts using the BMC]
+
 include::modules/ipi-install-network-requirements.adoc[leveloffset=+1]
 
 include::modules/ipi-install-configuring-nodes.adoc[leveloffset=+1]

installing/installing_bare_metal_ipi/ipi-install-troubleshooting.adoc

@@ -34,6 +34,7 @@ include::modules/ipi-install-troubleshooting-bootstrap-vm.adoc[leveloffset=+1]
 include::modules/ipi-install-troubleshooting-bootstrap-vm-cannot-boot.adoc[leveloffset=+2]
 include::modules/ipi-install-troubleshooting-bootstrap-vm-inspecting-logs.adoc[leveloffset=+2]
 include::modules/ipi-install-troubleshooting-cluster-nodes-will-not-pxe.adoc[leveloffset=+1]
+include::modules/ipi-install-troubleshooting_unable-to-discover-new-bare-metal-hosts-using-the-bmc.adoc[leveloffset=+1]
 include::modules/ipi-install-troubleshooting-api-not-accessible.adoc[leveloffset=+1]
 include::modules/ipi-install-troubleshooting-cleaning-up-previous-installations.adoc[leveloffset=+1]
 include::modules/ipi-install-troubleshooting-registry-issues.adoc[leveloffset=+1]

modules/ipi-install-troubleshooting_unable-to-discover-new-bare-metal-hosts-using-the-bmc.adoc

@@ -0,0 +1,42 @@
+// This module is included in the following assemblies: 
+//
+// installing/installing_bare_metal_ipi/ipi-install-troubleshooting.adoc
+
+:_content-type: PROC
+[id="unable-to-discover-new-bare-metal-hosts-using-the-bmc_{context}"]
+= Unable to discover new bare metal hosts using the BMC
+
+In some cases, the installation program will not be able to discover the new bare metal hosts and issue an error, because it cannot mount the remote virtual media share. 
+
+For example: 
+
+[source,terminal]
+----
+ProvisioningError 51s metal3-baremetal-controller Image provisioning failed: Deploy step deploy.deploy failed with BadRequestError: HTTP POST 
+https://<bmc_address>/redfish/v1/Managers/iDRAC.Embedded.1/VirtualMedia/CD/Actions/VirtualMedia.InsertMedia 
+returned code 400. 
+Base.1.8.GeneralError: A general error has occurred. See ExtendedInfo for more information 
+Extended information: [
+  {
+    "Message": "Unable to mount remote share https://<ironic_address>/redfish/boot-<uuid>.iso.",
+    "MessageArgs": [
+      "https://<ironic_address>/redfish/boot-<uuid>.iso"
+    ],
+    "[email protected]": 1,
+    "MessageId": "IDRAC.2.5.RAC0720",
+    "RelatedProperties": [
+      "#/Image"
+    ],
+    "[email protected]": 1,
+    "Resolution": "Retry the operation.",
+    "Severity": "Informational"
+  }
+].
+----
+
+In this situation, if you are using virtual media with an unknown certificate authority, you can configure your baseboard management controller (BMC) remote file share settings to trust an unknown certificate authority to avoid this error.
+
+[NOTE]
+====
+This resolution was tested on {product-title} 4.11 with Dell iDRAC 9 and firmware version 5.10.50. 
+====