Skip to main content

Imaging - Debug

1. Boot Recovery

Set tftp to verbose mode:
In /etc/default/tftpd-hpa, add -v to the TFTP_OPTIONS parameter and restart the tftpd-hpa service
In the tftp logs (/var/log/syslog or journalctl --unit tftpd-hpa --follow), look for these lines:
in.tftpd[491332]: RRQ from 10.104.108.113 filename bootloader-uefi64/ipxe.efi
in.tftpd[491333]: RRQ from 10.104.108.113 filename bootloader-uefi64/autoexec.ipxe
If these lines do not exist, it is a DHCP issue

To debug TFTP, capture the frames:
tcpdump -s 0 host <CLIENT_IP> and udp
To test a TFTP connection: 
tftp <SERVER_IP> get bootloader-uefi64/ipxe.efi

2. Retrieving the boot menu
In the Apache logs, locate this line:
"GET /mmc/imaging/bootmenu.php?mac=54:bf:64:5c:77:25&uuid=4c4c4544-0057-3210-8053-c4c04f4b5132&srv=10.104.1.20 HTTP/1.1" 200 3717 "-" "iPXE/1.21.1+ (gdd35
)"
If it does not exist, there is an access issue with the Apache server

3. Davos Recovery
In the Apache logs, look for these lines:
"GET /downloads/davos/ipxe.png HTTP/1.1" 404 489 "-" "iPXE/1.21.1+ (gdd35)"
"GET /downloads/davos/vmlinuz HTTP/1.1" 200 15403668 "-" "iPXE/1.21.1+ (gdd35)"
"GET /downloads/davos/initrd.img HTTP/1.1" 200 64921280 "-" "iPXE/1.21.1+ (gdd35)"
"GET /downloads/davos/fs.squashfs HTTP/1.1" 200 1041178859 "-" "Wget"
If they do not exist, this is an access issue with the Apache server


Once these steps have been verified, refer to "Debugging Davos"
If you cannot find the save option when you reach the PXE menu, check the following lines in the tftpd-hpa logs:
In the tftp logs (/var/log/syslog or journalctl --unit tftpd-hpa --follow), look for these lines:
in.tftpd[357001]: tftp: client does not accept options

If this line appears, restart your tftpd-hpa service

systemctl restart tftpd-hpa

If the problem persists, check for a phantom tftpd-hpa service and restart your server. Then restart the tftpd-hpa service again.

Back to top