@@ -78,7 +78,7 @@ Field Value
7878Name A suitable name to represent the Backup Repository
7979Address URL, in case of NFS <server IP>:/path
8080Type NFS / CIFS / CEPH
81- label.mountopts Any mount point options to be passed while mouting this storage on the hypervisor.
81+ Mount options Any mount point options to be passed while mouting this storage on the hypervisor.
8282Zone The zone in CloudStack with which this Backup Repository must be associated.
8383=================== ========================
8484
@@ -98,6 +98,28 @@ For the "External ID", please specify the name of the previously created backup
9898
9999After this has been done, you can go to any Instance view and there will be buttons available for either ad-hoc backup or a scheduled backup of the VM
100100
101+ Quiesce (Filesystem Freeze and Thaw)
102+ ------------------------------------
103+
104+ Users can set quiesce to true while creating a backup or a backup schedule.
105+ When a backup is initiated with quiesce enabled, CloudStack uses QEMU guest agent
106+ to freeze the filesystem before starting backup. This operation flushes all dirty
107+ filesystem buffers to disk and quiesces new writes. The filesystem is then thawed
108+ immediately after the backup process starts, keeping the freezing window very short.
109+
110+ |NASB&R-quiesceInstance.png |
111+
112+ This enhancement brings the NAS backup plugin from crash-consistent backups closer to
113+ application-consistent backups.
114+
115+ Points to note:
116+
117+ #. The feature requires qemu-guest-agent to be installed and running on the guest instance.
118+ #. This method does not capture the memory state of the guest. Any data held in application memory
119+ that hasn’t been flushed to disk prior to the filesystem freeze will not be captured.
120+ #. For fully application-consistent backups, guest applications must implement pre-freeze hooks
121+ to flush their internal state to disk before the filesystem is frozen.
122+
101123Support Information and Limitation
102124----------------------------------
103125
@@ -120,8 +142,12 @@ in qcow2 format to the backup repository.
120142
121143For restore operations, the KVM instance must be stopped in CloudStack.
122144Currently, only volume(s) restoration is supported only to NFS and local storage
123- based primary storage pools, and restored volumes are fully baked disks (i.e.
145+ based primary storage pools, and restored volumes are fully backed disks (i.e.
124146not using any backing template file).
125147
126148Backup and restore operations are not fully supported for CKS cluster instances and should
127149be avoided.
150+
151+ .. |NASB&R-quiesceInstance.png | image :: /_static/images/NASB&R-quiesceInstance.png
152+ :alt: Quiesce option while creating backups.
153+ :width: 400 px
0 commit comments