單機版：
./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或--redundancy-overlap REDUNDANCY_OVERLAP，則必須同時指定該參數。 取值：
默認值為源卷的卷冗余模式。 說明 以下場景均為集群可用的前提下：
|
| --min-replica MIN_REPLICA | 指定克隆卷的最小副本數（僅集群版支持）。 對于副本模式的卷，假設卷副本數為X，最小副本數為Y（Y必須≤X），該卷每次寫入時，至少Y份數據寫入成功，才視為本次寫入成功。對于EC N+M模式的卷，假設該卷最小副本數設置為Y（必須滿足N≤Y≤N+M），必須滿足總和至少為Y的數據塊和校驗塊寫入成功，才視為本次寫入成功。 注意 如果指定該參數，則必須指定克隆卷的--local-storage-class LOCAL_STORAGE_CLASS。 取值：
|
| --redundancy-overlap REDUNDANCY_OVERLAP | 指定克隆卷的折疊副本數（僅集群版支持）。在數據冗余模式下，同一份數據的不同副本/分片默認分布在不同的故障域，當故障域損壞時，允許根據卷的冗余折疊原則，將多份數據副本放在同一個故障域中，但是分布在不同的path上。 注意 如果存儲池故障域級別為path，此參數不生效。如果指定該參數，則必須指定克隆卷的--local-storage-class LOCAL_STORAGE_CLASS。 取值：
|
| --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.
