Create the first filesystem

Content Software for File CLI Reference

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

A filesystem must reside in a filesystem group, so first, create a filesystem group:

# to create a new filesystem group
$ weka fs group create my_fs_group
FSGroupId: 0

# to view existing filesystem groups details in the Weka system
$weka fs group
FileSystem Group ID | Name        | target-ssd-retention | start-demote
--------------------+-------------+----------------------+-------------
FSGroupId: 0        | my_fs_group | 1d 0:00:00h          | 0:15:00h

Then, you can create a filesystem within that group:

# to create a new filesystem
$ weka fs create new_fs my_fs_group 1TiB
FSId: 0

# to view existing filesystems details in the Weka system
$ weka fs
Filesystem ID | Filesystem Name | Group       | Used SSD (Data) | Used 
--------------+-----------------+-------------+---------------------------------
0             | new_fs          | my_fs_group | 0 B             | 4.09


SSD (Meta) | Used SSD | Free SSD | Available SSD (Meta) | Available SSD
+-----------------+----------+----------+------------------------------
KB         | 4.09 KB  | 1.09 TB  | 274.87 GB            | 1.09 TB     


 | Used Total (Data) | Used Total | Free Total | Available Total |  
+---------------+-------------------+------------+-----------------
 | 0 B               | 4.09 KB    | 1.09 TB    | 1.09 TB         | 


Max Files | Status | Encrypted | Object Storages | Auth Required
+-----------------+-----------+--------+-----------+------------
22107463  | READY  | False     |                 | False
Note: In AWS installation via the self-service portal, default filesystem group and filesystem are created. The default filesystem is created with the entire SSD capacity.

For creating an additional filesystem, it is first needed to decrease the default filesystem SSD size:

# to reduce the size of the default filesystem
$ weka fs update default --total-capacity 1GiB

# to create a new filesystem in the default group
$ weka fs create new_fs default 1GiB

# to view existing filesystems details in the Weka system
$ weka fs
Filesystem ID | Filesystem Name | Group   | Used SSD (Data) | Used SSD 
--------------+-----------------+---------+---------------------------
0             | default         | default | 0 B             | 4.09 KB 
1             | new_fs          | default | 0 B             | 4.09 KB    


(Meta) | Used SSD | Free SSD | Available SSD (Meta) | Available SSD | +-----------------+----------+----------+------------------------------
       | 4.09 KB  | 1.07 GB  | 268.43 MB            | 1.07 GB       |  
       | 4.09 KB  | 1.09 TB  | 274.87 GB            | 1.09 TB       |    


Used Total (Data) | Used Total | Free Total | Available Total | Max +-----------------+-----------+--------+-----------+-----------------
0 B               | 4.09 KB    | 1.07 GB    | 1.07 GB         | 21589    0 B               | 4.09 KB    | 1.09 TB    | 1.09 TB         | 22107463  


 Files | Status | Encrypted | Object Storages | Auth Required
+-------------------------------------------------------------
       | READY  | False     |                 | False
       | READY  | False     |                 | False

For more information about filesystems and filesystem groups, refer to Managing Filesystems, Object Stores & Filesystem Groups.