Added more deployment docs and images
- Converted boostrapping guide for mgmt switch and server
- Fixed broken links
- Renamed venv to match dash convention
Change-Id: I1fcc96e988ba9c67ea3f69b7f447d96379bb9385
diff --git a/pronto_deployment_guide/troubleshooting.rst b/pronto_deployment_guide/troubleshooting.rst
index 192226c..b45c76f 100644
--- a/pronto_deployment_guide/troubleshooting.rst
+++ b/pronto_deployment_guide/troubleshooting.rst
@@ -53,6 +53,32 @@
Problems with OS installation
-----------------------------
+iPXE doesn't load a Menu when started
+"""""""""""""""""""""""""""""""""""""
+
+The URLs that iPXE provides if there is an error take you into it's
+documentation, which is of high quality and should explain the error in much
+greater detail - for example `https://ipxe.org/3e11623b
+<https://ipxe.org/3e11623b>`_ explains that the DNS server address provided by
+DHCP is not functional.
+
+The most common failures would be in network settings being incorrect, which
+should be shown when the menu loads in step 4. If the menu does not load, and
+you get an `iPXE>` Shell prompt, type::
+
+ config
+
+And you should get the iPXE configuration screen, which lists all of the
+configuration parameters discovered:
+
+ .. image:: images/mgmtsrv-007.png
+ :alt: iPXE config menu
+ :scale: 50%
+
+Most likely there's something wrong with the network configuration provided by
+DHCP - you can scroll this menu with arrow keys to find all the settings
+provided by the DHCP server, and SMBIOS information provided by the hardware.
+
OS installs, but doesn't boot
"""""""""""""""""""""""""""""
@@ -61,8 +87,8 @@
- If the startup disk is nVME, under ``Advanced -> PCIe/PCI/PnP Configuration``
the option ``NVMe Firmware Source`` should be set to ``AMI Native Support``,
- per `this Supermicro FAQ entry
- <https://supermicro.com/support/faqs/faq.cfm?faq=28248>`_.
+ per `Supermicro FAQ entry 28248
+ <https://www.supermicro.com/support/faqs/faq.cfm?faq=28248>`_.
Unknown MAC addresses
---------------------