Knowledge Base
Troubleshooting and solution know-how — search, or ask AI Assistant.
Resynchronizing 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-17Volume snapshot creation fails with "unable to find volume" due to a path mismatchFix a mismatched primary-storage UUID and installPath between the management database and the actual qcow2 path on the host, then merge old snapshots.Updated: 2026-08-17Deleting an abnormal empty storage pool from a ZStone clusterWhen a ZStone Ceph cluster shows HEALTH_WARN because of an empty storage pool with a malformed name, the pool can be removed with ceph osd pool delete after the customer confirms the change plan, global HA is disabled, and the database is backed up.Updated: 2026-08-17Troubleshooting intermittent "Cannot assign requested address" errors when a VM accesses object storageTroubleshoot intermittent `Cannot assign requested address` errors caused by a Linux guest opening many short-lived connections to an object storage endpoint.Updated: 2026-08-17Troubleshooting snapshot deletion when control-plane and data-plane chains are inconsistentResolve a "could not find image ... in chain" failure when deleting a volume snapshot by reconciling the libvirt/QCOW2 backing chain with the VolumeSnapshotVO records and removing the stale DB row.Updated: 2026-08-17OverviewAbout This Document This document introduces the product positioning, core functions, and basic operations of ZStack Cloud Foundation (ZCF) 1.2.0.Release NotesThis chapter describes the component versions and major releases of ZStack Cloud Foundation (ZCF).ZStack Cloud Foundation 1.2.0On July 24, 2026, ZStack Cloud Foundation (ZCF) 1.2.0 was officially released.