Provisioning a host using generic image fails with error Failed to chainload from any network interface in Red Hat Satellite 6

Environment

• Red Hat Satellite 6

Issue

• Failed to provision a host while booting via Generic Image where the host boots up with iPXE firmware but fails to chainload the iPXE script from Satellite server.

• iPXE firmware always queries to wrong satellite server for chainloading the next stage.

Content from old-satellite.example.com is not included.http://old-satellite.example.com/unattended/iPXE?&mac=00%3AXX%3AXX%3AXX%3AXX%3A

• Once chainloading completes the host is unable to fetch the kickstart and treeinfo file from Satellite server.

Resolution

• Ensure that following configuration\settings have been maintained in Satellite server:

  • The Kickstart default iPXE template should be associated with the requiredOperating System.
  • The DHCP server should be working properly and DNS server should be able to resolve the satellite server's FQDN with the correct IP address.
  • The host being provisioned should be having proper subnet assigned.

• If the generic image being used is old or belongs to another satellite server then regenerate a new image from the current satellite server, from where the provisioning is being attempted:

    # hammer bootdisk generic --file /tmp/bootdisk-generic-`uname -n`.iso
    Successfully downloaded generic disk image to /tmp/bootdisk-generic-new-satellite.example.com.iso
  
    # ls -lah /tmp/bootdisk-generic-new-satellite.example.com.iso
    -rw-r--r--. 1 root root 1.0M Mar 12 05:55 /tmp/bootdisk-generic-new-satellite.example.com.iso
  

• Copy this generic image to your base system or to the Compute resource directly and then attach this image to the host and re-attempt the provisioning.

• If RHEL 7 is being attempted to provision on a UEFI based system using the Provisioning with Generic Image method then refer this article to understand How to generate a UEFI compatible generic image ?.

• To understand more about how PXE-less provisioning works with Generic image, please refer to - Creating New Hosts with PXE-less Provisioning.

For more KB articles/solutions related to Red Hat Satellite 6.x Provisioning Issues, please refer to the Consolidated Troubleshooting Article for Red Hat Satellite 6.x Provisioning related Issues

Root Cause

• The iPXE template was not properly associated with the required Operating System.

• Generic image being used was having wrong information inside it i.e. Fully-qualified-domain-name of old satellite server.

• The host created on satellite server was not having proper subnet assigned.

Diagnostic Steps

• After booting from generic iso, open the console of that host and check if it's stuck at error displayed below.

Content from old-satellite.example.com is not included.http://old-satellite.example.com/unattended/iPXE?&mac=00%3AXX%3AXX%3AXX%3AXX%3A

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.