Fix Guacamole graphics login cache and session repair

This commit is contained in:
cabbage committed 2026-10-08 07:11:21 +00:00
1 parent 98a474696b
commit 4f1ed41f9f
4 files changed
+43 -15

No files matched your search

+9 -3
View File
@@ -904,9 +904,15 @@ watchdog/tunnel is bound
only to the helper's private Docker gateway. Stop the helper before the normal
`test-host reset`. It is a recovery interface, not a product component or a
replacement for Guest Control/native test automation.
The helper's `repair` action may restart only guacd when a dropped browser
leaves a stale worker holding the fixture's single VRDE slot; it must not
restart or mutate the Windows VM automatically.
The helper's `repair` action restarts guacd and the Guacamole web application
when a dropped browser leaves a stale worker holding the fixture's single VRDE
slot, or an authenticated login retains an old graphics configuration. It
clears cached web logins but preserves the HTTPS gateway and forwarding; it
must not restart or mutate the Windows VM automatically. Changing a graphics
preset requires logging out of Guacamole and signing in again, not merely
reconnecting the desktop: file authentication retains a connection map in the
authenticated user's context. Verify graphics through the authenticated web
tunnel, not only a direct guacd connection which bypasses that context.
Because Windows can power off the virtual monitor while the VM remains
running, `test-host prepare` must also reapply the disposable display/sleep
keepalive and record `prepare-display-keepalive`. A zero-bpp VRDE framebuffer
+4 -1
View File
@@ -216,7 +216,10 @@ test/rdp-access/rdp-access up --bind 0.0.0.0 \
```
That requests 800×600/8-bit graphics and saves the selection per gateway
profile. Disconnect/reconnect to apply a profile change; it does not modify
profile. Log out of Guacamole and sign in again to apply a profile change:
desktop disconnect/reconnect alone retains the login's cached configuration.
`rdp-access repair` clears both cached web logins and stale RDP workers without
rebooting Windows. A profile change does not modify
the Windows baseline. See the [gateway quality settings](../test/rdp-access/README.md#network-and-graphics-quality)
for all levels and server-negotiation caveats.