chsystem

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

语法

chsystem [ -namesystem_name ] [ -rcbuffersizenew_size_in_MB ] [ -aliasid_alias ] [ -icatipicat_console_ip_address ] [ -invemailintervalinterval ] [ -gmlinktolerancelink_tolerance ] [ -gmmaxhostdelaymax_host_delay ] [ -icatipipv4_icat_ip_address ] [ -icatip_6ipv6_icat_ip_address ] [ -ntpipipv4_ntp_ip_address ] [ -ntpip_6ipv6_ntp_ip_address ] [ -isnsipsns_server_address ] [ -isnsip_6ipv6_sns_server_address ] [ -relationshipbandwidthlimitbandwidth_in_mBps ] [ -infocenterurlurl ] [ -iscsiauthmethod { none | chap -chapsecretchap_secret } ] [ -rcauthmethod { none | chap -chapsecretchap_secret } ] { [ -chapsecretchap_secret ] | [ -nochapsecret ] } [ -iscsiusername { 用于双向认证的 iscsi 用户名 } ] [ -layer { replication | storage } ] [ -cacheprefetch { on | off } ] [ -localfcportmaskport_mask ] [ -partnerfcportmaskport_mask ] [ -topology { standard | hyperswap } ] [ -vdiskprotectiontimevalue_in_minutes ] [ -vdiskprotectionenabled { yes | no } ] [ -odx { on | off } ] [ -easytieracceleration { on | off } ] [ -maxreplicationdelayvalue_in_seconds ] [ -partnershipexclusionthresholdvalue_in_seconds ] [ -gen1compatibilitymodeno ] [ -enhancedcallhome { on | off } ] [ -censorcallhome { on | off } ] [ -hostunmap { on | off } ] [ -backendunmap { on | off } ]

参数

-namesystem_name
(可选)指定系统的新名称。
Important: 每个节点的因特网小型计算机系统接口 (iSCSI) 限定名 (IQN) 都使用系统和节点名生成。 如果要使用 iSCSI 协议,那么更改任一名称还会更改系统中的所有节点的 IQN,而且可能需要重新配置所有与 iSCSI 连接的主机。
-rcbuffersizenew_size_in_MB
(可选)指定每个节点上要用于高速镜像和全局镜像通信的兆字节 (MB) 内存量(从 48 到 512 MB)。 缺省值是 48 MB。
Important: 请仅在支持团队的指导下调整该设置。

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

Remember:
  • 更改该设置前,必须停止所有与此系统的伙伴关系。
  • 此参数仅适用于本地系统,并且更改此参数会中断镜像操作。
-aliasid_alias
(可选)指定备用名称,该名称不会更改系统的基本标识,但会影响每个 vdiskhostmap(包括现有和新的)的 VDisk_UID。 这些对象针对其标识与别名相匹配的系统创建的。 因此,更改系统别名会导致丢失主机系统访问权,直到每个主机扫描系统提供的卷才能重新获得此访问权。
-invemailintervalinterval
(可选)指定将库存电子邮件发送到指定的电子邮件收件人的时间间隔。 时间间隔范围为 015。 以天为单位。 将值设置为 0 可关闭库存电子邮件通知功能。
-gmlinktolerancelink_tolerance
(可选)指定全局镜像操作能够容许的系统间链路不充足的时间长度(秒)。 该参数接受的值的范围从 2086400 秒(以 10 秒为单位递增)。 缺省值为 300 秒。 对该参数输入值 0 可以禁用链路容错。
-gmmaxhostdelaymax_host_delay
(可选)指定最大时间延迟(毫秒),达到该时间后全局镜像链路容错计时器将开始倒计时。 该阈值确定全局镜像操作可以对全局镜像源卷的响应时间施加的额外影响。 可以使用该参数从缺省值 5 毫秒开始增大阈值。
-icatipicat_console_ip_address
(可选)指定系统使用的新系统 IPv4 地址。 这个用于端口的 IP 地址的格式必须为点分十进制表示法,例如 255.255.255.255:8080。 如果指定该参数,将覆盖所有现有的 -icatip_6 地址。
-icatip_6icat_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
-ntpipipv4_ntp_ip_address
(可选)为网络时间协议 (NTP) 服务器指定 IPv4 地址。 配置 NTP 服务器地址会导致系统使用该 NTP 服务器作为其时间源。 为 -ntpip 参数指定地址零,以使用其他时间源:
chsystem -ntpip 0.0.0.0
-ntpip_6ipv6_ntp_ip_address
Note: 在指定 -ntpip_6 之前,必须为系统设置 IPv6 前缀和网关。
(可选)指定 NTP 服务器的 IPv6 地址。 配置 NTP 服务器地址会导致系统立即开始将该 NTP 服务器用作其时间源。 要选择其他时间源,请为 -ntpip_6 参数指定地址零,如下所示:
chsystem -ntpip_6 0::0
-isnsipsns_server_address
(可选)为 iSCSI 存储器名称服务 (SNS) 指定 IPv4 地址。 为 -isnsip 参数指定地址零,以选择其他 IPv4 iSCSI SNS 服务器:
chsystem -isnsip 0.0.0.0
-isnsip_6ipv6_sns_server_address
(可选)为 iSCSI SNS 指定 IPv6 地址。 为 -isnsip_6 参数指定地址零,以选择其他已配置的 IPv6 iSCSI SNS 服务器:
chsystem -isnsip_6 0::0
-relationshipbandwidthlimitbandwidth_in_mBps
(可选)指定新的后台拷贝带宽,以每秒兆字节 (MBps) 为单位,范围从 11000。 缺省值为 25 MBps。
Important: 对于通过 IP 链路建立的包含压缩的伙伴关系,此参数指定将压缩应用于数据后的聚集带宽。 为此参数设置的值不能大于物理链路带宽与压缩因子的乘积(向下取整)。
该参数在系统范围内有效,用于定义任何关系都可以采用的最大后台拷贝带宽。 对伙伴关系定义的现有后台拷贝带宽设置将继续有效,但会尝试使用较少的伙伴关系和较低的卷速率。
Note: 如果无法确定较高的带宽是否可持续,请勿将该值设置为高于缺省值。
-infocenterurlurl
指定首选联机文档 URL,以覆盖 GUI 使用的 URL。 由于此信息通过因特网浏览器进行解释,因此指定的信息可能包含主机名或 IP 地址。
Remember: 在 GUI 首选项窗口中查看最新配置的 URL。 该窗口还可以帮助将此值重置为缺省设置。
-iscsiauthmethodnone | chap -chapsecret chap_secret
(可选)为系统的 iSCSI 通信设置认证方法:
  • chap 指示因特网小型计算机系统接口 (iSCSI) 认证已开启。
    Remember: 为系统设置提问握手认证协议 (CHAP) 密钥时,会开启 iSCSI 伙伴关系认证。
  • none 指示 iSCSI 伙伴关系认证已关闭。
-rcauthmethodnone | chap -chapsecret chap_secret
(可选)针对远程拷贝伙伴关系请求(作为本机 IP 伙伴关系)开启或关闭认证。 远程拷贝包括高速镜像、全局镜像和 。 此外:
  • chap 指示远程拷贝认证已开启。
    Remember: 为系统设置提问握手认证协议 (CHAP) 密钥时,该操作会开启远程拷贝伙伴关系请求的认证。
  • none 指示远程拷贝伙伴关系认证已关闭。
-chapsecretchap_secret
(可选)设置 CHAP 密码,以用于对使用 iSCSI 的系统进行认证。 如果指定了 iscsiauthmethod chap 参数,那么该参数是必需的。 指定的 CHAP 密码不能以空格开始或结束。
-nochapsecret
(可选)清除先前为 iSCSI 认证设置的所有 CHAP 密码。 如果指定了 chapsecret,那么不能指定 nochapsecret 参数。
-iscsiusername
(可选)指定用于 iSCSI 主机连接登录的双向认证的整个 SVC 系统的用户名。 如果指定了此参数,那么该值将作为 iSCSI 主机连接登录中用于双向认证的“用户名”。 如果未指定用户名,那么用于双向 CHAP 认证的用户名为 NULL。
-layerreplication | storage
(可选)指定系统所在的层。 系统可与同一层中其他系统建立伙伴关系。
Note: 如果指定 -layer,那么必须指定 replicationstorage。 当其他任何系统在光纤网上均不可视,并且没有定义任何系统伙伴关系时,才能使用此选项。
-cacheprefetchon | off
(可选)指示在系统中启用还是禁用高速缓存预取。 只能按照产品支持信息的指示对此进行调整。
-localfcportmaskport_mask
(可选)仅指示本地系统节点间通信的光纤通道 (FC) 输入/输出 (I/O) 端口掩码。 光纤通道端口掩码不会影响主机或存储系统流量。 端口掩码是 64 个二进制位,由 0 和 1 组合而成,其中 0 表示对应的 FC I/O 端口无法使用,1 表示可以使用。 该掩码应用于本地系统中的所有节点。 至少为本地系统节点到节点通信选择两个端口。 掩码必须在本地系统中的各个节点间产生至少 2 个仅使用所选端口和这些端口可见的 FC 区域的 FC 连接。 有效掩码值范围从 0011(仅启用端口 1 和 2)到 1111111111111111111111111111111111111111111111111111111111111111(启用所有端口)。 例如,掩码 111111101101 启用端口 1、3、4、6、7、8、9、10、11 和 12。
Remember: 部分掩码(少于 64 个字符)使用零扩展,这意味着不会启用任何未指定的端口。
指定 lsportfc 命令以显示 FC I/O 端口标识。
-partnerfcportmaskport_mask
(可选)仅指示伙伴系统间通信的 FC I/O 端口掩码。 光纤通道端口掩码不会影响主机或存储系统流量。 端口掩码是 64 个二进制位,由 0 和 1 组合而成,其中 0 表示对应的 FC I/O 端口无法使用,1 表示可以使用。 该掩码应用于本地系统中的所有节点。 有效掩码值范围从 0000(不启用任何端口)到 1111111111111111111111111111111111111111111111111111111111111111(启用所有端口)。 例如,掩码 111111101101 启用端口 1、3、4、6、7、8、9、10、11 和 12。
Remember: 部分掩码(少于 64 个字符)使用零扩展,这意味着不会启用任何未指定的端口。
指定 lsportfc 命令以显示 FC I/O 端口标识。
-topologystandard | hyperswap
(可选)指示所需的系统拓扑:standardhyperswap
-vdiskprotectiontimevalue_in_minutes
(可选)设置卷保护时间(以分钟为单位)。
-vdiskprotectionenabledyes | no
(可选)启用或禁用卷保护。 值为 yesno
-odxon | off
(可选)启用或禁用卸载的数据传输 (ODX)。 值为 onoff
-easytieraccelerationon | off
(可选)启用 Easy Tier 和池均衡加速。 值为 onoff
-maxreplicationdelayvalue_in_seconds
(可选)设置最大复制延迟(以秒为单位)。 值必须为 0360 之间的数字。
-partnershipexclusionthresholdvalue_in_seconds
(可选)设置远程系统的 I/O 操作的超时(秒)。 值必须为 30315(缺省值)之间的数字。
-gen1compatibilitymodeno
(可选)禁用系统兼容性方式。 例如, 系统与 系统不兼容。
Note: 指定的值必须是 no
-enhancedcallhomeon | off
(可选)指定回拨功能将向支持中心发送增强报告。 有效值为 yesno

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

-censorcallhomeon | off
(可选)指定从增强回拨数据中删除敏感数据。 值为 yesno
-hostunmapon | off
(可选)指定管理员是否希望卷公告支持取消到主机的映射。值为 on(缺省值)off
-backendunmapon | off
(可选)指定管理员是希望对后端存储器启用 SCSI Unmap 支持。通过启用此参数,系统可以向兼容的后端存储控制器和驱动器发出 SCSI Unmap 或 Write Same 命令,从而在系统中释放容量后回收容量。值为 on(缺省值)或为 off

描述

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

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

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

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

Remember: 为系统设置 CHAP 密码并不会开启对 iSCSI 主机或远程拷贝伙伴关系的认证。 远程拷贝包括高速镜像、全局镜像和 。 通过发出 -iscsiauthmethod-rciauthmethod 可关闭认证。
仅在配置了节点站点的情况下,拓扑才能设置为 HyperSwap。 所有节点都必须定义站点。 如果在 I/O 组中定义了两个节点,那么必须将其分配到同一站点(123 不能用于节点)。 在站点 1 和站点 2 中,必须各具有至少一个包含这两个节点的 I/O 组。
Note: 如果定义了任何活动关系,那么系统拓扑必须为 HyperSwap。

调用示例

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

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

要将本地掩码设置为 62 个 0 和 2 个 1, 指示具有标识 1 和 2 的 FC I/O 端口能够进行本地节点通信,请执行以下操作:

chsystem -localfcportmask 11

生成的输出:

No feedback

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

要将伙伴掩码设置为 63 个 0 和 1 个 1,指示具有标识 2 的 FC I/O 端口能够进行远程节点通信,请执行以下操作:

svctask chsystem -partnerfcportmask 0010

生成的输出:

No feedback

用于设置系统拓扑的调用示例

chsystem -topology standard

生成的输出:

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 -gen1compatibilitymode no 

生成的输出:

No feedback

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

chsystem -enhancedcallhome off 

生成的输出:

No feedback

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

chsystem -censorcallhome on 

生成的输出:

No feedback

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

chsystem -hostunmap on -backendunmap on

生成的输出:

No feedback