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:

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   # 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

   Copy to Clipboard Toggle word wrap
   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:

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

   Copy to Clipboard Toggle word wrap

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

   # 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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

Verification

1. List the file system belonging to the pool:

   # stratis filesystem list my-pool

   Copy to Clipboard Toggle word wrap

Procedure

1. Unmount the snapshot:

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

   Copy to Clipboard Toggle word wrap

2. Destroy the snapshot:

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

   Copy to Clipboard Toggle word wrap