單機版
./stor target add { -n | --name } TARGET_NAME [ --max-sessions MAX_SESSIONS ] [ --reclaim-policy RECLAIM_POLICY ] [ { -c | --chap-name } CHAP_NAME { -p | --password } CHAP_PASSWORD { -s | --status } STATUS ] [ [ --initiator [ IP&<1-n>][:NAME&<1-n> ] [ IP&<1-n>][:NAME&<1-n> ] ] [ --target [ IP&<1-n>][:NIC&<1-n> ] [ IP&<1-n>][:NIC&<1-n>] ] | --allow-file ALLOW_FILE ]
集群版
./stor target add { -n | --name } TARGET_NAME [ --max-sessions MAX_SESSIONS ] [ --reclaim-policy RECLAIM_POLICY ] [ { -c | --chap-name } CHAP_NAME { -p | --password } CHAP_PASSWORD { -s | --status } STATUS ] [ --num SERVER_NUMBER ] [ --server SERVER_ID &<1-n> ] [ [ --initiator [ IP&<1-n>][:NAME&<1-n> ] [ IP&<1-n>][:NAME&<1-n> ] ] [ --target [ IP&<1-n>][:NIC&<1-n> ] [ IP&<1-n>][:NIC&<1-n>] ] | --allow-file ALLOW_FILE ]
此命令用來創建iSCSI target。
說明
HBlock上iSCSI target IQN的數量最多32766個。一個iSCSI target最多可以關聯256個卷,但是一個卷只能被一個iSCSI target關聯。
參數
| 參數 | 描述 |
|---|---|
| -n TARGET_NAME 或 --name TARGET_NAME | iSCSI target名稱。 取值:字符串形式,長度范圍1~16,只能由小寫字母、數字、句點(.)和短橫線(-)組成,且僅支持以字母或數字開頭。 注意 一個iSCSI target最多可以關聯256個卷,但是一個卷只能被一個iSCSI target關聯。 |
| --max-sessions MAX_SESSIONS | iSCSI target下每個IQN允許建立的最大會話數。 取值:整數,取值范圍是[0, 1024],默認值為1。0表示客戶端無法發現該Target。 注意 如果多個客戶端連接同一iSCSI target IQN,客戶端可以同時讀,但不能同時寫。 |
| --reclaim-policy RECLAIM_POLICY | 指定iSCSI target的回收策略。 取值:
默認值為Retain。 說明 如果創建卷時指定不存在的iSCSI target,那么同時創建iSCSI target,新創建iSCSI target的回收策略默認為Delete。 |
| -c CHAP_NAME 或 --chap-name CHAP_NAME | 客戶端CHAP認證名稱。 取值:字符串形式,長度范圍是3~64,只能由字母、數字、句點( . )、短橫線( - )、下劃線( _ )、冒號( : )組成,字母區分大小寫,且僅支持以字母或數字開頭。 |
| -p CHAP_PASSWORD 或 --password CHAP_PASSWORD | 客戶端CHAP認證密碼。 取值:字符串形式,長度范圍是12~16,必須包含大寫字母、小寫字母、數字、下劃線(_)中的至少兩種字符,字母區分大小寫。 |
| -s STATUS 或 --status STATUS | 指定CHAP認證的狀態。 取值:
|
| --num SERVER_NUMBER | iSCSI target所在的服務器數量(僅集群版支持)。 取值:整數形式,取值為[2, n],n為集群內服務器的數量。默認值為2 |
| --server SERVER_ID &<1-n> | 指定服務器ID(僅集群版支持)。 最多可以指定n個服務器ID,以英文逗號隔開。n為集群內服務器的數量。 |
| --initiator [ IP&<1-n>][:NAME&<1-n> ] | 指定iSCSI發起方(initiator)允許訪問列表。可以設置多組initiator允許訪問列表,組與組之間以空格分隔,各組允許訪問列表之間為“或”的關系。每組允許訪問列表可以同時指定IP和initiator名稱,二者為“與”的關系。 如果不設置iSCSI發起方(initiator)允許訪問列表,則表示允許所有訪問。 說明 已掛載的卷,即使其客戶端和target后續被移出允許訪問列表,仍保持讀寫能力;斷開連接后,則禁止允許訪問列表外的客戶端再次掛載。
|
| --target [ IP&<1-n>][:NIC&<1-n> ] | 指定目標端(target)的允許訪問列表。可以設置多組target允許訪問列表,組與組之間以空格分隔,各組允許訪問列表之間為“或”的關系。每組允許訪問列表可以同時指定IP和NIC名稱,二者為“與”的關系。 如果不設置目標端(target)的允許訪問列表,則表示允許所有訪問。
|
| --allow-file ALLOW_FILE | 允許訪問列表文件,包含iSCSI發起方(initiator)允許訪問列表和目標端(target)的允許訪問列表。 允許訪問列表文件為符合UTF-8編碼格式的JSON文件,具體詳見iSCSI Target允許訪問列表文件。 注意 如果輸入了允許訪問列表文件,則會忽略參數--initiator和--target。 |
示例
示例1
單機版:創建targetc,允許建立的最多3個會話數,開啟CHAP認證。
[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor target add -n targetc --max-sessions 3 -c chap-test -p ****** -s on
Created target targetc successfully.
iqn = iqn.2012-08.cn.ctyunapi.oos:targetc.2(192.168.0.32:3260)示例2
集群版:創建target02,允許建立的最多6個會話數,開啟CHAP認證,指定服務器ID為hblock_1、hblock_2、hblock_3。
[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor target add -n target02 --max-sessions 6 -c chap-test -p ******** -s on --num 3 --server hblock_1,hblock_2,hblock_3
Created target target02 successfully.
iqn = iqn.2012-08.cn.ctyunapi.oos:target02.5(192.168.0.110:3260)
iqn = iqn.2012-08.cn.ctyunapi.oos:target02.6(192.168.0.192:3260)
iqn = iqn.2012-08.cn.ctyunapi.oos:target02.7(192.168.0.102:3260)示例3
集群版:創建target05,并為其創建允許訪問列表。
[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor target add -n target05 --initiator 192.168.0.70:iqn.1991-05.com.microsoft:songt-0001 192.168.0.64
Created target target05 successfully.
iqn = iqn.2012-08.cn.ctyunapi.oos:target05.7 (192.168.0.67:3260)
iqn = iqn.2012-08.cn.ctyunapi.oos:target05.8 (192.168.0.65:3260)