Train at Home plante ou se fige la nuit : le redémarrage automatique

Si vous laissez Train at Home tourner la nuit, il arrive de retrouver le matin une app morte, ou une app encore ouverte mais qui ne fait plus rien. subnera dispose d'un watchdog optionnel pour ce cas précis, nommé Auto-Restart on Crash. Il est volontairement prudent, car un redémarrage n'est pas sans conséquence. Ce guide explique ce qu'il détecte, quand il se tient à l'écart, et ce qu'il ne peut pas réparer.

Plantage ou blocage

Le watchdog distingue deux situations à partir de ce que subnera observe déjà : l'app officielle tourne-t-elle, un processus worker main_pool est-il encore vivant, et quel âge a la dernière ligne du log CLI.

• Plantage : l'app officielle ne tourne plus, mais son worker est toujours vivant. L'app officielle a un défaut de nettoyage à la fermeture qui peut laisser ce worker derrière elle ; « app disparue plus worker orphelin » est donc lu comme un plantage. Le watchdog supprime le worker restant et relance l'app.
• Blocage : l'app tourne, mais le log CLI n'a pas reçu de ligne depuis plus de 5 minutes. Le watchdog quitte l'app, attend environ 3 secondes, supprime un éventuel worker restant, puis la relance.

Si l'app a disparu sans worker orphelin, le watchdog considère que vous l'avez quittée volontairement et n'y touche pas.

Le titre du menu affiche off dès que le log est silencieux depuis 2 minutes. Le watchdog attend 5 minutes avant d'agir : une courte pause ne déclenche donc jamais de redémarrage. Pour la lecture du log, voir le guide de la position dans la file.

Quand il ne fait volontairement rien

• Il est désactivé. Le redémarrage automatique est éteint tant que vous ne l'activez pas.
• L'app n'était pas active récemment. Le watchdog n'agit que s'il a vu l'app officielle tourner dans les 2 dernières minutes. Il ne démarre jamais une app que vous gardez fermée.
• Vous venez d'arrêter ou de redémarrer l'app. Après un arrêt ou un redémarrage depuis le menu ou depuis le hub, il reste inactif 5 minutes, pour ne jamais annuler votre action ni entrer en concurrence avec la relance.
• Il a agi récemment. Au moins 3 minutes doivent séparer deux actions, afin qu'un démarrage lent ne soit pas pris pour un nouveau plantage.
• Un redémarrage pour mise à jour officielle est en cours. Le watchdog est ignoré pendant que subnera relance l'app pour installer une mise à jour.

Cet espacement est un minimum fixe de 3 minutes, pas un délai croissant.

Le garde-fou anti-boucle

Si le watchdog devait agir plus de 3 fois en 15 minutes, il s'arrête au lieu de tourner en boucle. Le menu affiche alors l'avertissement Watchdog stopped (flapping), avec une action Re-enable Watchdog. Désactiver puis réactiver l'option repart aussi sur une fenêtre neuve.

Des récupérations répétées signalent en général une cause durable : un Mac qui se met en veille, un réseau qui échoue sans cesse, une installation endommagée. Cherchez cette cause plutôt que de réactiver sans réfléchir. Le guide anti-veille et le guide de dépannage couvrent les cas courants.

Ce que coûte un redémarrage

Redémarrer l'app officielle envoie une nouvelle demande d'enregistrement, et l'orchestrateur répond par un nouvel identifiant de file, tout au fond de la file. Le coût est le même que vous redémarriez à la main ou que le watchdog le fasse. Si vous étiez en file, l'attente recommence.

Le watchdog sert donc pour les vrais plantages et les vrais blocages, quand le mineur ne produisait de toute façon plus rien. Ce n'est pas un outil d'impatience, et il n'accélère rien. Si votre position semble figée alors que le log avance, ne faites rien. Le guide de la position dans la file explique pourquoi redémarrer en file d'attente est l'erreur la plus coûteuse.

subnera ne promet ni disponibilité ni gains. Le watchdog raccourcit le temps pendant lequel une app morte reste morte, rien de plus.

Ce qu'il fait à l'app officielle

subnera ne modifie jamais l'app officielle. Le watchdog ne fait que ce que vous pourriez faire vous-même : demander à l'app de quitter, terminer les processus worker main_pool restants, et rouvrir l'app installée en arrière-plan, masquée. Il ne touche pas aux fichiers de l'app et n'ouvre aucune connexion réseau pour cela.

Activer et désactiver

1. Ouvrez le menu subnera, puis Options.
2. Cliquez sur Auto-Restart on Crash. Une coche indique qu'il est actif. Cliquez de nouveau pour le désactiver.

Le réglage est conservé d'un lancement à l'autre.

Si un Mac est enrôlé dans subnera hub, vous pouvez aussi activer ou désactiver le watchdog à distance. Cela ne fonctionne que sur les Mac où Allow remote control est coché localement, sinon la commande est refusée. Voir le guide du contrôle à distance pour le consentement, et le guide du hub de flotte pour le reste du hub.

L'action associée « Reap Orphaned Worker »

Quand l'app officielle ne tourne pas mais qu'un worker est encore vivant, le menu affiche une action Reap Orphaned Worker dans la section de l'app officielle, avec l'avertissement « Orphaned worker still running ». Elle termine le worker restant sans rien relancer. Elle n'apparaît pas tant que l'app tourne, et une commande de nettoyage envoyée par le hub est aussi refusée dans ce cas, car le worker d'une app en marche est le mineur lui-même.

Avec le watchdog actif, vous n'en avez normalement pas besoin : le chemin « plantage » supprime déjà le worker.

Checklist

1. Installez subnera si ce n'est pas fait : guide d'installation.
2. Activez Options, Auto-Restart on Crash seulement si le Mac tourne sans surveillance.
3. Comptez environ 5 minutes de silence pour un blocage, moins pour un plantage.
4. Ne redémarrez pas l'app vous-même quand vous êtes en file.
5. Si l'avertissement de boucle apparaît, cherchez la cause avant de réactiver.
6. Avec plusieurs Mac, décidez Mac par Mac si le contrôle à distance peut piloter le watchdog.