Snapshots
Snapshots allow the saving of a filesystem state to a .snapshotsdirectory located under the root filesystem. They can be used for:
Physical Backup: The snapshot directory can be copied into a different storage system, possibly on another site, using either the Weka system Snap-To-Object feature or a third-party software.
Logical Backup: Periodic snapshots enable filesystem restoration to a previous state if logical data corruption occurs.
Archive: Periodic snapshots enable the accessing of a previous filesystem state for compliance or other needs.
DevOps Environments: Writable snapshots enable the execution of software tests on copies of the data.
Snapshots have practically no impact on system performance and can be taken for each filesystem while applications are running. They consume minimal space, according to the actual differences between the filesystem and the snapshots, or between the snapshots, in 4K granularity. By default, snapshots are read-only, and any attempts to change the contents of a read-only snapshot returns an error message. It is possible to create a writable snapshot or update an existing snapshot to be writable. However, a writable snapshot cannot be updated to be read-only.
The Weka system supports the following snapshot operations:
Viewing snapshots
Creating a snapshot of an existing filesystem
Deleting a snapshot
Accessing a snapshot under a dedicated directory name
Restoring a filesystem from a snapshot
Making snapshots writable
Creating a snapshot of a snapshot (relevant for writable snapshots, or for read-only snapshots before being made writable)
Listing of snapshots and obtaining their metadata
Note: The number of snapshots per system is limited to 4,096 (the live filesystem consumes one of the total snapshots count).
Note: The .snapshots directory is not listed. Running ls on the root of the filesystem will not show the .snapshots directory, however, it can be explicitly accessed, e.g. using the cd .snapshots command.
To view the snapshot of a filesystem, click the filesystem Manage Snapshots button.
If the filesystem is tiered, this screen is slightly different and includes an additional button (Upload to Object) and a corresponding Object Status value, as shown below:
Command: weka fs snapshot
This command is used to display all snapshots of all filesystems in a single table.
From the main snapshot view screen, click Create Snapshot at the top right-hand side of the required filesystem snapshot screen. The Create Snapshot dialog box will be displayed.
Enter the name and access point, determine whether it is writable and the source (the current filesystem or another snapshot). Then click Create to create the snapshot.
Command: weka fs snapshot create
Use the following command line to add a snapshot:
weka fs snapshot create <file-system> <name> [--access-point access-point] [--source-snap=<source-snap>] [--is-writable]
Parameters in Command Line
Name | Type | Value | Limitations | Mandatory | Default |
| String | A valid filesystem identifier | Must be a valid name | Yes | |
| String | Unique name for filesystem snapshot | Must be a valid name | Yes | |
| String | Name of the newly-created directory for filesystem-level snapshots, which will serve as the access point for the snapshots | Must be a valid name | No | Controlled by |
| String | Must be an existing snapshot | Must be a valid name | No | Filesystem snapshot the file system |
| Boolean | Sets the created snapshot to be writable | | No | False |
In the main snapshot view screen, select the filesystem to be deleted and click Delete. The Snapshot Deletion window will be displayed.
Click Delete to delete the selected snapshot.
Command: weka fs snapshot delete
Use the following command line to delete a snapshot:
weka fs snapshot delete <file-system> <name>
Parameters in Command Line
Name | Type | Value | Limitations | Mandatory | Default |
| String | A valid filesystem identifier | Must be a valid name | Yes | |
| String | Unique name for filesystem snapshot | Must be a valid name | Yes | |
In the main snapshot view screen, select the filesystem snapshot to be restored and click Restore To. The Select Where to Restore window will be displayed.
Select the filesystem snapshot restore destination and click Restore.
Commands: weka fs restore or weka fs snapshot copy
Use the following command line to restore a filesystem from a snapshot:
weka fs restore <file-system> <source-name>
Use the following command line to restore a snapshot to another snapshot:
weka fs snapshot copy <file-system> <source-name> <destination-name>
Parameters in Command Lines
Name | Type | Value | Limitations | Mandatory | Default |
| String | A valid filesystem identifier | Must be a valid name | Yes | |
| String | Unique name for the source of the snapshot | Must be a valid name | Yes | |
| String | Name of the destination to which the snapshot should be copied | Must be an existing snapshot | Yes | |
Note: When restoring a filesystem from a snapshot (or copying over an existing snapshot), the filesystem data and metadata are changed. Make sure IOs to the filesystem are stopped during this time.
In the main snapshot view screen, select the filesystem snapshot to be updated and click Edit. The Update Snapshot window will be displayed.
Enter the name and access point, determine whether the snapshot is writable, and then click Update to update the snapshot.
Command: weka fs snapshot update
This command changes the snapshot attributes. Use the following command line to update an existing snapshot:
weka fs snapshot update <file-system> <name> [--new-name=<new-name>] [--is-writable] [--access-point=<access-point>]
Parameters in Command Line
Name | Type | Value | Limitations | Mandatory | Default |
| String | A valid filesystem identifier | Must be a valid name | Yes | |
| String | Unique name for the updated snapshot | Must be a valid name | Yes | |
| String | New name for the updated snapshot | Must be a valid name | No | |
| Boolean | Sets the snapshot to be writable | | No | |
| String | Name of a directory for the snapshot, which will serve as the access point for the snapshot | Must be a valid name | No | |
Note the following concerning working with snapshots:
When moving a file in or out of a snapshot directory, or between snapshots, the kernel will implement the move operation as a copy operation, similar to moving a file between two different filesystems. Such operations for directories will fail.
If symbolic links are accessed via the
.snapshotsdirectory, the symlinks with absolute paths can lead to the current filesystem. Consequently, depending on the usage, it may be preferable not to follow symlinks or to use relative paths.
