更新主机定义
使用 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_name 和 iscsi_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 个十六进制数字。