本地卷
单机版
./stor lun add { -n | --name } LUN_NAME { -p | --capacity } CAPACITY { -t | --target } TARGET_NAME [ { -o | --sector-size } SECTOR_SIZE ] [ { -w | --write-policy } WRITE_POLICY ] [ { -P | --path } PATH ] [ { { -m | --mode } STORAGE_MODE ]集群版
./stor lun add { -n | --name } LUN_NAME { -p | --capacity } CAPACITY { -t | --target } TARGET_NAME [ --priority SERVER_ID &<1- n > [ --auto-failback AUTO_FAILBACK ] ] [ --pool POOL ] [ --cache-pool CACHE_POOL ] [ { -a | --ha } HIGH_AVAILABILITY ] [ { -c | --local-storage-class } LOCAL_STORAGE_CLASS ] [ --min-replica MIN_REPLICA ] [ --redundancy-overlap REDUNDANCY_OVERLAP ] [ --ec-fragment-size EC_FRAGEMENT_SIZE ] [ { -o | --sector-size } SECTOR_SIZE ] [ { -w | --write-policy } WRITE_POLICY ] [ { -m | --mode } STORAGE_MODE ]
上云卷
单机版
./stor lun add { -n | --name } LUN_NAME { -p | --capacity } CAPACITY { -t | --target } TARGET_NAME [ { -o | --sector-size } SECTOR_SIZE ] [ { -w | --write-policy } WRITE_POLICY ] [ { -P | --path } PATH ] { -m | --mode } STORAGE_MODE [ --cloud-provider *CLOUD_PROVIDER ] { -B | --bucket } BUCKET_NAME { -A | --ak } ACCESS_KEY { -S | --sk } S*ECRET_KEY [ { -C | --cloud-storage-class } CLOUD_STORAGE_CLASS ] { -E | --endpoint } ENDPOINT [ --sign-version VERSION ] [ --region REGION ] [ { -M | --cloud-compression } CLOUD_COMPRESSION ] [ { -O | --object-size } OBJECT_SIZE ] [ { -X | --prefix } PREFIX ]集群版
./stor lun add { -n | --name } LUN_NAME { -p | --capacity } CAPACITY { -t | --target } TARGET_NAME [ --priority SERVER_ID &<1- n > [ --auto-failback AUTO_FAILBACK ] ] [ --pool POOL ] [ --cache-pool CACHE_POOL ] [ { -a | --ha } HIGH_AVAILABILITY ] [ { -c | --local-storage-class } LOCAL_STORAGE_CLASS ] [ --min-replica MIN_REPLICA ] [ --redundancy-overlap REDUNDANCY_OVERLAP ] [ --ec-fragment-size EC_FRAGEMENT_SIZE ] [ { -o | --sector-size } SECTOR_SIZE ] [ { -w | --write-policy } WRITE_POLICY ] { -m | --mode } STORAGE_MODE [ --cloud-provider CLOUD_PROVIDER ] { -B | --bucket } BUCKET_NAME { -A | --ak } ACCESS_KEY { -S | --sk } SECRET_KEY [ { -C | --cloud-storage-class } CLOUD_STORAGE_CLASS ] { -E | --endpoint } ENDPOINT [ --sign-version VERSION ] [ --region REGION ] [ { -M | --cloud-compression } CLOUD_COMPRESSION ] [ { -O | --object-size } OBJECT_SIZE ] [ { -X | --prefix } PREFIX ]
此命令用来创建卷。
说明
- HBlock上Target IQN的数量最多32766个。一个Target最多可以关联256个卷，但是一个卷只能被一个Target关联。
- 卷创建成功后，仅下列参数可以修改：卷容量、写策略、最小副本数（仅集群版支持）、折叠副本数（仅集群版支持）、主备优先级（仅集群版支持）、Endpoint、上云签名认证版本、区域、AK/SK、是否压缩数据。
参数
| 参数 | 描述 |
|---|---|
| -n LUN_NAME 或 --name LUN_NAME | 设置卷名称。 取值：字符串形式，长度范围是1~16，只能由字母、数字和短横线（-）组成，字母区分大小写，且仅支持以字母或数字开头。 |
| -p CAPACITY 或 --capacity CAPACITY | 设置卷容量。 取值：整数形式，数字后面可以输入单位简写G/g、T/t或P/p，分别代表GiB、TiB、PiB，如果不输入，默认为GiB。
|
| -t TARGET_NAME 或 --target TARGET_NAME | 指定iSCSI Target名称。 取值：字符串形式，长度范围1~16，只能由小写字母、数字、句点(.)和短横线(-)组成，且仅支持以字母或数字开头。 说明 创建卷时，如果指定的iSCSI Target名称不存在，那么同时创建iSCSI Target，新创建iSCSI Target的回收策略默认为Delete。 |
| --priority SERVER_ID &<1-n> | 指定卷主备分布优先级的服务器ID（仅集群版支持），系统会根据指定的服务器ID顺序来选择卷的主备IQN。可以指定一个或者多个服务器ID，以英文逗号分开。 前置条件：iSCSI Target名称已经存在，且指定的服务器必须是iSCSI Target所在的服务器。 |
| --auto-failback AUTO_FAILBACK | 是否根据指定的卷主备分布优先级自动进行主备切换（仅集群版支持），即针对卷主备状态，当高优先级的服务器恢复正常后，是否自动进行主备状态切换。 取值：
默认值为Enabled。 |
| --pool POOL | 指定存储池（仅集群版支持），表示最终存储池，卷数据最终落在该存储池内。默认使用集群的基础存储池。 |
| --cache-pool CACHE_POOL | 指定缓存存储池（仅集群版支持）。如果指定了缓存存储池，卷数据首先写入缓存存储池，然后再存入存储池。 注意 存储池与缓存存储池不能是同一个存储池。 |
| -a HIGH_AVAILABILITY 或 --ha HIGH_AVAILABILITY | 选择卷的高可用类型（仅集群版支持）： 取值：
默认值为ActiveStandby（as）。 |
| -c LOCAL_STORAGE_CLASS 或 --local-storage-class LOCAL_STORAGE_CLASS | 卷冗余模式（仅集群版支持）。 取值：
默认值为EC 2+1。 说明 以下场景均为集群可用的前提下：
|
| --min-replica MIN_REPLICA | 最小副本数（仅集群版支持）。 对于副本模式的卷，假设卷副本数为X，最小副本数为Y（Y必须≤X），该卷每次写入时，至少Y份数据写入成功，才视为本次写入成功。对于EC N+M模式的卷，假设该卷最小副本数设置为Y（必须满足N≤Y≤N+M），必须满足总和至少为Y的数据块和校验块写入成功，才视为本次写入成功。 取值：整数。对于副本卷，取值范围是[1, N]，N为副本模式卷的副本数，默认值为1。对于EC卷，取值范围是[N, N+M]，默认值为N。 |
| --redundancy-overlap REDUNDANCY_OVERLAP | 指定卷的折叠副本数（仅集群版支持）。在数据冗余模式下，同一份数据的不同副本/分片默认分布在不同的故障域，当故障域损坏时，允许根据卷的冗余折叠原则，将多份数据副本放在同一个故障域中，但是分布在不同的path上。 注意 如果存储池故障域级别为path，此参数不生效。 取值：整数。对于副本卷，取值范围是[1, N]，N为副本模式卷的副本数，默认值为1；对于EC模式，取值范围是[1, N+M]，默认值为1。 |
| --ec-fragment-size EC_FRAGEMENT_SIZE | 纠删码模式分片大小。卷冗余模式为EC模式时，此设置才生效，否则忽略。 取值：1、2、4、8、16、32、64、128、256、512、1024、2048、4096，单位是KiB。默认值为16。 |
| -o SECTOR_SIZE 或 --sector-size SECTOR_SIZE | 设置扇区大小。 取值：512、4096，单位为字节。默认值为4096。 说明 扇区大小的选取：根据自身业务场景，一般情况下，单次I/O操作的数据大小大于或接近4KiB，则推荐选择4096；单次I/O操作的数据大小接近512Bytes，则推荐选择512。如果对接VMware等虚拟化平台，则推荐选择512Bytes。 |
| -w WRITE_POLICY 或 --write-policy WRITE_POLICY | 卷的写策略：
默认值为WriteBack（wb）。 |
| -P PATH 或 --path PATH | 指定存储卷数据的数据目录（仅单机版支持）。 如果创建卷时不指定数据目录，使用服务器设置的默认数据目录。 |
| -m STORAGE_MODE 或 --mode STORAGE_MODE | 设置卷的存储类型：
存储类型默认为Local。 |
| --cloud-provider CLOUD_PROVIDER | 对象存储服务名称：
默认值为OOS。 |
| -B BUCKET_NAME 或 --bucket BUCKET_NAME | 已存在的存储桶的名称。 注意 请勿开启Bucket的生命周期设定和合规保留。 |
| -A ACCESS_KEY 或 --ak ACCESS_KEY | 对象存储服务的AccessKeyID。 |
| -S SECRET_KEY 或 --sk SECRET_KEY | 对象存储服务的SecretAccessKey。 |
| -C CLOUD_STORAGE_CLASS 或 --cloud-storage-class CLOUD_STORAGE_CLASS | 设置数据在对象存储的存储类型：
默认为STANDARD。 |
| -E ENDPOINT 或 --endpoint ENDPOINT | 设置对象存储的Endpoint。具体OOS Endpoint详见OOS Endpoint和区域。 |
| --sign-version VERSION | 指定上云签名认证的类型：
默认值为v2。 |
| --region REGION | 表示Endpoint资源池所在区域。具体region详见OOS Endpoint和区域。 V4签名时，此项必填。 |
-M CLOUD_COMPRESSION 或 --cloud-compression CLOUD_COMPRESSION
| 是否压缩数据上传至对象存储：
默认值为Enabled（on）。 |
| -O OBJECT_SIZE 或 --object-size OBJECT_SIZE | 数据存储在对象存储中的大小。 取值：128、256、512、1024、2048、4096、8192，单位是KiB。默认值为1024。 |
| -X PREFIX 或 --prefix PREFIX | 设置对象存储中的前缀名称，设置前缀名称后，卷数据会存在存储桶以前缀命名的类文件夹中。如果未指定前缀，则直接存储在以卷名称命名的类文件夹中。 取值：字符串形式，长度范围是1~256。 |
示例
示例1
单机版本地卷：创建卷lun1，容量为10 GiB，Target为target1，卷数据存储在数据目录/mnt/storage01上。
[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor lun add -n lun1 -t target1 -p 10 -P /mnt/storage01
Created LUN lun1 successfully.示例2
集群版本地卷：创建卷lun1，容量为10 GiB，Target为target1，卷冗余模式为3-copy。
[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor lun add -n lun1 -t target1 -p 10 -c 3-copy
Created LUN lun1 successfully.示例3
集群版本地卷：创建卷lun01a，容量为100 GiB，Target为target01，卷冗余模式为EC 2+1，分片为32 KiB。
[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor lun add -n lun01a -t target01 -c EC 2+1 --ec-fragment-size 32 -p 100
Created LUN lun01a successfully.示例4
单机版上云卷：创建卷luna2，容量为110 GiB，Target为targeta，卷的存储类型为Storage，使用V4签名认证，存储前缀为hblock。
[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor lun add -n luna2 -t targeta -p 110 -m Storage -B hblocktest3 -E oos-cn.ctyunapi.cn -A cb22b08b1f9229f85874 -S ***************** --sign-version v4 --region cn -X hblock
Created LUN luna2 successfully.示例5
集群版上云卷：创建卷lun03a，容量为1000 GiB，Target为target03，卷冗余模式为EC 2+1，分片为32 KiB，卷的存储类型为Cache，使用V4签名认证。
[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor lun add -n lun03a -t target03 -c EC 2+1 --ec-fragment-size 32 -p 1000 -m Cache -B hblocktest1 -E oos-cn.ctyunapi.cn -A 9fe711b8b89ad73c2a46 -S ***************** --sign-version v4 --region cn
Created LUN lun03a successfully.
