Step-by-Step

If an issue arises, follow the steps below to gather information. This information can be provided to 2Pint Support.

  1. Note the make, model and possibly the firmware version.

  2. Note the iPXE binary being used, such as snponly_x64.efi.

  3. Note the actual version of 2PXE server being used.

  4. As the machine boots the iPXE binary, press the 'C' key on the keyboard multiple times to get to the iPXE console.

  5. Run 'ifstat' and record the output (mobile phone camera picture is fine).

  6. Run 'ifconf' and record the output.

  7. Run 'route' command to show the default gateway IP used.

  8. Run the command 'ping <IP>' where IP <IP> is replaced with the default gateway shown in step #7.

  9. Record the output.

  10. If ping succeeds, press Ctrl + C to break the ping command

  11. Disable BranchCache with the 'set peerdist 0' command

  12. Try loading a small file from an http path using the command 'initrd http://server/somesmallfile.bin' and see if it works. IISStart.png is a prime target here to download. Typically its always around on any IIS server via http://server/iisstart.png.

  13. If it does not work or hang, record any error codes and also run 'ifstat' to get the output and record the output.

  14. Try loading a larger file from an http path using the command 'initrd http://server/somesmallfile.bin' and see if it works. Ensure you can download the file from a Windows machine as well before trying iPXE.

  15. If it does not work, get the error code and run 'ifstat' and record the output.

  16. If all above fails, try running the following in sequence and retry:

    'ifclose'

    'ifopen'

    'dhcp' Then retry from step #12 if possible.

  17. If all above works, move on and try https using an URL with https.

  18. If all above works, move on and re-enable BranchCache with 'set peerdist 1' and retry from step #12.

Last updated