9.2. Troubleshooting Issues when Building Hosts

9.2.1. Reviewing Anaconda Logs

Host provisioning in a Red Hat Enterprise Linux OpenStack Platform environment uses Kickstart and anaconda to build the base operating system. This means the logs for the initial build are stored in /var/log/anaconda/ of each host. The log files in this directory show the host's entire build process and provide messages for any point of error. If a host fails to build, consult these log files to determine the causes of the failed build.

9.2.2. Checking Subscription Details and Installed Packages

Check if the host has successfully registered to the Red Hat Customer Portal and has the correct subscriptions attached:
# subscription-manager status
# subscription-manager list --consumed
# subscription-manager repos | grep "Enabled:.*1" -B3
Also check if the following packages were installed during the initial build process:
# yum list sos sos-plugins-openstack rhos-log-collector puppet rhel-osp-installer-client
If the hosts lacks the required subscription details or necessary packages after the build process completes, it means an error occurred when attempting to register your host and attach the relevant subscription pools. Check the build logs (see Section 9.1, “Defining the Provisioning Process”) or restart the build process for the host (see Section 9.2.4, “Rebuilding Hosts”) to see where the subscription management issues occur.

9.2.3. Editing Kickstart Templates

The Red Hat Enterprise Linux OpenStack Platform installer uses a set of Kickstart templates and snippets. These templates are located in HostsProvisioning Templates.
The default template used for provisioning hosts is the Kickstart RHEL default template.
The template follows standard Kickstart syntax. However, the template also allows certain variables including:
  • Host Parameters - These are custom values defined for each host and are inserted into the template using the following syntax:
    <% @host.params['time-zone'] %>
    
    A full list of parameters is available on each host's Parameters tab.
  • Template Snippets - Snippets are template segments used in multiple templates. Using snippets reduces the amount of replication across multiple provisioning templates. Insert snippets into a template using the following syntax:
    <%= snippet 'kickstart_networking_setup' %>
    
Editing the default kickstart template provides a means of customizing the build process to workaround any issues that appear in the anaconda logs of a faulty build.

Warning

The default Kickstart template and associated snippets are designed and tested to provide a working Red Hat Enterprise Linux OpenStack Platform environment. Only edit the default Kickstart template if your encounter an error in the build process and you feel comfortable with resolving the error yourself. Perform such edits with caution as faults in the Kickstart template can cause the provisioning process to stop functioning.
Contact your Red Hat Technical Support representative if you require help with diagnosing and resolving build errors in the provisioning process.

9.2.4. Rebuilding Hosts

In the event of a host fault, make any necessary adjustments to the Kickstart template and trigger a host rebuild.

Procedure 9.1. Triggering a Host Rebuild

  1. Navigate to HostsAll hosts.
  2. Click on the Name of the host to rebuild.
  3. Click the Build button. A message appears stating that the host will rebuild the next time it boots.
  4. Manually reboot your host and boot it through PXE.
The host runs through the build process again when it boots through PXE.