iPXE Anywhere Web Service Boot Failure | 2pint Knowledge Base

iPXE Anywhere Web Service Boot Failure

Applies to:-

iPXE Anywhere Web Service 2.5

Symptoms

PXE boot completes

iPXE Anywhere splash screen appears and hands off to the Web Service

Log entries:-

iPXE web Service enabled, sending request to: http://localhost:8051

Sent client off to iPXE Web Service, nice knowing yah!

Process fails on screen with “Operating System no found”

Cause

  1. The client boots to the 2PXE picks up the request without issue.
  2. The 2PXE software has been configured to route requests to the iPXE Anywhere Web Service during the boot process.
  3. The iPXE Anywhere Service has been enabled through the 2Pint.2PXE.Service.exe.config file in which the value of: “EnableiPXEAnywhereWebService” and  "iPXEAnywhereWebServiceURI" have been configured for use.
  4. The iPXE Network Boot Program is trying to resolve the URI (to dowload the REQUESTACTIONSCRIPT.ps1) value http://localhost:8051/iPXEAnywhereReques....
  5. This is failing as URL “localhost” cannot be resolved by the client

Solution

Configure the URI in accordance with the instructions in the iPXE Anywhere Web Service User Manual, in particular:- “but be sure to enter the FQDN of the server”. This will enable the client to resolve the iPXE Anywhere Web Service server and work some magic. You can also use the server IP address.

NOTE: This will be improved in future releases to improve checking and error reporting.

Using the iPXE Anywhere Web Service

The iPXE Anywhere Service is configured via the 2PXE Server Configuration File – which is covered in full in the 2PXE Server Manual document.

There are 2 settings to consider within the 2PXE Configuration file –

<add key="EnableiPXEAnywhereWebService" value="1"/> This is set to 0 by default so ensure that this is set to the required value (below)

0 = Off (Default setting) – use if the iPXE Anywhere Web Service is not installed, or to temporarily disable interaction with the iPXE Anywhere Service

1 = Reporting only – Client systems will report their status to the iPXE Anywhere Web Service throughout the boot process, logging any success/error along the way.

2 = Reporting + Request - Client systems will report their status to the iPXE Anywhere Web Service, and all boot requests will be routed to the iPXE Anywhere Web Service in order to perform any custom actions.

<add key="iPXEAnywhereWebServiceURI" value="http://myserver.mydomain.local:8051"/>

Pretty simple – but be sure to enter the FQDN of the server and Port number that you chose when you installed the iPXE Anywhere Web Service correctly.

IMPORTANT: After setting the above parameters, you will then need to restart the 2PXE service.