Skip to content

Commit

Permalink
OpenNetworkBoot: Add additional information on debugging network issues
Browse files Browse the repository at this point in the history
  • Loading branch information
mikebeaton committed Nov 9, 2024
1 parent 7819fb2 commit 0ea9019
Showing 1 changed file with 11 additions and 0 deletions.
11 changes: 11 additions & 0 deletions Platform/OpenNetworkBoot/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,17 @@ or that a file does not exist at the specified URI on the server, or that the ce
(if any) stored in NVRAM could not be used to validate an `https://` URI, or any one of a number
of other similar problems.

> **Note 5**: During HTTP Boot, an initial error such as 'IP address not found' or 'Server response timeout',
even if preceded by the above message, may mean that no IP address was issued by DHCP, or
that the additional NBP (i.e. boot file) info requested over DHCP was not found. Using `dnsmasq` as the DHCP helper
with the logging options shown below can be helpful to resolve this: any DHCP request which reaches `dnsmasq`
will show a couple of log lines. If these are not seen during a network boot attempt then there is no chance of
`dnsmasq` responding, and network connectivity issues need to be resolved. (It is worth noting that unless blocked,
this DHCP request traffic will normally be broadcast between local networks.) If these log lines are seen but `dnsmasq` does not
additionally log that it is responding with NBP information, make sure that it is configured with the correct
subnetwork for the client machine. It can help to boot the client computer into an OS to confirm which subnetwork
it is on.

## Identifying missing network boot drivers

The `dh` command in UEFI Shell (e.g. `OpenShell` provided with
Expand Down

0 comments on commit 0ea9019

Please sign in to comment.