本地卷
單機版
./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 ] [ [ --qos-name QOS_NAME ] [ --iops IOPS ] [ --read-iops READ_IOPS ] [ --write-iops WRITE_IOPS ] [ --bps BPS ] [ --read-bps READ_BPS ] [ --write-bps WRITE_BPS ] [ --iops-burst IOPS_BURST ] [ --read-iops-burst READ_IOPS_BURST ] [ --write-iops-burst WRITE_IOPS_BURST ] [ --bps-burst BPS_BURST ] [ --read-bps-burst READ_BPS_BURST ] [ --write-bps-burst WRITE_BPS_BURST ] [ --iops-burst-secs IOPS_BURST_SECS ] [ --read-iops-burst-secs READ_IOPS_BURST_SECS ] [ --write-iops-burst-secs WRITE_IOPS_BURST_SECS ] [ --bps-burst-secs BPS_BURST_SECS ] [ --read-bps-burst-secs READ_BPS_BURST_SECS ] [ --write-bps-burst-secs WRITE_BPS_BURST_SECS ] ]集群版
./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 ] [ [ --qos-name QOS_NAME ] [ --iops IOPS ] [ --read-iops READ_IOPS ] [ --write-iops WRITE_IOPS ] [ --bps BPS ] [ --read-bps READ_BPS ] [ --write-bps WRITE_BPS ] [ --iops-burst IOPS_BURST ] [ --read-iops-burst READ_IOPS_BURST ] [ --write-iops-burst WRITE_IOPS_BURST ] [ --bps-burst BPS_BURST ] [ --read-bps-burst READ_BPS_BURST ] [ --write-bps-burst WRITE_BPS_BURST ] [ --iops-burst-secs IOPS_BURST_SECS ] [ --read-iops-burst-secs READ_IOPS_BURST_SECS ] [ --write-iops-burst-secs WRITE_IOPS_BURST_SECS ] [ --bps-burst-secs BPS_BURST_SECS ] [ --read-bps-burst-secs READ_BPS_BURST_SECS ] [ --write-bps-burst-secs WRITE_BPS_BURST_SECS ] ]
上云卷
單機版
./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 ] [ [ --qos-name QOS_NAME ] [ --iops IOPS ] [ --read-iops READ_IOPS ] [ --write-iops WRITE_IOPS ] [ --bps BPS ] [ --read-bps READ_BPS ] [ --write-bps WRITE_BPS ] [ --iops-burst IOPS_BURST ] [ --read-iops-burst READ_IOPS_BURST ] [ --write-iops-burst WRITE_IOPS_BURST ] [ --bps-burst BPS_BURST ] [ --read-bps-burst READ_BPS_BURST ] [ --write-bps-burst WRITE_BPS_BURST ] [ --iops-burst-secs IOPS_BURST_SECS ] [ --read-iops-burst-secs READ_IOPS_BURST_SECS ] [ --write-iops-burst-secs WRITE_IOPS_BURST_SECS ] [ --bps-burst-secs BPS_BURST_SECS ] [ --read-bps-burst-secs READ_BPS_BURST_SECS ] [ --write-bps-burst-secs WRITE_BPS_BURST_SECS ] ]集群版
./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 ] [ [ --qos-name QOS_NAME ] [ --iops IOPS ] [ --read-iops READ_IOPS ] [ --write-iops WRITE_IOPS ] [ --bps BPS ] [ --read-bps READ_BPS ] [ --write-bps WRITE_BPS ] [ --iops-burst IOPS_BURST ] [ --read-iops-burst READ_IOPS_BURST ] [ --write-iops-burst WRITE_IOPS_BURST ] [ --bps-burst BPS_BURST ] [ --read-bps-burst READ_BPS_BURST ] [ --write-bps-burst WRITE_BPS_BURST ] [ --iops-burst-secs IOPS_BURST_SECS ] [ --read-iops-burst-secs READ_IOPS_BURST_SECS ] [ --write-iops-burst-secs WRITE_IOPS_BURST_SECS ] [ --bps-burst-secs BPS_BURST_SECS ] [ --read-bps-burst-secs READ_BPS_BURST_SECS ] [ --write-bps-burst-secs WRITE_BPS_BURST_SECS ] ]
此命令用來創建卷。
說明
- 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。 |
| --qos-name QOS_NAME | 指定QoS策略名稱。 說明 創建卷時，如果指定QoS策略名稱不存在，那么同時創建QoS策略，新創建的QoS策略的回收策略默認為Delete。 對于集群版，不指定QoS策略時：
取值：字符串形式，長度范圍1~64，只能由字母、數字和短橫線(-)組成，區分大小寫，且僅支持以字母或數字開頭。 注意
|
| --iops IOPS | 每秒能夠進行讀寫操作次數的最大值。 取值：整數形式，取值為[-1, 999999999]，默認值為-1。-1表示不限制。 |
| --read-iops READ_IOPS | 每秒能夠進行讀操作次數的最大值。 取值：整數形式，取值為[-1, 999999999]，默認值為-1。-1表示不限制。 |
| --write-iops WRITE_IOPS | 每秒能夠進行寫操作次數的最大值。 取值：整數形式，取值為[-1, 999999999]，默認值為-1。-1表示不限制。 |
| --bps BPS | 每秒可傳輸數據量的最大值。 取值：整數形式，數字后面可以輸入單位簡寫B/b、K/k、M/m、G/g、T/t，分別代表Bytes/s、KiB/s、MiB/s、GiB/s、TiB/s。默認單位是Bytes/s，默認值為-1，表示不限制。
|
| --read-bps READ_BPS | 讀帶寬上限。 取值：整數形式，數字后面可以輸入單位簡寫B/b、K/k、M/m、G/g、T/t，分別代表Bytes/s、KiB/s、MiB/s、GiB/s、TiB/s。默認單位是Bytes/s，默認值為-1，表示不限制。
|
| --write-bps WRITE_BPS | 寫帶寬上限。 取值：整數形式，數字后面可以輸入單位簡寫B/b、K/k、M/m、G/g、T/t，分別代表Bytes/s、KiB/s、MiB/s、GiB/s、TiB/s。默認單位是Bytes/s，默認值為-1，表示不限制。
|
| --iops-burst IOPS_BURST | 使用Burst功能時，每秒能夠進行讀寫操作次數的最大值。 取值：整數形式。只有當--iops IOPS大于等于1時，此項設置為-1或(IOPS, 999999999]內的正整數方可生效。默認值為-1，表示不限制。 |
| --read-iops-burst READ_IOPS_BURST | 使用Burst功能時，每秒能夠進行讀操作次數的最大值。 取值：整數形式。只有當--read-iops READ_IOPS大于等于1時，此項設置為-1或(READ_IOPS, 999999999]內的正整數方可生效。默認值為-1，表示不限制。 |
| --write-iops-burst WRITE_IOPS_BURST | 使用Burst功能時，每秒能夠進行寫操作次數的最大值。 取值：整數形式。只有當--write-iops WRITE_IOPS大于等于1時，此項設置為-1或(WRITE_IOPS 999999999]內的正整數方可生效。默認值為-1，表示不限制。 |
| --bps-burst BPS_BURST | 使用Burst功能時，每秒可傳輸的數據量最大值。 取值：整數形式，數字后面可以輸入單位簡寫B/b、K/k、M/m、G/g、T/t，分別代表Bytes/s、KiB/s、MiB/s、GiB/s、TiB/s。默認單位是Bytes/s，默認值為-1，表示不限制。只有當--bps BPS大于等于1時，在單位相同的情況下，此項設置為下列取值范圍方可生效：
|
| --read-bps-burst READ_BPS_BURST | 使用Burst功能時，讀帶寬上限。 取值：整數形式，數字后面可以輸入單位簡寫B/b、K/k、M/m、G/g、T/t，分別代表Bytes/s、KiB/s、MiB/s、GiB/s、TiB/s。默認單位是Bytes/s，默認值為-1，表示不限制。只有當--read-bps READ_BPS大于等于1時，在單位相同的情況下，此項設置為下列取值范圍方可生效：
|
| --write-bps-burst WRITE_BPS_BURST | 使用Burst功能時，寫帶寬上限。 取值：整數形式，數字后面可以輸入單位簡寫B/b、K/k、M/m、G/g、T/t，分別代表Bytes/s、KiB/s、MiB/s、GiB/s、TiB/s。默認單位是Bytes/s，默認值為-1，表示不限制。只有當--write-bps WRITE_BPS大于等于1時，在單位相同的情況下，此項設置為下列取值范圍方可生效：
|
| --iops-burst-secs IOPS_BURST_SECS | 使用Burst功能時，按照Burst上限的能力進行讀寫操作所能持續的時間。 注意 只有在IOPS Burst功能啟用時，此配置才生效。 取值：整數形式，取值為[1, 999999999]，默認值為1，單位是秒。 |
| --read-iops-burst-secs READ_IOPS_BURST_SECS | 使用Burst功能時，按照Burst上限的能力進行讀操作所能持續的時間。 注意 只有在Read IOPS Burst功能啟用時，此配置才生效。 取值：整數形式，取值為[1, 999999999]，默認值為1，單位是秒。 |
| --write-iops-burst-secs WRITE_IOPS_BURST_SECS | 使用Burst功能時，按照Burst上限的能力進行寫操作所能持續的時間。 注意 只有在Write IOPS Burst功能啟用時，此配置才生效。 取值：整數形式，取值為[1, 999999999]，默認值為1，單位是秒。 |
| --bps-burst-secs BPS_BURST_SECS | 使用Burst功能時，按照Burst上限的流量能力所能持續的時間。 注意 只有在BPS Burst功能啟用時，此配置才生效。 取值：整數形式，取值為[1, 999999999]，默認值為1，單位是秒。 |
| --read-bps-burst-secs READ_BPS_BURST_SECS | 使用Burst功能時，按照Burst上限的讀流量能力所能持續的時間。 注意 只有在Read BPS Burst功能啟用時，此配置才生效。 取值：整數形式，取值為[1, 999999999]，默認值為1，單位是秒。 |
| --write-bps-burst-secs WRITE_BPS_BURST_SECS | 使用Burst功能時，按照Burst上限的寫流量能力所能持續的時間。 注意 只有在Write BPS Burst功能啟用時，此配置才生效。 取值：整數形式，取值為[1, 999999999]，默認值為1，單位是秒。 |
| --reclaim-policy RECLAIM_POLICY | QoS策略的回收策略。 取值：
默認值為Retain。 |
示例
示例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.
