Skip to content

Commit 9dbe974

Browse files
authored
docs(vdsnapshot): update consistency info (#1843)
Signed-off-by: Roman Sysoev <[email protected]>
1 parent 2764820 commit 9dbe974

File tree

2 files changed

+6
-10
lines changed

2 files changed

+6
-10
lines changed

docs/USER_GUIDE.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2786,12 +2786,10 @@ A consistent snapshot guarantees a consistent and complete state of the virtual
27862786
- The virtual machine is turned off.
27872787
- [`qemu-guest-agent`](#guest-os-agent) is installed in the guest system, which temporarily suspends the file system at the time the snapshot is created to ensure its consistency.
27882788

2789-
QEMU Guest Agent supports hook scripts that allow you to prepare applications for snapshot creation without stopping services, ensuring application-level consistency. For more information on configuring hooks scripts, see the [Guest OS agent](#guest-os-agent) section.
2790-
2791-
An inconsistent snapshot may not reflect a consistent state of the virtual machine's disks and its components. Such a snapshot is created in the following cases:
2789+
An inconsistent snapshot may not reflect a consistent state of the virtual machine's disks and its components. Such a snapshot is created if the VM is running and `qemu-guest-agent` is not installed or not running in the guest OS.
2790+
If the snapshot manifest explicitly specifies the `requiredConsistency: false` parameter, but `qemu-guest-agent` is running, an attempt will be made to freeze the file system to ensure that the snapshot is consistent.
27922791

2793-
- The VM is running, and `qemu-guest-agent` is not installed or not running in the guest OS.
2794-
- The snapshot manifest explicitly specifies the `requiredConsistency: false` parameter, and you want to avoid suspending the file system.
2792+
QEMU Guest Agent supports hook scripts that allow you to prepare applications for snapshot creation without stopping services, ensuring application-level consistency. For more information on configuring hooks scripts, see the [Guest OS agent](#guest-os-agent) section.
27952793

27962794
{{< alert level="warning" >}}
27972795
When restoring from such a snapshot, file system integrity issues may occur, as the data state may be inconsistent.

docs/USER_GUIDE.ru.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2817,12 +2817,10 @@ vm-01-fz9cr 5e:e6:19:22:0f:d8 Attached vm-01 5m42s
28172817
- виртуальная машина выключена;
28182818
- в гостевой системе установлен [`qemu-guest-agent`](#агент-гостевой-ос), который на момент создания снимка временно приостанавливает работу файловой системы для обеспечения её согласованности.
28192819

2820-
QEMU Guest Agent поддерживает скрипты hooks, которые позволяют подготовить приложения к созданию снимка без остановки сервисов, обеспечивая согласованное состояние на уровне приложений. Подробнее о настройке скриптов hooks см. в разделе [«Агент гостевой ОС»](#агент-гостевой-ос).
2821-
2822-
Неконсистентный снимок может не отражать согласованное состояние дисков виртуальной машины и её компонентов. Такой снимок создаётся в следующих случаях:
2820+
Неконсистентный снимок может не отражать согласованное состояние дисков виртуальной машины и её компонентов. Такой снимок создаётся, если ВМ запущена, и в гостевой ОС не установлен или не запущен `qemu-guest-agent`.
2821+
Если в манифесте снимка явно указан параметр `requiredConsistency: false`, но `qemu-guest-agent` при этом запущен, будет акже предпринята попытка заморозки файловой системы, чтобы снимок получился консистентным.
28232822

2824-
- ВМ запущена, и в гостевой ОС не установлен или не запущен `qemu-guest-agent`;
2825-
- в манифесте снимка явно указан параметр `requiredConsistency: false`, и требуется избежать приостановки работы файловой системы.
2823+
QEMU Guest Agent поддерживает скрипты hooks, которые позволяют подготовить приложения к созданию снимка без остановки сервисов, обеспечивая согласованное состояние на уровне приложений. Подробнее о настройке скриптов hooks см. в разделе [«Агент гостевой ОС»](#агент-гостевой-ос).
28262824

28272825
{{< alert level="warning" >}}
28282826
При восстановлении из такого снимка возможны проблемы с целостностью файловой системы, поскольку состояние данных может быть не согласовано.

0 commit comments

Comments
 (0)