chsystem

使用 chsystem 命令可修改现有系统的属性。 创建系统后,可随时输入此命令。 与此命令关联的所有参数都是可选的。 但是,使用此命令时必须指定一个或多个参数。

语法

读取语法图跳过可视语法图 chsystem -namesystem_name-rcbuffersizenew_size_in_MB-alias标识别名-icatipicat_console_ip_address-invemailinterval时间间隔-gmlinktolerance链接容错-gmmaxhostdelay最大主机延迟-icatipipv4_icat_ip_address-icatip_6ipv6_icat_ip_address-ntpipntp_ip_address-ntpip_6ipv6_ntp_ip_address-isnsipsns_server_address-isnsip_6ipv6_sns_server_address-relationshipbandwidthlimitbandwidth_in_mBps-infocenterurlurl-iscsiauthmethodnonechap-chapsecretchap_secret-rcauthmethodnonechap-chapsecretchap_secret-chapsecretchap_secret-nochapsecret-iscsiusername用于双向认证的 iscsi 用户名-layer复制存储器-cacheprefetch-localfcportmask端口掩码-partnerfcportmask端口掩码-topology标准hyperswap-vdiskprotectiontimevalue_in_minutes-vdiskprotectionenabled-odx-easytieracceleration-maxreplicationdelayvalue_in_seconds-partnershipexclusionthresholdvalue_in_seconds-enhancedcallhome-censorcallhome-hostunmap-backendunmap-quorummode标准首选的胜者-quorumsitesite_idsite_name-quorumlease简短长整型-safeguardedcopysuspended

参数

-name 系统名称
(可选)指定系统的新名称。
重要信息: 使用系统和节点名生成每个节点的因特网小型计算机系统接口 (iSCSI) 限定名 (IQN)。 如果使用 iSCSI 协议,那么更改系统名称或节点名还会更改系统中所有节点的 IQN,并且可能需要重新配置与 iSCSI 连接的所有主机。
-rcbuffersize new_size_in_MB
(可选)指定每个节点上要用于高速镜像和全局镜像通信的兆字节 (MB) 内存量(从 48 到 512 MB)。 缺省值为 48 MB。
重要信息: 仅当支持团队指示时,才会调整此设置。

系统中所有节点都必须处于联机状态,并且必须至少有 8 千兆字节 (GB) 或 8192 兆字节 (MB) 的内存才能更改该设置。

-alias id_alias
(可选)指定备用名称,该名称不会更改系统的基本标识,但会影响新创建卷的 VDisk_UID。 现有 VDisk_UIDs 未更改。
-invemailinterval 时间间隔
(可选)指定将库存电子邮件发送到指定的电子邮件收件人的时间间隔。 时间间隔范围为 015。 时间间隔的度量单位为天。 如果将值设置为 0,将关闭清单电子邮件通知功能。
-gmlinktolerance link_tolerance
(可选)指定全局镜像操作能够容许的系统间链路不充足的时间长度(秒)。 该参数接受的值的范围从 2086400 秒(以 10 秒为单位递增)。 缺省值为 300 秒。 对该参数输入值 0 可以禁用链路容错。
-gmmaxhostdelay max_host_delay
(可选)指定最大时间延迟(毫秒),达到该时间后全局镜像链路容错计时器将开始倒计时。 此阈值确定全局镜像操作可对全局镜像源卷的响应时间施加的其他影响。 可以使用该参数从缺省值 5 毫秒开始增大阈值。
-icatip icat_console_ip_address
(可选)指定系统使用的新系统 IPv4 地址。 这个用于端口的 IP 地址的格式必须为点分十进制表示法,例如 255.255.255.255:8080。 如果指定此参数,那么它将覆盖任何现有 -icatip_6 地址。
-icatip_6 icat_console_ipv6_address
(可选)指定系统的新 IPv6 地址。 如果指定该参数,将覆盖所有现有的 -icatip 地址。 IPv6 地址格式必须是:
  • 八组四位十六进制数字,各组之间用冒号分隔,例如:
    [1234:1234:abcd:0123:0000:0000:7689:6576]:23
  • 八组十六进制数字,省略前导零,各组之间用冒号分隔,例如:
    [1234:1234:abcd:123:0:0:7689:6576]:23
  • 舍去一个或多个连续全为 0 的组,例如:
    [1234:1234:abcd:123::7689:6576]:23
-ntpip ntp_ip_address
(可选)对网络时间协议 (NTP) 服务器指定 IPv4/IPv6 地址或标准域名 (FQDN) 最大字符数为 256。 配置 NTP 服务器地址会导致系统使用该 NTP 服务器作为其时间源。 为 -ntpip 参数指定地址零,以使用其他时间源:
chsystem -ntpip 0.0.0.0
-ntpip_6 ipv6_ntp_ip_address
注: 在指定 -ntpip_6之前,必须为系统设置 IPv6 前缀和网关。
(可选)指定 NTP 服务器的 IPv6 地址。 配置 NTP 服务器地址会导致系统立即开始将该 NTP 服务器用作其时间源。 要选择其他时间源,请为 -ntpip_6 参数指定地址零,如下所示:
chsystem -ntpip_6 0::0
-isnsip sns_server_address
(可选)为 iSCSI 存储器名称服务 (SNS) 指定 IPv4 地址。 为 -isnsip 参数指定地址零,以选择其他 IPv4 iSCSI SNS 服务器:
chsystem -isnsip 0.0.0.0
-isnsip_6 ipv6_sns_server_address
(可选)为 iSCSI SNS 指定 IPv6 地址。 为 -isnsip_6 参数指定地址零,以选择其他已配置的 IPv6 iSCSI SNS 服务器:
chsystem -isnsip_6 0::0
-relationshipbandwidthlimit bandwidth_in_mBps
(可选)指定新的后台拷贝带宽,以每秒兆字节 (MBps) 为单位,范围从 11000。 缺省值为 25 MBps。
此参数在系统范围内有效,并定义任何关系可采用的最大后台拷贝带宽。 在伙伴关系上定义的现有后台拷贝带宽设置将继续运行(尝试使用较低的伙伴关系和卷速率)。
注: 请勿将此值设置为高于缺省值,而不确定可以维持较高的带宽。
-infocenterurl URL
指定首选联机文档 URL,以覆盖 GUI 使用的 URL。 由于此信息通过因特网浏览器进行解释,因此指定的信息可能包含主机名或 IP 地址。
请记住: 在GUI首选项窗口中查看当前配置的 URL。 此窗口还可帮助您将该值重置为缺省设置。
-iscsiauthmethod none | chap -chapsecret chap_secret
(可选)为系统的 iSCSI 通信设置认证方法:
  • chap 指示因特网小型计算机系统接口 (iSCSI) 认证已开启。
    请记住: 当为系统设置提问握手认证协议 (CHAP) 密钥时,这将开启 iSCSI 伙伴关系认证。
  • none 指示 iSCSI 伙伴关系认证已关闭。
-rcauthmethod none | chap -chapsecret chap_secret
(可选)针对远程拷贝伙伴关系请求(作为本机 IP 伙伴关系)开启或关闭认证。 此外:
  • chap 指示远程拷贝认证已开启。
    请记住: 当为系统设置提问握手认证协议 (CHAP) 密钥时,此操作将开启远程拷贝伙伴关系请求的认证。
  • none 指示远程拷贝伙伴关系认证已关闭。
-chapsecretchap_secret
(可选)设置 CHAP 密码,以用于对使用 iSCSI 的系统进行认证。 如果指定了 iscsiauthmethod chap 参数,那么该参数是必需的。 指定的 CHAP 密钥不能以空格开头或结尾。
-nochapsecret
(可选)清除先前为 iSCSI 认证设置的所有 CHAP 密码。 如果指定了 chapsecret,那么不能指定 nochapsecret 参数。
-iscsiusername
(可选)指定用于 iSCSI 主机连接登录的双向认证的整个 SVC 系统的用户名。 如果指定了此参数,那么该值将作为 iSCSI 主机连接登录中用于双向认证的“用户名”。 如果未指定用户名,那么用于双向 CHAP 认证的用户名为 NULL。
-layer 复制 | 存储器
(可选)指定系统所在的层。 该系统可以在同一层中创建与系统的伙伴关系。
注: 如果指定 -layer ,那么必须指定 replicationstorage。 当其他任何系统在光纤网上均不可视,并且没有定义任何系统伙伴关系时,才能使用此选项。
-cacheprefetch on | off
(可选)指示在系统中启用还是禁用高速缓存预取。 只能按照产品支持信息的指示对此进行调整。
-localfcportmask 端口掩码
(可选)仅指示本地系统节点间通信的光纤通道 (FC) 输入/输出 (I/O) 端口掩码。 光纤通道端口掩码不会影响主机或存储系统流量。 端口掩码是 64 个二进制位,由 0 和 1 组合而成,其中 0 表示对应的 FC I/O 端口无法使用,1 表示可以使用。 掩码应用于本地系统中的所有节点。 至少为本地系统节点到节点通信选择两个端口。 掩码必须使用选中的端口以及对这些端口可见的 FC 分区在本地系统中的每个节点之间生成至少 2 个 FC 连接。 有效掩码值范围从 0011(仅启用端口 1 和 2)到 1111111111111111111111111111111111111111111111111111111111111111(启用所有端口)。 例如,掩码 111111101101 将启用端口 1、3、4、6、7、8、9、10、11 和 12。
请记住: 部分掩码 (少于 64 个字符) 是零扩展的,这意味着未指定的任何端口都未启用。
指定 lsportfc 命令以显示 FC I/O 端口标识。
-partnerfcportmask 端口掩码
(可选)仅指示伙伴系统间通信的 FC I/O 端口掩码。 光纤通道端口掩码不会影响主机或存储系统流量。 端口掩码是 64 个二进制位,由 0 和 1 组合而成,其中 0 表示对应的 FC I/O 端口无法使用,1 表示可以使用。 掩码应用于本地系统中的所有节点。 有效掩码值的范围可能从 0000(未启用端口)到 1111111111111111111111111111111111111111111111111111111111111111(已启用所有端口)。 例如,掩码 111111101101 将启用端口 1、3、4、6、7、8、9、10、11 和 12。
请记住: 部分掩码 (少于 64 个字符) 是零扩展的,这意味着未指定的任何端口都未启用。
指定 lsportfc 命令以显示 FC I/O 端口标识。
-topology 标准 | hyperswap
(可选)指示所需的系统拓扑:standardhyperswap
-vdiskprotectiontime value_in_minutes
(可选)设置卷保护时间(以分钟为单位)。 范围为 15 - 1440。
-vdiskprotectionenabled yes | no
(可选)启用或禁用卷保护。 值为 yesno
-odx on | off
(可选)启用或禁用卸载的数据传输 (ODX)。 值为 onoff
注: 如果此系统中存在任何远程拷贝迁移关系,那么 ODX 必须为 off
-easytieracceleration on | off
(可选) 启用 Easy Tier ® 和池均衡加速。 值为 onoff
-maxreplicationdelay value_in_seconds
(可选)设置最大复制延迟(以秒为单位)。 值必须为 0360 之间的数字。
-partnershipexclusionthreshold value_in_seconds
(可选)设置远程系统的 I/O 操作的超时(秒)。 值必须为 30315(缺省值)之间的数字。
-enhancedcallhome on | off
(可选)指定回拨功能将向支持中心发送增强报告。 有效值为 yesno

增强报告包含操作数据和事件相关数据以及库存报告中包含的特定配置信息。 该功能将向支持中心发送关于硬件故障和潜在的严重配置或环境问题的警报。 支持中心可以使用配置信息来自动生成基于实际配置的最佳实践或建议。

-censorcallhome on | off
(可选)指定从增强回拨数据中删除敏感数据。 值为 yesno
-hostunmap on | off
(可选)指定管理员是否希望卷公告支持取消到主机的映射。 值为 onoff (缺省值)
-backendunmap on | off
(可选)指定管理员是希望对后端存储器启用 SCSI Unmap 支持。 启用此参数将允许系统向兼容的后端存储控制器和驱动器发出 SCSI Unmap 或 Write Same 命令以 在释放系统中的容量时回收容量。 值为 on(缺省值)或为 off
-quorummode standard | preferred | 获胜者
(可选)指定定额用于仲裁的方式。 有效值为 standard (default)preferredwinner
-quorumsite site_id | site_name
(必需)指定在 -quorummode 设置为 preferredwinner 时定额用于仲裁的站点标识或名称。
-quorumlease short | long
(可选)指定定额用于仲裁的方式。 有效值为 short (default)long
-safeguardedcopysuspended 是 | 否
(可选)暂挂或恢复受保护复制操作。

描述

此命令用于修改系统的特定功能部件。 发出一个命令即可更改多个功能部件。

使用 -ntpip-ntpip_6 参数将允许系统将 NTP 服务器用作外部时间源。 系统根据 NTP 服务器中的时间值来调整配置节点的系统时钟。 其他节点的时钟根据配置节点的时钟进行更新。 在 NTP 方式下,setsystemtime 命令被禁用。

所有命令参数都是可选的,但必须指定至少一个参数。

使用 chsystemip 命令可修改系统 IP 地址和服务 IP 地址。

请记住: 为系统设置 CHAP 密钥不会对 iSCSI 主机或远程拷贝伙伴关系开启认证。 通过发出 -iscsiauthmethod-rciauthmethod 可关闭认证。
注: 如果 -safeguardedcopysuspended 参数设置为 yes,那么不再自动删除受保护备份,并且无法创建新的受保护备份。 要恢复正常操作,请将 -safeguardedcopysuspended 参数指定为 no
注: 只有安全管理员角色用户才能执行参数 -ntpip-ntpip_6

调用示例

chsystem -ntpip 9.20.165.16

生成的输出:

No feedback

用于设置外部 NTP 服务器的调用示例

chsystem -ntpip 123.234.123.234 

生成的输出:

No feedback

用于更改首选 infocenterurl 值的调用示例

chsystem -infocenterurl http://miscserver.company.com/ibm/infocenter

生成的输出:

No feedback

用于更改本地端口掩码值的调用示例

要指示八端口系统中标识为 3 和 4 的 FC I/O 端口能够进行本地节点通信:

chsystem -localfcportmask 00001100

生成的输出:

No feedback

用于更改伙伴端口掩码值的调用示例

要指示八端口系统中标识为 7 和 8 的 FC 端口能够进行远程节点通信:

chsystem -partnerfcportmask 11000000

生成的输出:

No feedback

用于设置远程拷贝认证的调用示例

chsystem -chapsecret ABCB1234 -iscsiauthmethod none -rcauthmethod chap

生成的输出:

No feedback

用于关闭卷保护的调用示例

chsystem -vdiskprotectionenabled no

生成的输出:

No feedback

用于开启卷保护并将保护时间设置为 60 分钟的调用示例

chsystem -vdiskprotectionenabled yes -vdiskprotectiontime 60

生成的输出:

No feedback

用于开启 Easy Tier 加速的调用示例

chsystem -easytieracceleration on

生成的输出:

No feedback

用于开启 ODX 的调用示例

chsystem -odx on

生成的输出:

No feedback

用于设置最大复制延迟的调用示例

chsystem -maxreplicationdelay 100

生成的输出:

No feedback

用于设置伙伴关系排除阈值的调用示例

chsystem -partnershipexclusionthreshold 120

生成的输出:

No feedback

用于关闭增强的回拨的调用示例

chsystem -enhancedcallhome off 

生成的输出:

No feedback

用于开启检剔回拨的调用示例

chsystem -censorcallhome on 

生成的输出:

No feedback

用于开启 hostunmap 和 backendunmap 的调用示例

chsystem -hostunmap on -backendunmap on

生成的输出:

No feedback

调用示例

chsystem -ntpip myntpserver.mycompany.com

生成的输出:

No feedback

用于暂挂受保护拷贝功能的调用示例

chsystem -safeguardedcopysuspended yes

生成的输出:

No feedback