Hardware Watchdog
os-watchdog · Système
Arme le watchdog matériel de l'hôte, pour qu'un hôte qui cesse de fonctionner soit réinitialisé par son propre matériel, et lit dans le chipset pourquoi l'hôte a été réinitialisé la dernière fois.
Dans le menu
- Avec os-xgs-npu installé : XGS: Hardware Watchdog
- Sans os-xgs-npu : System: Hardware Watchdog
OPNsense n'arme aucun watchdog de lui-même. Quand son réglage est activé, ce plugin arme le minuteur watchdog du chipset avec watchdogd(8) à chaque démarrage et le désarme à chaque arrêt, pour qu'une machine éteinte reste éteinte. Le pilote du minuteur dépend du processeur : amdsbwd sur AMD, ichwd sur Intel.
Sur les processeurs AMD de la famille 17h ou plus récents, il lit aussi à chaque démarrage pourquoi l'hôte a été réinitialisé la dernière fois - le registre S5_RESET_STATUS du FCH, un bit par cause -, conserve ce qu'il a lu et efface le registre pour le démarrage suivant.
Sur un Sophos XGS avec os-xgs-npu, os-xgs-npu arme déjà le minuteur et lit l'enregistrement de réinitialisation, et ce plugin s'efface : il ne lance pas son propre watchdogd et affiche celui d'os-xgs-npu, et il reprend ce qu'os-xgs-npu a lu pour ce démarrage au lieu de lire le registre. Ses propres réglages prennent le relais dès qu'os-xgs-npu n'arme plus le minuteur.
Fonctions
-
Minuteur armé au démarrage
watchdogd(8) arme le minuteur du chipset à chaque démarrage et le désarme à chaque arrêt.
-
Deux réglages
Activé ou non, et le délai : 64, 128 ou 256 secondes.
-
Dernier redémarrage
Pourquoi l'hôte a été réinitialisé la dernière fois, tel que le chipset l'a noté, avec chaque bit positionné et sa signification. Sur les processeurs AMD de la famille 17h ou plus récents.
-
Qui tient le minuteur
La page indique si le minuteur est armé et par qui : ce plugin, os-xgs-npu ou un autre watchdogd. Un watchdogd lancé par autre chose est laissé tel quel.
-
Un seul lecteur par démarrage
La première lecture d'un démarrage efface l'enregistrement ; si os-xgs-npu l'a lu, ce plugin reprend sa lecture.
Installer et mettre à jour
À partir de la version d'os-xgs-npu qui suit 0.1.0-alpha.7.1, XGS: Updates l'affiche dans son onglet Plugins — une copie installée s'y met à jour à la main, et une copie absente s'y installe — et les images prêtes construites à partir de cette version l'embarquent ; d'ici là, il s'installe et se met à jour comme ci-dessous. Aucune entrée cron ne lance la mise à jour. Pour l'installer sur une appliance XGS ou sur tout autre OPNsense, en root : depuis un checkout du dépôt avec sh install/install.sh, qui place la page sous XGS avec os-xgs-npu et sous System sans lui, et garde les réglages s'il est relancé ; ou depuis le paquet de la version, os-watchdog-1.0.0.pkg, vérifié avec SHA256SUMS et ajouté avec pkg. Une copie ainsi installée se met à jour par son propre self-update.py. Il n'est pas dans le dépôt de plugins d'OPNsense.
Limites, et ce qui n'est pas encore testé
- L'armement et le désarmement par ce plugin : il s'efface sur toute appliance qui a os-xgs-npu.
- Le minuteur ichwd des processeurs Intel.
- Le paquet, construit par tools/make-package.sh et ajouté avec pkg.
- Une installation sur OPNsense sans os-xgs-npu.
- Une mise à jour par l'onglet Plugins ou self-update.py : 1.0.0 est la première version, aucune n'a donc encore devancé une copie installée.
Dépôt
Première version: 2026-10-25