Chapter 26. Using snapshots on Stratis file systems

Procedure

1. Optional: Back up the current state of the file system to be able to access it later:

   Copy to Clipboard Toggle word wrap

   # stratis filesystem snapshot my-pool my-fs my-fs-backup

2. Schedule a revert of your file system to the previously taken snapshot:

   Copy to Clipboard Toggle word wrap

   # stratis filesystem schedule-revert my-pool my-fs-snapshot

3. Optional: Run the following to check if the revert is scheduled successfully:

   Copy to Clipboard Toggle word wrap

   # stratis filesystem list my-pool --name my-fs-snapshot
   UUID: b14987eb-b735-4c68-8962-f53f6b644cbc
   Name: my-fs-snapshot
   Pool: my-pool
   
   Device: /dev/stratis/p1/my-fs-snapshot
   
   Created: Mar 18 2025 12:29
   
   Snapshot origin: f5a881b1-299d-4147-8ead-b4a56c623692
   Revert scheduled: Yes
   
   Sizes:
   Logical size of thin device: 1 TiB
   Total used (including XFS metadata): 5.42 GiB
   Free: 1018.58 GiB

   Note

   It is not possible to schedule more than one revert operation into the same origin filesystem. Also, if you try to destroy either the origin file system, or the snapshot to which the revert is scheduled, the destroy operation fails.

   You can also cancel the revert operation any time before you restart the pool:

   Copy to Clipboard Toggle word wrap

   # stratis filesystem cancel-revert my-pool my-fs-snapshot

   You can run the following to check if the cancellation is scheduled successfully:

   Copy to Clipboard Toggle word wrap

   # stratis filesystem list my-pool --name my-fs-snapshot
   UUID: b14987eb-b735-4c68-8962-f53f6b644cbc
   Name: my-fs-snapshot
   Pool: my-pool
   
   Device: /dev/stratis/p1/my-fs-snapshot
   
   Created: Mar 18 2025 12:29
   
   Snapshot origin: f5a881b1-299d-4147-8ead-b4a56c623692
   Revert scheduled: No
   
   Sizes:
   Logical size of thin device: 1 TiB
   Total used (including XFS metadata): 5.42 GiB
   Free: 1018.58 GiB
   
   Size Limit: None

   If not cancelled, the scheduled revert will proceed when you restart the pool:

   Copy to Clipboard Toggle word wrap

   # stratis pool stop --name my-pool
   # stratis pool start --name my-pool

Verification

1. List the file system belonging to the pool:

   Copy to Clipboard Toggle word wrap

   # stratis filesystem list my-pool

Procedure

1. Unmount the snapshot:

   Copy to Clipboard Toggle word wrap

   # umount /dev/stratis/my-pool/my-fs-snapshot

2. Destroy the snapshot:

   Copy to Clipboard Toggle word wrap

   # stratis filesystem destroy my-pool my-fs-snapshot