chhost

使用 chhost 命令可更改主机对象的名称或类型。 此命令不会影响任何现有的主机映射。

语法

chhost [ -type { hpux | tpgs | generic | openvms | adminlun | hide_secondary } ] [ -mask port_login_mask ] [ -namenew_name_arg ] [ -protocol { scsi | nvme } ] [ -iscsiusernameusername_for_authentication ] { [ -chapsecretchap_secret ] | [ -nochapsecret ] } { [ -site { site_name | site_id } ] | [ -nosite ] } { host_name | host_id }

参数

-typehpux |tpgs|generic|openvms|adminlun|hide_secondary
(可选)指定主机类型。 以下值表示可用的主机类型:
  • generic 指示缺省值。
  • tpgs 指示当目标端口信息发生更改时,将为主机提供额外的 Unit Attention。
  • openvms 指示 OpenVMS。
  • adminlun 指示在主机上启用的虚拟卷。
  • hpux 指示 HP-UX 固件。
  • hide_secondary 指示所有远程拷贝关系辅助卷都不可用于该主机。

无法更改 NVMe 主机的主机类型。有关需要 type 参数的主机的更多信息,请参阅 Lenovo Storage V7000 主机连接文档。

-namenew_name_arg
(可选)指定要为主机对象分配的新名称。
-protocolscsi|nvme
(可选)指定主机与存储系统通信所使用的协议。缺省值为 scsi。主机 -protocol 不能与主机 -type 同时更改。仅当满足以下条件时才能更改主机协议:
  • 没有卷映射到主机。
  • 在主机上未定义任何端口。
  • 主机类型与新协议兼容。使用 NVMe 协议的主机的类型必须为 generic
-mask port_login_mask
(可选)指定主机可访问的节点目标端口和主机的光纤通道 (FC) 端口掩码。 主机对象中的全球端口名 (WWPN) 必须从掩码中包含的节点端口访问卷,并且位于主机对象 I/O 组中。 端口掩码是 64 个二进制位,由 0 和 1 组合而成,其中 0 表示对应的 FC I/O 端口无法使用,1 表示可以使用。 掩码中最右侧的位对应于 FC I/O 端口 1。有效掩码值范围从 0000(未启用任何端口)到 1111111111111111111111111111111111111111111111111111111111111111(启用所有端口)。 例如,掩码 111111101101 启用端口 1、3、4、6、7、8、9、10、11 和 12。
Attention: 更改主机端口掩码可能会导致访问权丢失。禁用端口之前,请检查主机是否有权访问其他端口。
-iscsiusernameusername_for_authentication
(可选)指定用于因特网小型计算机系统接口 (iSCSI) 主机连接登录单向认证的主机对象的用户名。 如果指定了该参数,那么该值将作为用于登录到 iSCSI 主机连接的单向认证的“用户名”。 如果未指定 iscsiusername 参数,那么缺省情况下将主机对象的 IQN 用作用户名。 如果未提供 iscsiusername 参数并且同一主机对象中存在多个 IQN,那么每个 IQN 的用户名将是 IQN 自身。 如果为多个 IQN 主机提供了 iscsiusername 参数,那么请使用提供的 IQN 登录到所有主机。 如果使用 iscsiusername 参数,还必须指定 chapsecret 参数。
-chapsecretchap_secret
(可选)设置提问握手认证协议 (CHAP) 密码,以用于针对 iSCSI I/O 认证主机。此密码在主机和集群之间共享。 可使用 lsiscsiauth 命令列出每台主机的 CHAP 密码。
-nochapsecret
(可选)清除先前为该主机设置的 CHAP 密码。 如果已指定 chapsecret,将无法指定 nochapsecret 参数。
-sitesite_name | site_id
(可选)指定主机的数字站点值或站点名称。 站点名称必须为字母数字值。 站点标识必须为 12可以使用任何拓扑(hyperswapstandard)更改分配给主机的站点。
Note: 如果主机已映射到活动关系中的卷,那么将不能指定 -nosite
-nosite
(可选)重置站点值。
host_name | host_id
(必需)通过标识或当前名称指定要修改的主机对象。

描述

该命令可将指定主机的名称更改为新名称,或者可以更改主机的类型。 该命令不会影响任何当前主机映射。

端口掩码应用于来自主机发起程序端口的登录,这些登录与主机对象关联。 对于主机总线适配器 (HBA) 端口和节点端口之间的每次登录,节点都会检查与主机 HBA 所属的主机对象相关联的端口掩码,并确定是允许还是拒绝访问。 如果拒绝访问,那么节点会像 HBA 端口未知那样响应 SCSI 命令。

Note: 从 iSCSI 主机除去所有 I/O 组后,lsiscsiauth 命令不会显示该主机的认证条目。 您可以使用 addhostiogrp 命令将 iSCSI 主机映射到至少一个 I/O 组,然后使用 addhostport 命令将 iSCSI 端口添加到组中。 您还必须使用带有 chapsecretnochapsecret 参数的 chhost 命令,添加对该主机的认证。

调用示例

chhost -name testhostlode -mask 111111101101 hostone

将显示以下输出:

No feedback

调用示例

chhost -type openvms 0

将显示以下输出:

No feedback

调用示例

chhost -site site1 host3

将显示以下输出:

No feedback