Add examples of BIOS and BMC configuration

Signed-off-by: Todd Malsbary <todd.malsbary@intel.com>
Change-Id: I2faba20fb68cd4519adbbf109b185a4705209225

diff --git a/doc/installation-guide.md b/doc/installation-guide.md
index 3ef066e..d24f3ce 100644 (file)
--- a/doc/installation-guide.md
+++ b/doc/installation-guide.md
@@ -115,7 +115,8 @@ There is an additional network connected to a high-speed switch:
 #### Baseboard Management Controller (BMC) configuration
 
 The BMC IP address should be statically assigned using the machine's
 #### Baseboard Management Controller (BMC) configuration
 
 The BMC IP address should be statically assigned using the machine's

-BMC tool or application.
+BMC tool or application.  Configuration of the pod11-node3 machine is
+shown in [Appendix A](#bmc-configuration).

     
 To verify IPMI is configured correctly for each cluster machine, use
 ipmitool:
     
 To verify IPMI is configured correctly for each cluster machine, use
 ipmitool:


@@ -143,7 +144,8 @@ ipmitool](https://www.thomas-krenn.com/en/wiki/Configuring_IPMI_under_Linux_usin
 #### PXE Boot configuration
 
 Each cluster machine must be configured to PXE boot from the interface
 #### PXE Boot configuration
 
 Each cluster machine must be configured to PXE boot from the interface

-attached to the `provisioning` network.
+attached to the `provisioning` network.  Configuration of the
+pod11-node3 machine is shown in [Appendix A](#pxe-boot-configuration-1).

 
 One method of verifying PXE boot is configured correctly is to access
 the remote console of the machine and observe the boot process. If
 
 One method of verifying PXE boot is configured correctly is to access
 the remote console of the machine and observe the boot process. If


@@ -163,6 +165,12 @@ If tcpdump does not show any traffic, verify that the any switches are
 configured properly to forward PXE boot requests (i.e. VLAN
 configuration).
 
 configured properly to forward PXE boot requests (i.e. VLAN
 configuration).
 

+### Additional BIOS configuration
+
+Each cluster machine should also be configured to enable any desired
+features such as virtualization support.  Configuration of the
+pod11-node3 machine is shown in [Appendix
+A](#additional-bios-configuration-1).

 
 ## Jump server
 
 
 ## Jump server
 


@@ -780,4 +788,39 @@ examining the `BareMetalHost` resources, etc.
 
     root@pod11-node5:# kubectl -n flux-system delete Kustomization icn-master-site-pod11
 
 
     root@pod11-node5:# kubectl -n flux-system delete Kustomization icn-master-site-pod11
 

+## Appendix A: BMC and BIOS configuration of pod11-node3
+
+The BMC and BIOS configuration will vary depending on the vendor.  The
+below is intended only to provide some guidance on what to look for in
+the hardware used in the chosen configuration.
+
+### BMC configuration
+
+BMC IP address configured in the BIOS.
+
+![img](./pod11-node3-bios-bmc-configuration.png "BMC LAN Configuration")
+
+BMC IP address configured in the web console.
+
+![img](./pod11-node3-ip-configuration.png "BMC LAN Configuration")
+
+IPMI configuration.  Not shown is the cipher suite configuration.
+
+![img](./pod11-node3-ipmi-over-lan.png "IPMI over LAN")
+
+### PXE boot configuration
+
+The screens below show enabling PXE boot for the specified NIC and
+ensuring it is first in the boot order.
+
+![img](./pod11-node3-bios-enable-pxe.png "Enable PXE boot")
+
+![img](./pod11-node3-bios-nic-boot-order.png "NIC boot order")
+
+### Additional BIOS configuration
+
+The screens below show enabling virtualization options in the BIOS.
+
+![img](./pod11-node3-bios-vt-x.png "Enable Intel VT-x")

 
 

+![img](./pod11-node3-bios-vt-d.png "Enable Intel VT-d")

diff --git a/doc/pod11-node3-bios-bmc-configuration.png b/doc/pod11-node3-bios-bmc-configuration.png
new file mode 100644 (file)
index 0000000..19c2e4d
Binary files /dev/null and b/doc/pod11-node3-bios-bmc-configuration.png differ

diff --git a/doc/pod11-node3-bios-enable-pxe.png b/doc/pod11-node3-bios-enable-pxe.png
new file mode 100644 (file)
index 0000000..6a2d7ba
Binary files /dev/null and b/doc/pod11-node3-bios-enable-pxe.png differ

diff --git a/doc/pod11-node3-bios-nic-boot-order.png b/doc/pod11-node3-bios-nic-boot-order.png
new file mode 100644 (file)
index 0000000..55e86ce
Binary files /dev/null and b/doc/pod11-node3-bios-nic-boot-order.png differ

diff --git a/doc/pod11-node3-bios-vt-d.png b/doc/pod11-node3-bios-vt-d.png
new file mode 100644 (file)
index 0000000..2473a60
Binary files /dev/null and b/doc/pod11-node3-bios-vt-d.png differ

diff --git a/doc/pod11-node3-bios-vt-x.png b/doc/pod11-node3-bios-vt-x.png
new file mode 100644 (file)
index 0000000..7794117
Binary files /dev/null and b/doc/pod11-node3-bios-vt-x.png differ

diff --git a/doc/pod11-node3-ip-configuration.png b/doc/pod11-node3-ip-configuration.png
new file mode 100644 (file)
index 0000000..ff54ff3
Binary files /dev/null and b/doc/pod11-node3-ip-configuration.png differ

diff --git a/doc/pod11-node3-ipmi-over-lan.png b/doc/pod11-node3-ipmi-over-lan.png
new file mode 100644 (file)
index 0000000..d38558d
Binary files /dev/null and b/doc/pod11-node3-ipmi-over-lan.png differ