chhost

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

语法

阅读语法图跳过直观语法图 chhost  -type hpuxtpgsgenericopenvmsadminlunhide_secondary-maskport_login_mask-namenew_name_arg-protocolscsinvme-iscsiusernameusername_for_authentication-chapsecretchap_secret-nochapsecret-sitesite_namesite_id-nosite-ownershipgroupowner_id | owner_name-noownershipgrouphost_namehost_id

参数

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

无法更改 NVMe 主机的主机类型。有关需要 type 参数的主机的更多信息,请参阅 IBM Spectrum Virtualize for Public Cloud 主机连接文档。

-name new_name_arg
(可选)指定要为主机对象分配的新名称。
-protocol scsi | 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。
注意: 更改主机端口掩码可能会导致访问权丢失。禁用端口之前,请检查主机是否有权访问其他端口。
-iscsiusername username_for_authentication
(可选)指定用于因特网小型计算机系统接口 (iSCSI) 主机连接登录单向认证的主机对象的用户名。如果指定了该参数,那么该值将作为用于登录到 iSCSI 主机连接的单向认证的“用户名”。如果未指定 iscsiusername 参数,那么缺省情况下将主机对象的 IQN 用作用户名。如果未提供 iscsiusername 参数并且同一主机对象中存在多个 IQN,那么每个 IQN 的用户名将是 IQN 自身。如果为多个 IQN 主机提供了 iscsiusername 参数,那么请使用提供的 IQN 登录到所有主机。如果使用 iscsiusername 参数,还必须指定 chapsecret 参数。
-chapsecret chap_secret
(可选)设置提问握手认证协议 (CHAP) 密码,以用于针对 iSCSI I/O 认证主机。此密码在主机和集群之间共享。可使用 lsiscsiauth 命令列出每台主机的 CHAP 密钥。
-nochapsecret
(可选)清除先前为该主机设置的 CHAP 密钥。如果已指定 chapsecret,将无法指定 nochapsecret 参数。
-site site_name | site_id
(可选)指定主机的数字站点值或站点名称。站点名称必须为字母数字值。站点标识必须为 12可以使用任何拓扑(hyperswapstretchedstandard)更改分配给主机的站点。
注: 如果将主机映射到处于主动/主动关系 (HyperSwap®) 中的卷,那么无法指定 -nosite
-nosite
(可选)重置站点值。
-ownershipgroup owner_id | owner_name
(可选)对象添加到的所有权组的名称或标识。
-noownershipgroup
(可选)如果指定,那么将从对象所属的所有权组中移除该对象。
host_name | host_id
(必需)通过标识或当前名称指定要修改的主机对象。

描述

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

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

注: 从 iSCSI 主机移除所有 I/O 组后,lsiscsiauth 命令不会显示该主机的认证条目。您可以使用 addhostiogrp 命令将 iSCSI 主机映射到至少一个 I/O 组,然后使用 addhostport 命令将 iSCSI 端口添加到组中。您还必须使用带有 chapsecretnochapsecret 参数的 chhost 命令,添加对该主机的认证。
注: 如果该主机包含在主机集群中,那么无法更改所有权。主机正在观察主机集群的所有权。

调用示例

chhost -name testhostlode -mask 111111101101 hostone

将显示以下输出:

No feedback

调用示例

chhost -type openvms 0

将显示以下输出:

无反馈

调用示例

chhost -site site1 host3

将显示以下输出:

无反馈

用于更改主机所有权的调用示例

chhost -ownershipgroup 2 myhost

将显示以下输出:

无反馈

用于将主机移动到无所有权的调用示例

chhost -noownershipgroup  myhost


将显示以下输出:

No feedback