feat: add Guacamole stale-session repair action

2026-09-14 06:50:32 +00:00
parent cbd3f40523
commit 3fdd0e2774
3 changed files with 25 additions and 0 deletions
@@ -149,6 +149,17 @@ VRDE server. Do not switch the helper to native Windows RDP:
 unusable, stop this helper and use Guest Control for the deterministic portion
 of the work; record the blocked interactive step in the native test report.

+If guacd has a stale worker and the VM reports that multiple connections are
+disabled, run:
+
+```sh
+test/rdp-access/rdp-access repair
+```
+
+`repair` restarts only guacd, retains the VM, SSH tunnel, gateway, and IPv6
+forward, and does not alter the Windows guest. Close old browser tabs and sign
+in again after it completes.
+
 The helper requires Docker/Docker Compose, `socat` for the optional public
 dual-stack forward, SSH access through the existing `helium-remote` alias, and
 the fixture password file documented in