定义新主机

使用 host_define 命令可定义新的主机,以连接到存储系统。

host_define host=HostName [ cluster=ClusterName ]
[ iscsi_chap_name=iscsiChapName iscsi_chap_secret=iscsiPass ] [ domain=DomainList ]

参数

Name 类型 描述 必需 Default
host 对象名 要创建的主机的名称。 Y 不适用
cluster 对象名 要包含新创建的主机的集群名称。 N 无集群。
iscsi_chap_name String 主机的 CHAP 名称标识。 N none
iscsi_chap_secret String CHAP 启用时用于向系统进行认证的发起方的密码。 N none
domain 不适用 集群将附加到的域。 要包含多个域,可使用逗号进行分隔。 要包含所有现有域,可使用星号(“*”)。 N none

主机名称必须在系统中唯一。

使用 host_add_port 命令可向该主机添加端口地址(请参阅向主机添加端口,以获取详细信息)。 可选择指定集群。

参数 iscsi_chap_nameiscsi_chap_secret 必须同时指定或者不指定。

如果 iscsi_chap_secret 不符合所需的密码长度(96-128 位),那么命令将失败。

命令会检查 iscsi_chap_nameiscsi_chap secret 是否唯一。 如果不唯一,那么会显示一条错误消息,但命令会完成。

密码必须是 96 到 128 位之间。 输入密码有三种方法:
  • Base64:需要以 0b 作为输入前缀。 输入的每个后续字符都将视为 6 位等效长度
  • Hex:需要以 0x 作为输入前缀。 输入的每个后续字符都将视为 4 位等效长度
  • String:无需任何前缀(不能以 0b 或 0x 作为前缀)。 输入的每个字符都将视为 8 位等效长度

示例:

host_define host=server1

输出:

Command executed successfully.

访问控制

用户类别 许可权
存储管理员 允许
存储集成管理员 允许
应用程序管理员 不允许
安全性管理员 不允许
只读用户 不允许
技术人员 不允许

警告

  • ISCSI_CHAP_NAME_AND_SECRET_NOT_UNIQUE

    iSCSI CHAP 名称和密钥均已被另一个主机使用。 确定要复用这些值吗?

返回码

  • HOST_NAME_EXISTS

    主机名已存在。

  • MAX_HOSTS_REACHED

    已达到定义的最大主机数。

  • CLUSTER_BAD_NAME

    集群名称不存在。

  • DOMAIN_DOESNT_EXIST

    域不存在。

  • HOST_NOT_IN_CLUSTERS_DOMAINS

    主机不属于集群所连接的任何域。