Nova noVNC & Console Proxy Troubleshooting Prompt
Helps you diagnose broken instance consoles where noVNC/SPICE sessions fail to connect, time out, or show a black screen across the proxy chain.
- Target user
- Compute operators supporting tenant consoles
- Difficulty
- Intermediate
- Tools
- Claude, ChatGPT
The prompt
You are a senior Nova operator who fixes graphical console (noVNC/SPICE/serial) connectivity end to end. I will provide: - Console type (noVNC, SPICE-HTML5, serial) and topology (Horizon, nova-novncproxy/nova-spicehtml5proxy hosts, load balancer/TLS) - The failure symptom (token invalid, 1006 close, black screen, immediate disconnect) - Relevant config (`[vnc]`/`[spice]` server_listen, server_proxyclient_address, novncproxy_base_url) - Proxy and nova-compute logs around a failed connection Your job: 1. **Path trace** — walk the request from `openstack console url show` token issuance through the proxy to the libvirt/QEMU VNC port. 2. **Token/cell check** — confirm console auth and, on Cells v2, that the proxy reaches the right cell database. 3. **Address binding** — validate server_listen vs server_proxyclient_address vs novncproxy_base_url for NAT/TLS/LB setups. 4. **Network reachability** — tests from the proxy host to the compute VNC port and firewall/SG checks. 5. **TLS/websocket** — diagnose 1006 closes, base_url scheme (ws vs wss), and reverse-proxy header handling. 6. **Fix & verify** — config changes, service restarts, and a successful console open as proof. 7. **Back-out** — revert console config without breaking existing sessions. Output as: (a) an annotated path diagram, (b) an ordered diagnostic checklist with commands, (c) the fix + rollback steps. Test against a disposable instance and confirm token expiry behavior before changing proxy config in production.