openstack/openstack-virtual-baremetal
Code Issues Proposed changes

Bold the troubleshooting titles

Browse Source 
I just like the way this looks better. :-)
This commit is contained in:
Ben Nemec 2016-06-03 16:31:35 -05:00
parent 543896bcd5
commit 390d10fce9
1 changed files with 15 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
troubleshooting.rst
View File

@ -6,11 +6,11 @@ OVB deployment, why they go wrong, and how to fix them.
---- ----
*Problem*: Nodes hang while downloading the deploy ramdisk or kernel. **Problem**: Nodes hang while downloading the deploy ramdisk or kernel.
*Cause*: Improper MTU settings on deployment interfaces. **Cause**: Improper MTU settings on deployment interfaces.
*Solution*: Set the MTU on the deployment interfaces to allow PXE booting to **Solution**: Set the MTU on the deployment interfaces to allow PXE booting to
work correctly. For TripleO-based deployments, see the readme work correctly. For TripleO-based deployments, see the readme
for details on how to do this. For others, make sure that the for details on how to do this. For others, make sure that the
deployment nic on the undercloud vm has the MTU set appropriately deployment nic on the undercloud vm has the MTU set appropriately
@ -20,25 +20,25 @@ physical MTU of the host cloud.
---- ----
*Problem*: Nodes are deployed, but cannot talk to each other. In OpenStack **Problem**: Nodes are deployed, but cannot talk to each other. In OpenStack
deployments, this often presents as rabbitmq connectivity issues deployments, this often presents as rabbitmq connectivity issues
from compute nodes. from compute nodes.
*Cause*: Improper MTU settings on deployed instances. **Cause**: Improper MTU settings on deployed instances.
*Solution*: Essentially the same as the previous problem. Ensure that the MTU **Solution**: Essentially the same as the previous problem. Ensure that the MTU
being used on the deployed instances is 50 bytes smaller than the being used on the deployed instances is 50 bytes smaller than the
physical MTU of the host cloud. Again, for TripleO-based physical MTU of the host cloud. Again, for TripleO-based
deployments the readme has details on how to do this. deployments the readme has details on how to do this.
---- ----
*Problem*: After deploying to an OVB environment once, the nodes refuse to PXE **Problem**: After deploying to an OVB environment once, the nodes refuse to PXE
boot on subsequent deployments. boot on subsequent deployments.
*Cause*: The nodes are not configured to PXE boot properly. **Cause**: The nodes are not configured to PXE boot properly.
*Solution*: This depends on the method being used to PXE boot. If the Nova **Solution**: This depends on the method being used to PXE boot. If the Nova
patch is being used to provide this functionality, then ensure patch is being used to provide this functionality, then ensure
that it has been applied on all compute nodes and those nodes' that it has been applied on all compute nodes and those nodes'
nova-compute service has been restarted. If the ipxe-boot image nova-compute service has been restarted. If the ipxe-boot image
@ -47,25 +47,25 @@ be rebuilt to the ipxe-boot image before subsequent deployments.
---- ----
*Problem*: Nodes fail to PXE boot. DHCP requests are seen on the undercloud **Problem**: Nodes fail to PXE boot. DHCP requests are seen on the undercloud
VM, but responses never get to the baremetal instances. VM, but responses never get to the baremetal instances.
*Cause*: Neutron port security blocking DHCP from the undercloud. **Cause**: Neutron port security blocking DHCP from the undercloud.
*Solution*: Neutron either needs to be configured to use the Noop firewall **Solution**: Neutron either needs to be configured to use the Noop firewall
driver, or the port-security extension must be used to disable driver, or the port-security extension must be used to disable
port-security on the appropriate ports. As of this writing that port-security on the appropriate ports. As of this writing that
requires use of the port-security branch of OVB. requires use of the port-security branch of OVB.
---- ----
*Problem*: The BMC does not respond to IPMI requests. **Problem**: The BMC does not respond to IPMI requests.
*Cause*: Several. Neutron may not be configured to allow the BMC to listen **Cause**: Several. Neutron may not be configured to allow the BMC to listen
on arbitrary addresses. The BMC deployment may have failed for some on arbitrary addresses. The BMC deployment may have failed for some
reason. reason.
*Solution*: Neutron must be configured to allow the BMC to listen on **Solution**: Neutron must be configured to allow the BMC to listen on
arbitrary addresses. This requires use of the Noop firewall driver arbitrary addresses. This requires use of the Noop firewall driver
or port-security extension as in the previous solution. If this or port-security extension as in the previous solution. If this
is already configured correctly, then the BMC may have failed to is already configured correctly, then the BMC may have failed to