Reference
Troubleshooting
Fixes for the most common install, network, and lab problems.
Find your symptom below. Each guide also has its own If it fails table.
Installing the OVA
| Symptom | Cause | Fix |
|---|---|---|
| A required disk image was missing | Browser upload of the large OVA was incomplete | Copy the .ova to the datastore with SCP, or deploy with ovftool. |
| Only one hard disk in Edit settings | Incomplete import | Delete the VM and deploy again from the single .ova. |
vex-nx-bake login: on the console | The cidata CD didn't apply | Connect the OVA's cidata ISO and power on again; if stuck, sudo cloud-init clean --logs and reboot once. |
| No DHCP/Static menu | cidata not connected | Confirm two disks and cidata Connected, then watch from the first seconds. |
| Hard Disk 2 missing banner | Install payload not found | Attach Disk 2 from the same OVA, or redeploy. |
Login incorrect for vexnx | Password already changed | Use the web UI as admin, or the password you set. |
Installing from USB
| Symptom | Fix |
|---|---|
| USB won't boot | Use the UEFI boot entry, try Secure Boot off, re-write with Rufus in DD mode. |
| Black screen with a blinking cursor in VMware | VMware Easy Install was used. Recreate with I will install the operating system later. |
| Keyboard or mouse dead in the installer | Raise video memory to 16 MB+, enable the USB tablet. |
| Partitions page empty | Choose Erase disk; fix video and input first if the UI is blank. |
| Static IP lost after reboot | Set it again under Infrastructure → Management network. |
Network and access
| Symptom | Fix |
|---|---|
| No management IP | Check the Management adapter's network and DHCP; run ip a on the console. |
| Can't reach the web UI | Use the management IP, not 172.17.0.1 (Docker's bridge); check firewalls. |
| Image pulls fail with DNS errors | Set DNS under Infrastructure → Management network. |
Running labs
| Symptom | Fix |
|---|---|
QEMU nodes won't start, no /dev/kvm | Enable VT-x/AMD-V and expose it to the VM; on Windows hosts turn Hyper-V off. |
| FRR or Alpine image missing | sudo vexnx-seed-docker, or Operate → More → Seed Docker images. |
qemu-img not found | The ISO is too old. Reinstall from current media. |
| A vendor node won't boot | Import a licensed image under Images → Import and bind it to the node. |
| SecureCRT connection refused | Stop, then Start the node, and try again. |
| Quota exceeded | Stop other labs, or raise quotas in Administration. |
Still stuck? Collect your VEX-NX version and edition, OVA or ISO, hypervisor version, vCPU and RAM, and the exact error text, then contact support. Never send passwords or licence keys.