# 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.

​


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.2pintsoftware.com/ipxe-ws/3.6/operations/troubleshooting/step-by-step.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.