Volume Management

Volume commands

create, create volume in a storage pool.

Parameters:
–stor_pool (-p): [required] storage pool name
–name (-n): [required] volume name for creating volume
–size (-s): [required] volume size for creating volume
–quota (-q): [optional] volume quota for creating volume, quota is no sense for RAW volume.
–format (-f) : [required] volume format:raw|thin|ls.
–help (-h) : [no argument] show help message.

Volume format could be
raw: RAW volume.
thin: Thin Provisioning volume.
log: Log Structured Volume.

flexsds volume create --stor_pool all-flash-pool --size 1T --quota 1T --name test_vol1 --format raw

list, list all volumes in a storage pool.

Parameters:
–stor_pool (-p) : [required] storage pool name

flexsds volume list --stor_pool all-flash-pool

Command will show like this:

remove, remove existing volume in a storage pool.

Parameters:
–stor_pool (-p) : [required] storage pool name
–name (-n) : [required] volume name will be removed.

flexsds volume remove --stor_pool all-flash-pool —volume test_vol1

attach, attach a SAN target (iSCSI, iSER or NVMe-oF) to a volume.

Parameters:
—stor_pool (-p) : [required] storage pool name
–volume (-v) : [required] volume name
–interface (-i) : [required] target interface: iscsi | iser | nvmf
–vqn (-n) : [required] iqn for iSCSI/iSER, nqn for NVMe-oF

Target interface can be iSCSI, ISER, or NVMF

flexsds volume attach --stor_pool all-flash-pool --volume test_vol1 --interface iscsi --vqn iqn.abc2
flexsds volume attach --stor_pool all-flash-pool --volume test_vol1 --interface nvmf --vqn nqn.abc2

detach, detach a SAN target to a volume.

Parameters:
—stor_pool (-p) : [required] storage pool name
–volume (-v) : [required] volume name
–interface (-i) : [required] target interface: iscsi | iser | nvmf
–vqn (-n) : [required] iqn for iSCSI/iSER, nqn for NVMe-oF
–force (-o) : [required] force remove the target event if it has connections.

flexsds volume detach --stor_pool all-flash-pool --volume test_vol1 --interface iscsi --vqn iqn.abc2 -o

 

add_acl, Add item to volume access control list

Parameters:
–stor_pool (-p) : [required] storage pool name
–volume (-v) : [required] volume name
–type (-t) : [required] type: chap|ip|host
–data (-d) : [required] chap user:pass, IP address, host initiator name
–access (-a) : [required] access: 0 for full, 1 for readonly

for chap, data could be CHAP secret, for ip, data is IP address, and for host, data is host’s initiator name.
flexsds volume add_acl --stor_pool all-flash-pool --volume test_vol1 —type chap —data 1234567890 —access 0
flexsds volume add_acl --stor_pool all-flash-pool --volume test_vol1 —type ip —data 192.168.80.100 —access 0

list_acl, List all items in specified volume’s access control list.

Parameters:
–stor_pool (-p) : [required] storage pool name
–volume (-v) : [required] volume name

flexsds volume list_acl --stor_pool all-flash-pool --volume test_vol1

del_acl, Remove specified ACL item in volume’s access control list.

Parameters:
–stor_pool (-p) : [required] storage pool name
–volume (-v) : [required] volume name
–acl_id (-i) : [required] ACL ID

flexsds volume del_acl --stor_pool all-flash-pool --volume test_vol1 —acl_id 1

add_rep, Create remote replication to specified volume

Parameters:
–stor_pool (-p) : [required] storage pool name
–volume (-v) : [required] volume name
–url (-u) : [required] URL of remote iSCSI/iSER/NVMe-oF device
–chap (-c) : [required] chap name for iSCSI or iSER
–secret (-s) : [required] chap user secret

URL format:
protocol://host/iqn/lun, for example: iscsi://192.168.80.100/iqn.tgt./0, iser://192.168.80.100/iqn.tgt./0 nvmf://192.168.80.100/iqn.tgt./0

flexsds volume add_rep --stor_pool all-flash-pool --volume test_vol1 —url nvmf://192.168.80.100/iqn.tgt./0
For iSCSI and iSER remote replication, user can specify CHAP if the remote device require it.

list_rep, List all remote replications on specified volume.

Parameters:
–stor_pool (-p) : [required] storage pool name
–volume (-v) : [required] volume name

flexsds volume list_rep --stor_pool all-flash-pool --volume test_vol1

del_rep, Remove specifed remote replication from volume.

Parameters:
–stor_pool (-p) : [required] storage pool name
–volume (-v) : [required] volume name
—rep_id (-i) : [required] Replication service ID

flexsds volume del_rep --stor_pool all-flash-pool --volume test_vol1 —rep_id 1

rep_op, Perform operations on remote replication

Parameters:
–stor_pool (-p) : [required] storage pool name
–volume (-v) : [required] volume name
–rep_id (-i) : [required] Replication service ID
–op (-o) : [required] Operation: sync|verify|clear|cancel|repair

Operation can be:
sync: Perform full sync from volume to remote target, operation may take long time by depending on volume size.
verify: Perform data consistency check between local volume and remote target, operation may take long time by depending on volume size.
clear: After performed sync, verify, operating status will be reported, clear mean clear those status.
cancel: Cancel sync or verify operation.
repair: Once remote target changed (target name or address etc.), use repair to fix connection.

flexsds volume rep_op --stor_pool all-flash-pool --volume test_vol1 —rep_id 1 —op sync