单机版:
./stor lun { C | clone } { -n | --name } LUN_NAME { -s | --snapshot } SNAPSHOT_NAME { -t | --target } TARGET_NAME [ { -p | --capacity } CAPACITY ] [ { -o | --sector-size } SECTOR_SIZE ] [ { -w | --write-policy } WRITE_POLICY ] [ { -P | --path } PATH ]
集群版:
./stor lun { C | clone } { -n | --name } LUN_NAME { -s | --snapshot } SNAPSHOT_NAME { -t | --target } TARGET_NAME [ { -p | --capacity } CAPACITY ] [ --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 ]
此命令用来创建克隆卷。
前提条件:用于创建克隆卷的快照,其状态必须是Normal。
说明
系统支持的最大克隆卷数:100000。
单个快照可创建的最大克隆卷数:512。
系统支持的最大克隆深度:16。
参数
参数 | 描述 |
---|---|
-n LUN_NAME 或--name LUN_NAME | 指定克隆卷名称。 取值:字符串形式,长度范围是1~16,只能由字母、数字和短横线(-)组成,字母区分大小写,且仅支持以字母或数字开头。 |
-s SNAPSHOT_NAME 或--snapshot SNAPSHOT_NAME | 指定克隆卷关联的快照名称。 取值:字符串形式,长度范围是1~256,只能由字母、数字、短横线( - )、下划线( _ )组成,字母区分大小写,且仅支持以字母或数字开头。 |
-tTARGET_NAME 或 --target TARGET_NAME | 指定克隆卷关联的iSCSI Target名称,可以跟源卷的iSCSI Target不同。 取值:字符串形式,长度范围1~16,只能由小写字母、数字、句点(.)和短横线(-)组成,且仅支持以字母或数字开头。 说明 创建卷时,如果指定的iSCSI Target名称不存在,那么同时创建iSCSI Target,新创建iSCSI Target的回收策略默认为Delete。 |
-p CAPACITY 或 --capacity CAPACITY | 指定克隆卷的容量。 取值:整数形式,数字后面可以输入单位简写G/g、T/t或P/p,分别代表GiB、TiB、PiB,如果不输入,默认为GiB。
默认为快照时刻的源卷容量,如果重新设置,则必须大于等于快照时刻的源卷的容量。 |
--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 | 指定克隆卷的高可用类型(仅集群版支持): 取值:
默认值为源卷的高可用类型。 |
-c LOCAL_STORAGE_CLASS 或 --local-storage-class LOCAL_STORAGE_CLASS | 指定克隆卷的冗余模式(仅集群版支持)。 取值:
默认值为源卷的卷冗余模式。 说明 以下场景均为集群可用的前提下:
|
--min-replica MIN_REPLICA | 指定克隆卷的最小副本数(仅集群版支持)。 对于副本模式的卷,假设卷副本数为X,最小副本数为Y(Y必须≤X),该卷每次写入时,至少Y份数据写入成功,才视为本次写入成功。对于EC N+M模式的卷,假设该卷最小副本数设置为Y(必须满足N≤Y≤N+M),必须满足总和至少为Y的数据块和校验块写入成功,才视为本次写入成功。 取值:整数。对于副本卷,取值范围是[1, N],N为副本模式卷的副本数;对于EC卷,取值范围是[N, N+M]。如果未设置克隆卷的最小副本数,默认值为源卷的最小副本数 |
--redundancy-overlap REDUNDANCY_OVERLAP | 指定克隆卷的折叠副本数(仅集群版支持)。在数据冗余模式下,同一份数据的不同副本/分片默认分布在不同的故障域,当故障域损坏时,允许根据卷的冗余折叠原则,将多份数据副本放在同一个故障域中,但是分布在不同的path上。 注意 如果存储池故障域级别为path,此参数不生效。 取值:整数。对于副本卷,取值范围是[1, N],N为副本模式卷的副本数;对于EC卷,取值范围是[1, N+M]。如果未设置克隆卷的折叠副本数,默认值为源卷的折叠副本数。 |
--ec-fragment-size EC_FRAGEMENT_SIZE | 指定克隆卷的纠删码模式分片大小。卷冗余模式为EC模式时,此设置才生效,否则忽略。 取值:1、2、4、8、16、32、64、128、256、512、1024、2048、4096,单位是KiB。默认值为源卷的纠删码模式分片大小。 |
-oSECTOR_SIZE 或 --sector-sizeSECTOR_SIZE | 指定克隆卷的扇区大小。 取值:512、4096,单位为字节。默认值为源卷的扇区大小。 说明 扇区大小的选取:根据自身业务场景,一般情况下,单次I/O操作的数据大小大于或接近4KiB,则推荐选择4096;单次I/O操作的数据大小接近512Bytes,则推荐选择512。如果对接VMware等虚拟化平台,则推荐选择512Bytes。 |
-w WRITE_POLICY 或 --write-policy WRITE_POLICY | 克隆卷的写策略:
默认为源卷的写策略。 |
-P PATH 或 --path PATH | 指定存储克隆卷数据的数据目录(仅单机版支持)。 如果创建克隆卷时不指定数据目录,默认与源卷配置保持一致。 |
示例1
单机版本地卷:创建克隆卷luna1-C1,关联的快照为luna1-snapshot,关联的iSCSI Target为targeta1,卷容量为200 GiB,其余配置与源卷一致。
[root@hblockserver CTYUN_HBlock_Plus_3.9.0_x64]# ./stor lun C -n luna1-C1 -s luna1-snapshot -t targeta1 -p 200
Confirm the information you set. If correct, enter Yes(Y). If not, enter No(N).
LUN Name: luna1-C1
Source Snapshot: luna1-snapshot
Capacity: 200 GiB
iSCSI Target: targeta1
Local Sector Size: 4096 bytes
Write Policy: WriteBack
Path: /mnt/stor01
yes
Created clone LUN luna1-C1 successfully.
示例2
集群版:创建克隆卷lun01a-C1,关联的快照为lun01a-snap20250304170942,关联的iSCSI Target为target01,其余配置与源卷一致。
[root@hblockserver CTYUN_HBlock_Plus_3.9.0_x64]# ./stor lun C -n lun01a-C1 -s lun01a-snap20250304170942 -t target01
Confirm the information you set. If correct, enter Yes(Y). If not, enter No(N).
LUN Name: lun01a-C1
Source Snapshot: lun01a-snap20250304170942
Capacity: 100 GiB
iSCSI Target: target01
Local Storage Class: EC 2+1 + 16KiB
Minimum Replica Number: 2
Redundancy Overlap: 1
Local Sector Size: 4096 bytes
Storage Pool: default
High Availability: ActiveStandby
Write Policy: WriteBack
yes
Created clone LUN lun01a-C1 successfully.