lbcli Create Volume

Creates a volume with a specified unique name, size (capacity), and replication factor (valid values: 1, 2 or 3). Please note that in Lightbits SDS it is recommended to use only replication factor 3 in order to keep data integrity and durability. RF 1 and 2 should only be used for non-critical data that can sustain data loss.

An Access Control List (ACL) must also be applied to the created volume in order to limit access to specific clients. Using ALLOW_ANY will enable any client to discover and connect to the volume (this should be used based on your security requirements).

This example command creates a volume with 2GB of capacity, an ACL string of “acl3”, and a replication factor of 3.

Examples

$ lbcli -J $LIGHTOS_JWT create volume --size="2 Gib" --name=vol4 --acl="acl3" --replica-count=3 --project-name=default

Sample Output

Name UUID State Size Replicas ACL

​

vol4 76c3eae8-7ade-4394-82e5-056d05a92b5e Creating 2.0 GiB 3 values:"acl3"

A volume can also be created to store all compressed data, in order to increase capacity. Use the same create volume commands to create a volume with compression enabled (true).

Sample Command

$ lbcli -J $LIGHTOS_JWT create volume --size="1 Tib" --name=vol2 --acl="acl1" --replica-count=3 --compression=true --project-name=default

Sample Output

Name UUID State Protection State NSID Size Replicas Compression ACL Rebuild Progress

​

vol2 105624dd-c96f-4668-a2a2-da0b754ac462 Creating NotAvailable 0 1.0 TiB 3 true values:"acl1"

The sample output is standard when using the lbcli immediately after executing the create command. The output indicates that the volume is being created with the values provided. If you wait a few seconds the state should change to available and protection to fully protected.