From 85819e40c1b902e66dc1e82538ff4f68f980b089 Mon Sep 17 00:00:00 2001
From: Michal <michal@itaz.eu>
Date: Sun, 6 Sep 2026 09:34:05 +0100
Subject: [PATCH] wan-drill-watchdog: bound the blast radius of a failover
 drill

The drill takes the internet down for as long as the new master needs a WAN.
If it never gets one, whoever is running the drill is offline too -- and an
agent simply stops responding mid-incident. The abort therefore cannot depend
on anyone being present.

Armed on the router expected to take over: if it holds the VIP and has had no
WAN for HOLD consecutive seconds, it sets force-fault on itself, sheds every
VIP, and the healthy non-preempting peer takes them straight back. setsid so it
outlives the ssh session that armed it, which is the entire point.

150s by default, deliberately shorter than GRACE=300. GRACE is sized for a real
hostile-ISP takeover that is still making progress; this is sized for "the
drill failed, give the house its internet back".

Both paths proven on vyos002 in production: it stayed silent for 35s while a
BACKUP (a misfire here would itself cause an outage), and fired within 20s when
pointed at an address the box does hold with no WAN, logging
"ABORT: held the VIP with no WAN for 20s -- standing down".

The first firing test was my own bug, worth noting: sed'ing the default VIP=
line does nothing, because vrrp-wan.conf is sourced afterwards and
VRRP_WAN_VIP puts 192.168.1.1 straight back. The watchdog was watching an
address the box does not hold and correctly stayed quiet -- a test that proved
nothing while looking like it proved the feature was broken.
---
 migration/wan-drill-watchdog | 83 ++++++++++++++++++++++++++++++++++++
 1 file changed, 83 insertions(+)
 create mode 100644 migration/wan-drill-watchdog

diff --git a/migration/wan-drill-watchdog b/migration/wan-drill-watchdog
new file mode 100644
index 0000000..8b197d9
--- /dev/null
+++ b/migration/wan-drill-watchdog
@@ -0,0 +1,83 @@
+#!/bin/sh
+# Auto-abort for a WAN failover drill. Armed on the router that is EXPECTED TO
+# TAKE OVER, before the drill starts.
+#
+# The drill takes the internet down for as long as the new master needs to
+# raise a WAN. If it never does, whoever is running the drill has no internet
+# either -- and if that is an agent, it simply stops responding mid-incident.
+# So the abort cannot depend on anyone being there.
+#
+# Rule: if I hold the VIP and have had NO WAN for HOLD consecutive seconds,
+# stand down. force-fault sheds every VIP and the peer -- which is healthy and
+# merely non-preempting -- takes them straight back.
+#
+# This is deliberately SHORTER than GRACE in vrrp-wan.conf (300s). GRACE is
+# sized for a real hostile-ISP takeover that is still making progress; this is
+# sized for "the drill failed, give the house its internet back". Anything the
+# drill proves after two and a half minutes of downtime is not worth the
+# downtime.
+#
+#   wan-drill-watchdog arm [seconds]     background it, then run the drill
+#   wan-drill-watchdog disarm            cancel it (drill succeeded)
+
+STATE=/run/vrrp-wan
+VIP=192.168.1.1
+[ -r /config/vrrp-wan.conf ] && . /config/vrrp-wan.conf
+VIP="${VRRP_WAN_VIP:-$VIP}"
+HOLD="${2:-150}"
+PIDF=/run/wan-drill-watchdog.pid
+
+have_vip() { ip -4 -o addr show 2>/dev/null | grep -q " ${VIP}/"; }
+have_wan() {
+    ip -4 addr show dev bond0.53 2>/dev/null | grep -q 'inet ' && return 0
+    ip -4 addr show dev pppoe0   2>/dev/null | grep -q 'inet ' && return 0
+    return 1
+}
+
+case "${1:-arm}" in
+disarm)
+    if [ -f "$PIDF" ]; then
+        kill "$(cat "$PIDF")" 2>/dev/null
+        rm -f "$PIDF"
+        echo "  watchdog disarmed"
+    else
+        echo "  no watchdog armed"
+    fi
+    exit 0
+    ;;
+arm)
+    [ -f "$PIDF" ] && kill "$(cat "$PIDF")" 2>/dev/null
+    mkdir -p "$STATE" 2>/dev/null
+    # setsid so it survives the ssh session that armed it going away -- the
+    # whole point is that it outlives whoever started the drill.
+    setsid sh -c '
+        bad=0
+        while :; do
+            sleep 5
+            if ip -4 -o addr show 2>/dev/null | grep -q " '"$VIP"'/"; then
+                if ip -4 addr show dev bond0.53 2>/dev/null | grep -q "inet " ||
+                   ip -4 addr show dev pppoe0 2>/dev/null | grep -q "inet "; then
+                    bad=0
+                else
+                    bad=$((bad + 5))
+                fi
+            else
+                bad=0
+            fi
+            if [ "$bad" -ge '"$HOLD"' ]; then
+                logger -t wan-drill "ABORT: held the VIP with no WAN for '"$HOLD"'s -- standing down"
+                touch '"$STATE"'/force-fault
+                rm -f '"$PIDF"'
+                exit 0
+            fi
+        done
+    ' >/dev/null 2>&1 &
+    echo $! > "$PIDF"
+    echo "  watchdog armed (pid $(cat "$PIDF")): stand down after ${HOLD}s holding the VIP with no WAN"
+    exit 0
+    ;;
+*)
+    echo "usage: wan-drill-watchdog [arm [seconds]|disarm]" >&2
+    exit 2
+    ;;
+esac