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.
Run this prompt with AI
Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.
Related prompts
-
Nova SR-IOV & PCI Passthrough Whitelist Debug Prompt
Diagnose why SR-IOV VFs or passthrough PCI devices fail to attach, get the wrong NUMA affinity, or never show up in Placement inventory.
-
Placement Resource Provider Inventory Reshape Debug Prompt
Helps you diagnose and repair Placement reshape failures where allocations get stranded between root and nested resource providers (NUMA, PCI, VGPU) after a Nova upgrade.
-
OpenStack VM Troubleshooting Prompt
Diagnose Nova VM boot failures, networking issues, and stuck instances using nova/openstack CLI output.
-
Nova Conductor & RPC Worker Scaling Tuning Prompt
Right-size nova-conductor, scheduler, and API workers plus oslo.messaging RPC pools so the control plane stops timing out under fleet growth — without over-provisioning RabbitMQ connections or starving the database pool.
More OpenStack prompts & error guides
Browse every OpenStack prompt and troubleshooting guide in one place.
Reading prompts? Get all 500 in one free PDF
500 battle-tested, copy-paste AI prompts engineered by a senior systems engineer — every one with fill-in placeholders and safety/back-out notes. Drop your email and it's yours.
- 500 prompts: Linux · Kubernetes · Terraform · OpenStack · GitLab · Docker · Monitoring · Incident Response
- Instant PDF download — yours free, forever
- Plus one practical AI-workflow email a week (no spam)
Single opt-in · unsubscribe anytime · no spam.