单机版
./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)