Knowledge Base
Troubleshooting and solution know-how — search, or ask AI Assistant.
Change the management network gateway on a hostBack up the configuration, change the management bridge gateway in sequence, and restart networking to update a host's management network gateway.Updated: 2026-09-17VM creation fails because lvmlockd leaks VG shared locks after storage disconnectsAfter a temporary storage disconnect, clear unreleased VG shared locks in lvmlockd that prevent exclusive locks from being acquired and restore volume and VM creation.Updated: 2026-09-17Upgrade ZStack Cube HCI to 2.4.17 in a dual-management-node HA environmentPerform prechecks, backups, and HA toolkit and cloud-platform upgrades to upgrade ZStack Cube HCI to 2.4.17 in a dual-management-node HA environment.Updated: 2026-09-17Management node and browser times differ because of clock driftWhen management node and browser times differ, stop the management node service, configure an external NTP source, synchronize the local clock, and write it to the hardware clock.Updated: 2026-09-17Management node CPU usage is high after zops tasks become stuckTroubleshoot persistent high CPU usage on a management node by identifying accumulated ansible-playbook processes under zops, then restart the zops service.Updated: 2026-09-17Resource operations fail due to lvmlock result -28 on SharedBlock storageDescribes how to diagnose resource operation failures after SharedBlock storage reports lvmlockctl result -28, apply temporary recovery steps, and upgrade to a version with the long-term fix.Updated: 2026-09-17VM HA does not trigger while a host is unresponsive but its storage heartbeat remains aliveTroubleshoot why VM HA does not trigger after a host becomes unreachable and determine whether a responsive storage heartbeat prevents the HA trigger conditions from being met.Updated: 2026-09-17Resynchronizing a dual-MN database and upgrading the zsha2 HA suiteResynchronize an out-of-sync database between two ZStack Cloud management nodes, then upgrade the zsha2 HA suite and verify platform health.Updated: 2026-08-17Physical NIC disconnect and reconnect alarms caused by an unsupported SFP moduleResolve repeated physical NIC disconnect and reconnect alarms by identifying an unsupported SFP module and replacing it with a vendor-approved module.Updated: 2026-08-17VM startup fails with "mediated device not found" after vGPU repartitioningWhen a VM bound to a vGPU (virtual GPU) fails to start with a libvirt \"device not found: mediated device\" error, the broken vGPU binding can be removed and the VM started on a healthy vGPU.Updated: 2026-08-17
