更新主机定义

使用 host_update 命令可更新主机定义。

host_update host=HostName [ iscsi_chap_name=iscsiChapName ] [ iscsi_chap_secret=iscsiPass ]

参数

Name 类型 描述 必需 Default
主机 对象名 用于为存储系统指明主机的名称。 Y 不适用
iscsi_chap_name String 主机的 CHAP 名称标识 N [unchanged]
iscsi_chap_secret String CHAP 启用时用于向存储系统进行认证的发起方的密码 N [unchanged]

此命令执行以下 CHAP 相关检查:

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

    这些参数必须是唯一的。 如果不唯一,那么会显示一条错误消息,但命令会完成。

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

更改 iscsi_chap_name 和/或 iscsi_chap_secret

  • 这会显示一条警告消息,说明只有在下次连接主机时才会应用此更改。

示例:

host_update host iscsi_chap_name iscsi_chap_secret

输出:

Command executed successfully.

访问控制

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

警告

  • ISCSI_CHAP_NAME_AND_SECRET_NOT_UNIQUE

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

  • ISCSI_CHAP_SECRET_NOT_UNIQUE

    iSCSI CHAP 密钥已被另一个主机使用。 确定要复用该值吗?

  • ISCSI_CHAP_NAME_NOT_UNIQUE

    iSCSI CHAP 名称已被另一个主机使用。 确定要复用该值吗?

返回码

  • HOST_BAD_NAME

    主机名不存在。

  • ISCSI_CHAP_NAME_EMPTY

    CHAP 名称应为非空字符串。

  • ISCSI_CHAP_NAME_TOO_LONG

    CHAP 名称太长。

  • ISCSI_CHAP_SECRET_EMPTY

    CHAP 密码应为非空字符串。

  • ISCSI_CHAP_SECRET_BAD_SIZE

    CHAP 密码长度应为 12 到 16 个字节。

  • ISCSI_CHAP_SECRET_BAD_HEX_FORMAT

    CHAP 密码是非法的十六进制数字,或其大小是非法的。它应该是 24 到 32 个十六进制数字。