TFTP files are missing in '/var/lib/tftpboot/pxelinux.cfg' while provisioning through Red Hat Satellite 6.

Solution Verified - Updated -

Environment

  • Red Hat Satellite 6+

Issue

  • Unable to locate configuration file error on host provision from Satellite.
    In the provisioned Host:
   TFTP prefix :
    Unable to locate configuration file
    Boot failed: press a key to retry, or wait for reset...
  • TFTP files are missing in /var/lib/tftpboot/pxelinux.cfg.
  • TFTP default menu is missing from /var/lib/tftpboot/pxelinux.cfg.

Resolution

  • Make sure the TFTP feature is enabled. If not, run the below command to enable the feature.
# satellite-installer --scenario satellite --foreman-proxy-tftp true --foreman-proxy-tftp-servername $(hostname)
  • Associate the exact TFTP Capsule server with the Subnet.
WebUI --> Infrastructure --> subnets --> <select subnet> --> Capsule tab --> TFTP Capsule <Satellite / Capsule>
  • Ensure Managed is enable while the interface is configured for the host.
  • Make sure the TFTP settings are proper on the Satellite/Capsule server.
# cat /etc/foreman-proxy/settings.d/tftp.yml
---
# TFTP management
:enabled: https
:tftproot: /var/lib/tftpboot
# Defines the TFTP Servername to use, overrides the name in the subnet declaration
:tftp_servername: satellite.example.com
  • For discovery PXE provisioning apart from the above checks make sure the PXE default menu is present inside /var/lib/tftpboot/pxelinux.cfg.
# ls -ltr /var/lib/tftpboot/pxelinux.cfg/
-rw-r--r--. 1 foreman-proxy foreman-proxy  666 May 27 16:34 aa-bb-cc-dd-ee-ff-gg
-rw-r--r--. 1 foreman-proxy foreman-proxy 1088 Jun  8 16:36 default   ----> This is required for discovery PXE.
  • To get the default menu follow the below step.
Hosts --> Provisioning Templates --> Click on 'Build PXE Default'

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

Diagnostic Steps

  • Check whether the TFTP file is created once the host is created.
# ls /var/lib/tftpboot/pxelinux.cfg
aa-bb-cc-dd-ee-ff-gg
  • Verify whether PXE dafult menu is present inside /var/lib/tftpboot/pxelinux.cfg.

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.

Comments