Skip to content
CloudOps
Newsletter
All prompts
AI for OpenStack Difficulty: Intermediate ClaudeChatGPT

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.
Newsletter

Free: the DevOps AI Incident-Triage Cheat Sheet

Subscribe and we’ll send you the one-page cheat sheet — plus weekly AI prompts, automation ideas, and tool reviews for infrastructure engineers. One email a week. No spam, unsubscribe anytime.

  • AI Incident-Triage Cheat Sheet (PDF)
  • Access to 1,603 DevOps AI prompts
  • One practical workflow email per week