From 4b1186f5345b3d0dcca7093fb1b810884f103372 Mon Sep 17 00:00:00 2001 From: Maciek Borzecki Date: Thu, 25 Jun 2026 17:14:12 +0200 Subject: [PATCH 1/3] docs: extend notes on the recommended state of services during snapshot operations Extend notes on the recommended state of services and applications when saving or restoring snapshots. Signed-off-by: Maciek Borzecki --- docs/how-to-guides/manage-snaps/create-data-snapshots.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/how-to-guides/manage-snaps/create-data-snapshots.md b/docs/how-to-guides/manage-snaps/create-data-snapshots.md index 5667f50..6dfb528 100644 --- a/docs/how-to-guides/manage-snaps/create-data-snapshots.md +++ b/docs/how-to-guides/manage-snaps/create-data-snapshots.md @@ -18,6 +18,8 @@ Set Snap Age Version Rev Size Notes 30 vlc 529ms 3.0.6 770 882kB - ``` +> Before using this command, in order to ensure consistency of saved data, it is recommended to stop all applications and services of the snap (`snap stop `). Start them again once the snapshot has been saved. + Each snapshot has a unique ID, or revision, shown in the *Set* column above. This value is unique to each *save* operation, regardless of the number of snaps it includes. *Age* is the period of time since the snapshot was created, while *Version* and *Rev* refer to the specific snap at the time of the snapshot. *Size* is the amount of storage used by a snapshot. If you'd rather not wait for the *save* operation to complete before regaining access to your terminal, add the `--no-wait` argument. @@ -102,8 +104,7 @@ $ sudo snap restore 30 Restored snapshot #30. ``` -Before using this command, make sure you have the snap application installed, and that its services, if any, are stopped (`snap stop `). -Start them again once the snapshot has been successfully restored. +> Before using this command, make sure you have the snap installed, and that its applications and services, if any, are stopped (`snap stop `). Start them again once the snapshot has been successfully restored. By default, this command restores all the data for all the snaps in a snapshot. You can restore data for specific snaps by simply listing them after the command and for specific users with the `--users=` argument. From c5df80a4216804982a9ee9725a3602346beca43e Mon Sep 17 00:00:00 2001 From: Maciek Borzecki Date: Fri, 26 Jun 2026 07:50:33 +0200 Subject: [PATCH 2/3] fixup! docs: extend notes on the recommended state of services during snapshot operations --- docs/how-to-guides/manage-snaps/create-data-snapshots.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/how-to-guides/manage-snaps/create-data-snapshots.md b/docs/how-to-guides/manage-snaps/create-data-snapshots.md index 6dfb528..8724a87 100644 --- a/docs/how-to-guides/manage-snaps/create-data-snapshots.md +++ b/docs/how-to-guides/manage-snaps/create-data-snapshots.md @@ -18,7 +18,9 @@ Set Snap Age Version Rev Size Notes 30 vlc 529ms 3.0.6 770 882kB - ``` -> Before using this command, in order to ensure consistency of saved data, it is recommended to stop all applications and services of the snap (`snap stop `). Start them again once the snapshot has been saved. +```{caution} +Before using this command, in order to ensure consistency of saved data, make sure to stop all applications and services of the snaps included in the snapshot (`snap stop `). Start them again once the snapshot has been saved. +``` Each snapshot has a unique ID, or revision, shown in the *Set* column above. This value is unique to each *save* operation, regardless of the number of snaps it includes. *Age* is the period of time since the snapshot was created, while *Version* and *Rev* refer to the specific snap at the time of the snapshot. *Size* is the amount of storage used by a snapshot. @@ -104,7 +106,9 @@ $ sudo snap restore 30 Restored snapshot #30. ``` -> Before using this command, make sure you have the snap installed, and that its applications and services, if any, are stopped (`snap stop `). Start them again once the snapshot has been successfully restored. +```{caution} +Before using this command, make sure you have the snap installed, and that its applications and services, if any, are stopped (`snap stop `). Start them again once the snapshot has been successfully restored. +``` By default, this command restores all the data for all the snaps in a snapshot. You can restore data for specific snaps by simply listing them after the command and for specific users with the `--users=` argument. From f7870dc1c623fdc9b65ea86bcdc9ba88c21618d6 Mon Sep 17 00:00:00 2001 From: Maciek Borzecki Date: Fri, 26 Jun 2026 08:04:56 +0200 Subject: [PATCH 3/3] fixup! docs: extend notes on the recommended state of services during snapshot operations --- docs/how-to-guides/manage-snaps/create-data-snapshots.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/how-to-guides/manage-snaps/create-data-snapshots.md b/docs/how-to-guides/manage-snaps/create-data-snapshots.md index 8724a87..cecbe04 100644 --- a/docs/how-to-guides/manage-snaps/create-data-snapshots.md +++ b/docs/how-to-guides/manage-snaps/create-data-snapshots.md @@ -19,7 +19,7 @@ Set Snap Age Version Rev Size Notes ``` ```{caution} -Before using this command, in order to ensure consistency of saved data, make sure to stop all applications and services of the snaps included in the snapshot (`snap stop `). Start them again once the snapshot has been saved. +Before using this command, stop any services for the snaps included in the snapshot (`snap stop `) and close any running applications provided by those snaps. Start them again once the snapshot has been saved. ``` Each snapshot has a unique ID, or revision, shown in the *Set* column above. This value is unique to each *save* operation, regardless of the number of snaps it includes. *Age* is the period of time since the snapshot was created, while *Version* and *Rev* refer to the specific snap at the time of the snapshot. *Size* is the amount of storage used by a snapshot. @@ -107,7 +107,7 @@ Restored snapshot #30. ``` ```{caution} -Before using this command, make sure you have the snap installed, and that its applications and services, if any, are stopped (`snap stop `). Start them again once the snapshot has been successfully restored. +Before using this command, make sure the snap is installed, then stop its services (`snap stop `) and close any running applications provided by that snap. Start them again once the snapshot has been successfully restored. ``` By default, this command restores all the data for all the snaps in a snapshot. You can restore data for specific snaps by simply listing them after the command and for specific users with the `--users=` argument.