Creating a filesystem from a snapshot using the CLI

Content Software for File CLI Reference

Version
4.2.x
Audience
anonymous
Part Number
MK-HCSF001-03

Command

weka fs download

Use the following command line to create a filesystem from an existing snapshot:

weka fs download <name> <group-name> <total-capacity> <ssd-capacity> <obs> <locator>

Parameters

Name Type Value Limitations Mandatory Default
name String Name of the filesystem to be created   Yes  
group-name String Name of the filesystem group in which the new filesystem will be placed   Yes  
total-capacity Capacity Total capacity of the downloaded filesystem   Yes  
ssd-capacity Capacity SSD capacity of the downloaded filesystem   Yes  
obs String Object store name for tiering   Yes  
locator String Object store locator obtained from a previously successful snapshot upload   Yes  
additional-obs String An additional objec-store name. In case te data to recover resides in two object stores (a second object-store attached to the filesystem, and the filesystem has not undergone full migration). This object-store will be attached in a read-only mode. The snapshot locator must reside in the primary object-store supplied in the obs parameter No  
snapshot-name String The downloaded snapshot name.   No The uploaded snapshot name
access-point String The downloaded snapshot access point   No The uploaded access point

The locator is either a locator saved previously for disaster scenarios, or can be obtained using the weka fs snapshot command on a system with a live filesystem with snapshots.

Note:
  • Due to the bandwidth characteristics and potential costs when interacting with remote object stores it is not allowed to download a filesystem from a remote object-store bucket. If a snapshot on a local object-store bucket exists, it is advisable to use that one. Otherwise, follow the procedure in Recover from a remote snapshot.
  • For encrypted filesystem, when downloading the same KMS master-key should be used to decrypt the snapshot data. For more information about encryption, see KMS management in the Content Software for File User Guide.