Troubleshooting

Symptoms you may see, what they mean, and what to do. If a problem persists, open a ticket in the customer portal and attach the relevant logs (see Collect logs).

Hosts

A host shows "Not responding"

The host has not reported to QvDC for more than 90 seconds. The detail line says when it last reported. VMs on the host usually keep running.

1. Check the host's own screen: the Direct Console shows its health and management address.
2. From your browser, open https://<host-address>:8443/. If the Host UI loads, the host is up and the problem is between QvDC and the host — check the network and firewalls (TCP 8443 and 9443).
3. If the Host UI does not load, use Restart Management Services in the Direct Console. Running VMs are not affected.
4. In the dashboard, right-click the host and choose Reconnect Host.

A host shows "Disconnected"

QvDC has lost the host. Follow the steps above. If the host was reinstalled, add it again (see Add hosts to QvDC).

Adding a host fails

The Add Host dialog's connection test names the failing check and how to fix it. See If a check fails. The most common causes are a browser that has not yet accepted the host's certificate, and host and QvDC clocks that disagree.

Clocks disagree

Time differences break host registration, certificates and licence checks.

• Host UI: Admin Panel → Time shows Clock status and lets you Add source for NTP servers.
• QvDC: Admin Panel → System → Time synchronisation. A host's detail page shows Host Time as Synced or Not synced.

Use the same NTP servers everywhere.

Browser and certificates

The browser warns that the connection is not private

QvDC and hosts start with self-signed certificates, so the first visit shows a warning. Accept it once per address. To remove the warning for good, install a certificate your organization trusts:

• on a host: Admin Panel → Certificates in the Host UI;
• on QvDC: ask support for the certificate replacement procedure.

Passkeys are not offered

Passkeys only work when you open QvDC by its DNS name, not by IP address, and the certificate must be issued for that name.

Virtual machines

The console does not connect

The console shows why:

Message	What to do
VM Not Running	Power the VM on, then open the console again.
Host Unreachable	The VM's host is offline or unreachable. See Hosts.
No Host Available	The VM is not placed on any host. Check the cluster has a Ready host.
VM Sync Issue	Refresh the page. If it persists, use Actions → Resync State on the VM.
Console Unavailable	The VM has no display device. Check its display settings.
Session Ended	Console sessions cannot be reused. Open the console again from the VM.
QvMC did not open	QvMC is not installed, or has not been launched since installation. Install it, launch it once, then try again.

A VM's state shows a "?"

The VM's host has stopped reporting, so the state shown is the last one known, not the current one. Fix the host first (see Hosts).

A VM will not start

Open the VM: a banner such as VM recovery is blocked gives the reason. The VM's Logs tab shows the hypervisor's log for that VM, with a Common Issues to Look For guide. Common causes are a storage pool that is not connected on the VM's host (use Reconnect on the pool), or a missing ISO still attached to a CD-ROM (eject it on the Storage tab).

A VM's state looks wrong

If the dashboard and reality disagree — for example the VM shows Stopped but answers on the network — use Actions → Resync State. It reads the VM's actual state from its host.

Power buttons are greyed out

A disk resize or reconfiguration is still running. Power actions are blocked until it finishes; watch Operations.

The guest agent shows "Not Installed" or no IP address

See If the agent does not connect. Graceful Shutdown and Reboot need the agent; Power Off always works.

A disk was resized but the guest still sees the old size

Resizing grows the virtual disk only. Extend the partition and file system inside the guest (for example growpart and resize2fs on Linux, or Disk Management → Extend Volume on Windows).

Storage

A storage pool is disconnected on a host

Check the NFS server or iSCSI target is up and reachable from that host, then click Reconnect on the pool. For NFS, the export must allow read and write access from every assigned host.

Updates

See If an update fails. QvDC rolls back a failed update automatically; the dashboard shows Update failed — The update was rolled back and all services keep running on the previous version.

Error pages

When a page cannot be shown, the dashboard replaces it with an error page. The sidebar and top bar stay available, so you can go elsewhere at any time. Every error page has Technical details at the bottom: use Copy details and include the text when you report the problem.

"You don't have access to this page"

Your role does not include a permission the page needs. The page names the missing permission. Ask your system administrator to add it to your role (see Users and roles).

"Page not found", or a VM, host or other item "not found"

Nothing exists at that address: the link is incomplete, or the item was deleted. Use Back to the list, or press ⌘K (Ctrl K on Windows and Linux) to search by name.

"Can't reach the control plane"

Your browser did not get an answer from QvDC. This is often your own network connection, a VPN or a proxy, not QvDC itself, and it does not mean the VM or host is down. The dashboard keeps retrying on its own; Try again retries now. If it doesn't come back, contact your system administrator.

"Couldn't load" a VM, host or other item

QvDC answered, but with an error. The item was not changed or removed — only reading it failed. Click Try again. If this keeps happening, contact your system administrator and include the technical details; the Request ID, when shown, identifies the failed request in the QvDC logs.

"Something went wrong"

The page hit an unexpected error while displaying. Click Try again, or open another page from the sidebar. If you had just started an action, check Recent Operations for its result before repeating it.

"Quantix was updated"

QvDC was updated after you opened the dashboard. Click Reload to load the new version; you stay signed in.

Collect logs

When you contact support, include what you can of the following:

• QvDC: Operations → System Logs — filter to the time of the problem and download as JSON, CSV or Plain Text. The VM or host's Events tab shows its recent history, and Recent Operations shows the tasks that ran and their results.
• Host: the Host UI's Logs page (download as JSON, CSV or Plain Text), its Events page, and View Logs & Diagnostics in the Direct Console.
• The exact error message, and when it happened.