chsystem

Parameters

-name system_name

(Optional) Specifies a new name for the system.

Important: The Internet Small Computer System Interface (iSCSI) Qualified Name (IQN) for each node is generated by using the system and node names. If you are using the iSCSI protocol, changing either name also changes the IQN of all of the nodes in the system and might require reconfiguration of all iSCSI-attached hosts.

-alias id_alias

(Optional) Specifies an alternative name that does not change the basic ID for the system, but does not influence the VDisk_UID of newly created volumes. Existing VDisk_UIDs are not changed.

-consolip ipv4

The management IPv4 address of the system.

-invemailinterval interval

(Optional) Specifies the interval at which inventory emails are sent to the designated email recipients. The interval range is 0 to 15. The interval is measured in days. Setting the value to 0 turns off the inventory email notification function.

-icatip icat_console_ip_address

(Optional) Specifies the system's new IPv4 address that is used by the system. The format of this IP address must be a dotted decimal notation with the port; for example, 255.255.255.255:8080. If you specify this parameter, it overwrites any existing -icatip_6 address.

-icatip_6 icat_console_ipv6_address

(Optional) Specifies the system's new IPv6 address. If you specify this parameter, it overwrites any existing -icatip address. The format of the IPv6 address must be:

• Eight colon-separated groups of four hexadecimal digits; for example:

  [1234:1234:abcd:0123:0000:0000:7689:6576]:23

• Eight colon-separated groups of hexadecimal digits with leading zeros omitted; for example:

  [1234:1234:abcd:123:0:0:7689:6576]:23

• Suppression of one or more consecutive all 0 groups; for example:

  [1234:1234:abcd:123::7689:6576]:23

-ntpip ntp_ip_address

(Optional) Specifies the IPv4/IPv6 address or fully qualified domain name (FQDN) for the Network Time Protocol (NTP) server. The maximum number of characters is 256. Configuring an NTP server address causes the system to use that NTP server as its time source. Specify the -ntpip parameter with a zero address to use another time source:

chsystem -ntpip 0.0.0.0

-ntpip_6 ipv6_ntp_ip_address

Note: Before you specify -ntpip_6, an IPv6 prefix and gateway must be set for the system.

(Optional) Specifies the IPv6 address for the NTP server. Configuring an NTP server address causes the system to immediately start using that NTP server as its time source. To choose another time source, specify the -ntpip_6 parameter with a zero address, as follows:

chsystem -ntpip_6 0::0

-isnsip sns_server_address

(Optional) Specifies the IPv4 address for the iSCSI storage name service (SNS). Specify the -isnsip parameter with a zero address to select another IPv4 iSCSI SNS server:

chsystem -isnsip 0.0.0.0

-isnsip_6 ipv6_sns_server_address

(Optional) Specifies the IPv6 address for the iSCSI SNS. Specify the -isnsip_6 parameter with a zero address to select another configured IPv6 iSCSI SNS server:

chsystem -isnsip_6 0::0

-relationshipbandwidthlimit bandwidth_in_mBps

(Optional) Deprecated. This setting is not used by the system.

-infocenterurl url

Specifies the preferred online documentation URL to override the one used by the GUI. Because this information is interpreted by the Internet browser, the specified information might contain a hostname or an IP address.

Remember: View the currently configured URL in the GUI preferences window. This window can also help reset this value to the default setting.

-chapsecretchap_secret

(Optional) Specifies the new Challenge-Handshake Authentication Protocol (CHAP) secret.

-nochapsecret

(Optional) Clears any previously set CHAP secret. The nochapsecret parameter cannot be specified when chapsecret is specified.

-layer replication | storage

(Optional) Specifies which layer a system is in. The system can create partnerships with systems in the same layer.

Note: If you specify -layer you must specify either replication or storage. This option can be used if no other systems are visible on the fabric, and no system partnerships are defined.

-cacheprefetch on | off

(Optional) Indicates whether cache prefetching is enabled or disabled across the system. Adjust this only when following direction from your product support information.

-localfcportmask port_mask

(Optional) Indicates the Fibre Channel (FC) input/output (I/O) port mask for local system node-to-node communications only. Fibre Channel port mask does not affect host or storage system traffic. The port mask is 64 binary bits and is made up of a combination of 0's and 1's, where 0 indicates that the corresponding FC I/O port cannot be used and 1 indicates that it can be used. The mask is applied to all nodes in the local system. At least two ports must be selected for local system node-to-node communications. The mask must result in at least 2 FC connections between each node in the local system, using only the selected ports and FC zones visible to those ports. Valid mask values might range from 0011 (only ports 1 and 2 enabled) to 1111111111111111111111111111111111111111111111111111111111111111 (all ports enabled). For example, a mask of 111111101101 enables ports 1, 3, 4, 6, 7, 8, 9, 10, 11, and 12.

Remember: A partial mask (fewer than 64 characters) is zero-extended, meaning that any ports that are not specified are not enabled.

Specify the lsportfc command to display FC I/O port IDs.

-partnerfcportmask port_mask

(Optional) Indicates the FC I/O port mask for partnered system-to-system communications only. Fibre Channel port mask does not affect host or storage system traffic. The port mask is 64 binary bits and is made up of a combination of 0's and 1's, where 0 indicates that the corresponding FC I/O port cannot be used and 1 indicates that it can be used. The mask is applied to all nodes in the local system. Valid mask values might range from 0000 (no ports enabled) to 1111111111111111111111111111111111111111111111111111111111111111 (all ports enabled). For example, a mask of 111111101101 enables ports 1, 3, 4, 6, 7, 8, 9, 10, 11, and 12.

Remember: A partial mask (fewer than 64 characters) is zero-extended, meaning that any ports not specified are not enabled.

Specify the lsportfc command to display FC I/O port IDs.

-hightempmode on | off

(Optional) Sets (or removes) High Temperature Mode (HTM). The values are on and off.

-topology standard

(Optional) Indicates the intended standard system topology.

-vdiskprotectiontime value_in_minutes

(Optional) Sets volume protection time (in minutes). The range is 15 - 1440.

-vdiskprotectionenabled yes | no

(Optional) Enables or disables volume protection. The values are yes and no.

-odx on | off

(Optional) Enables or disables offloaded data transfers (ODX). The values are on and off.

-easytieracceleration on | off

(Optional) Enables Easy Tier® and pool balancing acceleration. The values are on and off.

-maxreplicationdelay value_in_seconds

(Optional) Deprecated. This setting is not used by the system.

-partnershipexclusionthreshold value_in_seconds

(Optional) Deprecated. This setting is not used by the system.

-enhancedcallhome on | off

(Optional) Specifies that the call home function is to send enhanced reports to the support center. Valid values are yes or no.

The enhanced reports include operational and event-related data and specific configuration information that is included in the inventory report. This function alerts the support center about hardware failures and potentially serious configuration or environmental issues. The support center can use the configuration information to automatically generate best practices or recommendations that are based on your actual configuration.

-censorcallhome on | off

(Optional) Specifies that sensitive data is deleted from the enhanced call home data. The values are yes or no.

-hostunmap on | off

(Optional) Specifies whether the administrator wants the volumes to advertise support for unmap to hosts. The values are on (default) or off.

-backendunmap on | off

(Optional) Specifies whether the administrator wants to enable unmap support for backend storage. Enabling this parameter allows the system to issue Unmap or write same commands to compatible backend storage controllers and drives to reclaim capacity when capacity is freed within the system. The values are on (default) or off.

Note: If -backendunmap off is specified, the system may still issue unmap commands to drives if they are in a storage pool where the format_required property is yes.

-snapshotpolicysuspended yes | no

(Optional) Specifies the suspend or resume of the scheduler function. The valid values are yes or no.

Note: If -snapshotpolicysuspended parameter yes is specified, snapshots will no longer be automatically deleted or created by the snapshot scheduler.

Specify -snapshotpolicysuspended parameter no to resume the normal operations.

-easytier on | off

(Optional) Enables or disables the Easy Tier function on a system level. The values are on and off.

Note: After the completion of T3 recovery, the system disables the Easy Tier function by default. You can specify the -easytier on to enable this function on the system level.

-snapshotpreserveparent yes | no

(Optional) Specifies the snapshot and parent preservation behavior. The valid values are yes and no.

Note: If the value is set to no, the parent volume for snapshots goes offline when the system cannot maintain the snapshot. If the value is set to yes, the parent volume remains online and the snapshot is deleted. You can specify a single pool for the mirrored parent volumes if the -snapshotpreserveparent parameter is set to yes and the snapshot that is created is mirrored with a single copy in the specified pool.

-flashcopydefaultgrainsize 64 | 256

(Optional) Use this parameter to set the default grain size of all FlashCopy® mappings created after this value has been set. If the volume of a new FlashCopy mapping is already associated with mappings of a different grain size then the existing grain size that volume is using will be continued to be used.

-storageinsightscontrolaccess yes | no

(Optional) Indicates whether the storage insights control access for the system is enabled or disabled.

-autodrivedownload on | off

(Optional) Specifies whether the auto drive download feature for the system is enabled or disabled. The values are on (default) or off.