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-iscsiauthmethodnonechap-chapsecretchap_secret-rcauthmethodnonechap-chapsecretchap_secret-chapsecretchap_secret-nochapsecret-iscsiusernameiscsi username for two way authentication-cacheprefetchonoff-localfcportmaskport_mask-partnerfcportmaskport_mask-vdiskprotectiontimevalue_in_minutes-vdiskprotectionenabledyesno-odxonoff-easytieraccelerationonoff-maxreplicationdelayvalue_in_seconds-partnershipexclusionthresholdvalue_in_seconds-ibmcustomercustomer_id-ibmcomponentcomponent_id-ibmcountrycountry_id-enhancedcallhomeonoff-censorcallhomeonoff-hostunmaponoff-backendunmaponoff

参数

-name system_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_UID 不会更改。
-invemailinterval interval
(可选)指定将库存电子邮件发送到指定的电子邮件收件人的时间间隔。 时间间隔范围为 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 ipv4_ntp_ip_address
(可选)为网络时间协议 (NTP) 服务器指定 IPv4 地址。 配置 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。
要点: 对于通过 IP 链路建立的包含压缩的伙伴关系,此参数指定将压缩应用于数据后的聚集带宽。 为此参数设置的值不能大于物理链路带宽与压缩因子的乘积(向下取整)。
该参数在系统范围内有效,用于定义任何关系都可以采用的最大后台拷贝带宽。 对伙伴关系定义的现有后台拷贝带宽设置将继续有效,但会尝试使用较少的伙伴关系和较低的卷速率。
注: 如果无法确定较高的带宽是否可持续,请勿将该值设置为高于缺省值。
-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。
-cacheprefetch on | off
(可选)指示在系统中启用还是禁用高速缓存预取。 只能按照产品支持信息的指示对此进行调整。
-localfcportmask port_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。
切记: 部分掩码(少于 64 个字符)使用零扩展,这意味着不会启用任何未指定的端口。
指定 lsportfc 命令以显示 FC I/O 端口标识。
-partnerfcportmask port_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。
切记: 部分掩码(少于 64 个字符)使用零扩展,这意味着不会启用任何未指定的端口。
指定 lsportfc 命令以显示 FC I/O 端口标识。
-vdiskprotectiontime value_in_minutes
(可选)设置卷保护时间(以分钟为单位)。范围为 15 - 1440。
-vdiskprotectionenabled yes | no
(可选)启用或禁用卷保护。 值为 yesno
-odx on | off
(可选)启用或禁用卸载的数据传输 (ODX)。 值为 onoff
-easytieracceleration on | off
(可选)启用 Easy Tier® 和池均衡加速。值为 onoff
-maxreplicationdelay value_in_seconds
(可选)设置最大复制延迟(以秒为单位)。 值必须为 0360 之间的数字。
-partnershipexclusionthreshold value_in_seconds
(可选)设置远程系统的 I/O 操作的超时(秒)。 值必须为 30315(缺省值)之间的数字。
-ibmcustomer customer_id
(可选)指定购买软件许可证(会自动添加到权利数据库中)时分配的客户编号。 该值必须为包含 7 - 10 位数的数字(或空白)。
-ibmcomponent component_id
(可选)指定用于权利和回拨系统的组件标识。 该值为空或 SANVCNSW1
-ibmcountry country_id
(可选)指定用于权利和回拨系统的国家或地区标识。 该值为空或 3 位数数字。
-enhancedcallhome on | off
(可选)指定回拨功能将向支持中心发送增强报告。 有效值为 yesno

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

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

描述

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

使用 -ntpip-ntpip_6 参数将允许系统将 NTP 服务器用作外部时间源。系统根据 NTP 服务器中的时间值来调整配置节点的系统时钟。其他节点的时钟根据配置节点的时钟进行更新。在 NTP 方式下,会禁用 setsystemtime 命令。
注: 对于 Amazon Web Services (AWS) 上的 IBM Spectrum Virtualize for Public Cloud,请勿手动设置系统的 NTP。系统时间必须与 AWS NTP 同步,否则某些 AWS API 可能会发生故障。缺省 AWS NTP 在安装期间进行了设置。

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

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

切记: 为系统设置 CHAP 密钥并不会开启对 iSCSI 主机或远程拷贝伙伴关系的认证。 通过发出 -iscsiauthmethod-rciauthmethod 可关闭认证。

调用示例

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

生成的输出:

无反馈

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

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

chsystem -partnerfcportmask 11000000

生成的输出:

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

用于指定 IBM 客户标识、组件标识和国家或地区标识的调用示例

chsystem -ibmcustomer 1928374 -ibmcomponent SANVCNSW1 -ibmcountry 001 

生成的输出:

无反馈

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

chsystem -enhancedcallhome off 

生成的输出:

无反馈

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

chsystem -censorcallhome on 

生成的输出:

无反馈

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

chsystem -hostunmap on -backendunmap on

生成的输出:

No feedback