Hardware Watchdog

os-watchdog · System

Schärft den Hardware-Watchdog des Hosts, sodass ein Host, der stehen bleibt, von seiner eigenen Hardware zurückgesetzt wird, und liest aus dem Chipsatz, warum der Host zuletzt zurückgesetzt wurde.

Im Menü

• Mit installiertem os-xgs-npu: XGS: Hardware Watchdog
• Ohne os-xgs-npu: System: Hardware Watchdog

Seine Seite in der Weboberfläche, auf Englisch.

OPNsense schärft selbst keinen Watchdog. Ist seine Einstellung an, schärft dieses Plugin den Watchdog-Timer des Chipsatzes bei jedem Start mit watchdogd(8) und entschärft ihn bei jedem Herunterfahren, damit eine ausgeschaltete Maschine aus bleibt. Der Treiber des Timers richtet sich nach dem Prozessor: amdsbwd bei AMD, ichwd bei Intel.

Auf AMD-Prozessoren der Familie 17h oder neuer liest es außerdem bei jedem Start, warum der Host zuletzt zurückgesetzt wurde - das Register S5_RESET_STATUS des FCH, ein Bit je Ursache -, bewahrt den Eintrag auf und löscht das Register für den nächsten Start.

Auf einer Sophos XGS mit os-xgs-npu schärft os-xgs-npu den Timer bereits und liest den Reset-Eintrag, und dieses Plugin tritt zurück: Es startet keinen eigenen watchdogd und zeigt den von os-xgs-npu, und es übernimmt den Eintrag, den os-xgs-npu für diesen Start gelesen hat, statt das Register zu lesen. Seine eigenen Einstellungen greifen, sobald os-xgs-npu den Timer nicht mehr schärft.

Funktionen

• Timer beim Start geschärft

  watchdogd(8) schärft den Timer des Chipsatzes bei jedem Start und entschärft ihn bei jedem Herunterfahren.

• Zwei Einstellungen

  An oder aus, und das Timeout: 64, 128 oder 256 Sekunden.

• Letzter Neustart

  Warum der Host zuletzt zurückgesetzt wurde, wie der Chipsatz es festhielt, mit jedem gesetzten Bit und dessen Bedeutung. Auf AMD-Prozessoren der Familie 17h oder neuer.

• Wer den Timer hält

  Die Seite zeigt, ob der Timer geschärft ist und von wem: von diesem Plugin, von os-xgs-npu oder von einem anderen watchdogd. Ein watchdogd, den etwas anderes gestartet hat, bleibt unberührt.

• Ein Leser je Start

  Das erste Lesen eines Starts löscht den Eintrag; hat os-xgs-npu ihn gelesen, übernimmt dieses Plugin dessen Eintrag.

Installieren und aktualisieren

Ab dem Release von os-xgs-npu nach 0.1.0-alpha.7.1 steht es in XGS: Updates im Reiter Plugins – eine installierte Kopie wird dort von Hand aktualisiert, eine fehlende dort installiert –, und die fertigen Images aus diesem Release enthalten es; bis dahin wird es wie unten beschrieben installiert und aktualisiert. Kein Cron-Eintrag führt das Update aus. Installiert wird es auf einer XGS-Appliance und auf jedem anderen OPNsense als root: aus einem Checkout des Repositorys mit sh install/install.sh, das die Seite mit os-xgs-npu unter XGS und ohne es unter System einordnet und bei erneutem Lauf die Einstellungen behält; oder aus dem Paket des Releases, os-watchdog-1.0.0.pkg, geprüft gegen SHA256SUMS und mit pkg hinzugefügt. Eine so installierte Kopie wird über ihr eigenes self-update.py aktualisiert. Es ist nicht im Plugin-Repository von OPNsense.

Grenzen, und was noch nicht getestet ist

• Schärfen und Entschärfen durch dieses Plugin: Auf jeder Appliance mit os-xgs-npu tritt es zurück.
• Der Timer ichwd der Intel-Prozessoren.
• Das Paket, gebaut von tools/make-package.sh und mit pkg hinzugefügt.
• Eine Installation auf OPNsense ohne os-xgs-npu.
• Ein Update über den Reiter Plugins oder self-update.py: 1.0.0 ist das erste Release, also war noch keines einer installierten Kopie voraus.

Repository

Erste Veröffentlichung: 2026-10-25

os-watchdog Releases