PXE Boot troubleshooting guide

Vorbereitungen für einen PXE-Boot

Ist auf Ihrem Client PXE-Boot eingestellt und steht dieser in der Bootreihenfolge auch an vorderer Stelle?

Richten Sie Ihr BIOS entsprechend ein. Achten Sie darauf, dass als "First Boot Device" "Network" oder ähnlich lautend ausgewählt ist. Bei manchen System wird dieser Eintrag auch durch den Namen der Netzwerkkarte wiedergegeben z.B. "Intel onboard NIC" oder "Realtek D3400", oder die Schnittstelle z.B. "IBA CL Slot".

Bitte schalten Sie "Quiet Boot" oder ähnlich lautende Schalter und sämtliche Splashscreens des Mainboards im BIOS aus. Für die Fehlersuche sollte der zu startende Rechner so "gesprächig" wie möglich sein.

Es bootet nicht, oder der Bildschirm bleibt dunkel.

Sollte der PXE-Boot-Request scheitern, sieht das so (oder ähnlich) aus.

Fehler z.B. PXE-M0F

Bitte kontrollieren Sie die folgende Dinge und arbeiten Sie alle folgenden Punkte ab:

Besitzt der zu startende Rechner mehrere Netzwerkkarten?

Auf Systemen mit mehrere Netzwerkkarten ist oft nur eine Karte PXE-Boot-fähig. Bitte probieren Sie alle Netzwerkkarten.

PXE-E53 no boot filename received

Sollten Sie openthinclient unter Windows installiert haben, deaktivieren Sie die Windows-Firewall.

PXE-E16 no offer received

Bitte überprüfen Sie im Bios, ob die Netzwerkkarte auf IPv4 gestellt ist.

PXE-E32 TFTP open timeout

Versuchen Sie entweder eine andere Boot-Methode im BIOS/UEFI des ThinClients einzustellen oder einen anderen Bootloader im zugeordneten Hardwaretypen zu verwenden:

Startoption → Bootmethode → Sicher

Sind Server und Client wirklich im gleichen Subnetz aktiv?

Wenn nicht, dann müssen Sie im Subnetz in dem sich der Client befindet einen DHCP-Server vorhalten, der die passenden DHCP-Optionen 66 und 67 sowie ein Standardgateway mitgibt. Bitte stellen Sie in diesem Fall den PXE-Proxy-Dienst auf den Wert "single-homed-broadcast" ein.
Oder Sie konfigurieren auf Ihrem Router (Netzgrenze) einen IP-Helper. Bitte stellen Sie in diesem Fall den PXE-Proxy-Dienst auf den Wert "single-homed-broadcast" ein.

Existiert in Ihrem Netz eventuell ein zweiter PXE-Bootserver?

Der openthinclient Server "bedient" per Standard nur "seine" Clients (keine anderen) die im openthinclient-Manager auch eingerichtet worden (Whitelist). Überschneidet sich die PXE-Antwort aber mit der Antwort eines anderen Servers gibt es häufig Probleme. Bitte stellen Sie sicher, dass kein anderer PXE-Bootserver den gewünschten Client "bedient".

"Loading .../vmlinuz failed: No such file or directory"

Wenn Sie diesen Fehler nach einem Update sehen, überprüfen Sie im Hardwaretypen (unter "Experten-Einstellungen") und eventuell im ThinClient-Profil (unter "Boot-Optionen"), dass kein expliziter Eintrag für diesen Kernelnamen "vmlinuz" existiert.

Sie nutzen alte 32-Bit Hardware?

Set der Version 2020.2 unstützt openthinclient nur noch 64-Bit Hardware.

Einstellungen für das Booten mit "abgesichertem Modus"

Hiermit empfehlen wir einige Grundeinstellungen für eine Art "abgesicherten Modus", mit der Sie eine große Chance haben, dass Ihr Gerät bootet.

Wählen Sie diese Einstellungen:

Bootloader → TFTP
Kernel und init per → TFTP
Grafiktreiber → Xorg-Vesa
Splashsceen → kein Splashscreen, zeige alle Startmeldungen

Der Bootvorgang bleibt stehen?

Der PXE-Boot beginnt, Kernel und initrd werden geladen, aber der weitere Systemstart bleibt hängen? Sehen Sie beim Start des System ein solche Ausgabe,

hat der Client nacht dem Laden des Kernels und der initrd keine IP bekommen. Dies könnte auf ein DHCP-Problem hindeuten, oder darin begründet sein, dass kein Treiber für Ihre Netzwerkkarte verfügbar ist.

Nutzen Sie die Debugshell

Bricht der Bootvorgang ab, sollte Ihnen immer eine Debugshell (siehe Bild vorher) angeboten werden. Diese erreichen Sie nachdem Sie eine beliebige Taste im "Prolog" gedrückt haben. Die Debugshell können Sie mit dem Kommando "DE" oder "FR" auf deutsches oder französisches Keyboardlayout umstellen. Im Standard ist amerikanisches Layout aktiv. Mit TAB wird Ihnen die Liste der verfügbaren Kommandos gezeigt. Es handelt sich um eine größere Auswahl von Werkzeuge aus der aktuellen Busybox.

Sie könnten mit ifconfig zum Beispiel nachschauen, ob Ihre Netzwerkkarte erkannt wurde:

Im obigen Beispiel sind die Karten sehr wohl erkannt worden (es existiert demnach auch ein Treiber), nur hat keine der beiden Karten eine IP bekommen. Man könnte in diesem Beispiel nun mit "udhcpc -i eth0" versuchen eine IP per DHCP zu bekommen und so den vorliegenden Fehler ergründen. Sehen Sie mittels Kommando " ifconfig -a" keine Einträge wie eth0 oder eth1, ist davon auszugehen, dass für Ihre Netzwerkkarte kein Treiber existiert.

Theoretisch lässt sich nach Beheben eines Fehlers (z.B. IP nachträglich bezogen oder manuell gesetzt) der Bootvorgang auch fortsetzen. Beenden Sie die Busybox mit dem Kommando "exit".

Die aktuellen init-Scripts des openthinclient-OS finden Sie zum nachlesen jederzeit auf Bitbucket bzw. direkt in der Busybox. (Dateien: /init und /init_functions).

Debugmodus für einen Client

Neben der Debugshell, besteht weiterhin die Möglichkeit einen Client in den Debugmodus zu versetzen. Dies bewirkt die mehrfache Unterbrechung der Abarbeitung des init-Skriptes an vorgegebenen (benannten) Punkten (ähnlich Breakpoints). An jedem dieser Punkte bleibt das init-Skript stehen und ruft eine Debugshell auf. Mit Komando "exit" kann jeweils fortgesetzt werden.

Versetzen Sie ein  einen Client in den Debugmodus indem Sie in den Client-Eigenschaften unter der Registerkarte Einstellungen den Debugmodus einschalten. Dies bezieht sich dann nur auf diesen spezifischen Client.