Dell EMC PowerVault ME4 Series Storage System CLI Guide July 2020 Rev.
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2018 – 2020 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents Chapter 1: Using the CLI................................................................................................................. 11 Accessing the CLI................................................................................................................................................................. 11 CLI output formats...............................................................................................................................................................
create peer-connection...................................................................................................................................................... 47 create replication-set.......................................................................................................................................................... 48 create schedule.............................................................................................................................................
reset disk-statistics............................................................................................................................................................. 94 reset dns-management-hostname....................................................................................................................................94 reset host-link.......................................................................................................................................................
set protocols.......................................................................................................................................................................139 set replication-set............................................................................................................................................................... 141 set schedule.....................................................................................................................................
show iscsi-parameters...................................................................................................................................................... 207 show license.......................................................................................................................................................................208 show maps................................................................................................................................................
verify disk-groups.............................................................................................................................................................. 274 verify links...........................................................................................................................................................................275 verify vdisk....................................................................................................................................
fan-modules....................................................................................................................................................................... 345 fc-port................................................................................................................................................................................ 346 fde-state....................................................................................................................................
sas-port.............................................................................................................................................................................. 384 sas-status-controller-a..................................................................................................................................................... 384 sas-status-drawer...................................................................................................................................
1 Using the CLI This chapter introduces the command-line interface (CLI). Topics: • • • • • • • • Accessing the CLI CLI output formats Using CLI interactively Using a script to access the CLI Command syntax Command completion, editing, and history Size representations Event log Accessing the CLI The CLI software that is embedded in the controller modules enables you to manage and monitor storage-system operation.
Product name System Name: Name System Location: Location Version: firmware version # show controller-date Controller Date: 2019-09-30 11:05:12 Time Zone Offset: -07:00 Success: Command completed successfully. (2019-09-30 11:05:12) # exit Using a script to access the CLI Basic command-line semantics provide prompts for user input, and response time is indeterminate. Scripts need to use an “expect”-type mechanism to scan output for prompts.
# Once the script has logged in, the response returns back a session key. # This code shows how to retrieve that session key.
The output of each CLI command is composed of valid XML data until the CLI prompt (typically #) is encountered. The output contains a valid XML header followed by the XML elements described in the following table. Table 1. XML API elements Element Description and attributes RESPONSE The RESPONSE element is the top-level element, which contains all data output for the CLI command that was issued. The response includes: • • A number of OBJECT elements, which varies by command.
"object-name":"controller-a-versions", "sc-cpu-type":"SC-CPU-type", "bundle-version":"bundle-version", "bundle-base-version":"bundle-base-version", "build-date":"Mon Jul 17 14:15:44 MDT 2017", ... }, { "object-name":"controller-b-versions", ... } ], "status":[ { "object-name":"status", "response-type":"Success", "response-type-numeric":0, "response":"Command completed successfully.
} ] In a script, each command should check the previous command’s status before proceeding. If the value of the status object’s returncode property is 0, the command succeeded; any other value means that the command failed. NOTE: If you script an operation to repeatedly add and remove disk groups, set a delay of at least two minutes between deleting a disk group and creating the next one.
The following example shows brief mode output, in which a subset of attributes is returned, and use of embedded objects: # show ports
Specifying disks Disks are specified by enclosure ID and slot number. Enclosure IDs increment from 0. Disk IDs increment from 0 in each enclosure. You can specify: • • • • A disk. Example: 1.4 A hyphenated range of disks. Example: 1.4-7 A comma-separated list of individual disks, ranges, or both (with no spaces). Example: 1.4,1.6-9 A RAID 10 or 50 disk group with disks in subgroups separated by colons (with no spaces). RAID-10 example:1.1-2:1.3-4:1.7,1.
Specifying initiators and hosts You can specify: • • • • An FC initiator by its nickname or 16-hex-digit WWPN. A SAS initiator by its nickname or 16-hex-digit WWPN. An iSCSI initiator by its nickname or node name (typically the IQN). A host by name in the format host-name.*, where * represents all initiators in the host. Example: Mail_Server.* Specifying host groups For virtual storage, you can specify: • A host group by name in the format host-group.*.
Table 2. Keyboard shortcuts for command completion, editing, and history (continued) Action Press Delete previous character Backspace Size representations Operating systems usually show volume size in base 2. Disk drives usually show size in base 10. Memory (RAM and ROM) size is always shown in base 2. In the CLI, the base for entry and display of storage-space sizes can be set per user or per session; see create user on page 56 and set set cli-parameters on page 110.
2 Categorical list of commands The following table helps you find a command within a category of functionally related commands: NOTE: A command might appear in more than one category. Table 5.
Table 5.
3 Alphabetical list of commands This chapter is organized to help you find a command by name.
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 24 create volume create volume-group create volume-set delete all-snapshots delete chap-records delete host-groups delete hosts delete initiator-nickname delete peer-connection delete pools delete remote-system delete replication-set delete schedule delete snapshot delete task delete user delete vdisks delete volume-groups delete volumes dequarantine exit expand disk-group expand vdisk expand
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • scrub disk-groups scrub vdisk scrub volume send support-assist-logs set advanced-settings set chap-record set cli-parameters set cloudiq set controller-date set debug-log-parameters set disk set disk-group set disk-parameters set dns-managment-hostname set dns-parameters set email-parameters set enclosure set expander-fault-isolation set expander-phy set fde-import-key set fde-lock-key set fde-
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 26 show cloudiq show configuration show controller-date show controllers show controller-statistics show debug-log-parameters show disk-groups show disk-group-statistics show disk-parameters show disks show disk-statistics show dns-management-hostname show dns-parameters show email-parameters show enclosures show events show expander-status show fan-modules show fans show fde-state show fenced
• • • • • • • • • • • • • • • • • • • • • • • • • show system show system-parameters show tasks show tiers show tier-statistics show unwritable-cache show users show vdisks show vdisk-statistics show versions show volume-copies show volume-groups show volume-names show volume-reservations show volume-statistics show volumes shutdown suspend replication-set test trust unfail controller unmap volume verify disk-groups verify links verify vdisk abort copy Description Aborts a copy volume operation.
If you abort a running replication, the replication set returns to the state it had before replication started – either Ready or Unsynchronized. If you abort a suspended replication, the state of the replication set remains Suspended. NOTE: If you abort a replication operation, the snapshot space that is allocated for that replication in the primary pool and the secondary pool will not be freed. To free that space, either re-run the initial replication or delete the replication set.
scrub vdisk scrub volume show disk-groups show vdisks show volumes abort verify Description Aborts a media verify operation. Minimum role manage Syntax abort verify [disk-group disk-groups] [vdisk vdisks] Parameters disk-group disk-groups Optional. A comma-separated list of the names or serial numbersof the disk groups to stop verifying. A name that includes a space must be enclosed in double quotes. vdisk vdisks Optional.
• As read cache. A virtual pool can contain only one read-cache disk group A virtual pool cannot contain both a read-cache disk group and a Performance tier. At least one virtual disk group must exist in a pool before a read-cache disk group can be added. A read-cache disk group can contain a maximum of two disks. When you add a virtual disk group, the system will first prepare the disk group to be added to a virtual pool.
size of the RAID-50 group is calculated as: configured-chunk-size x (subgroup-members - 1). The default is 512k. For virtual storage, the system will use one of the following chunk sizes, which cannot be changed: • • RAID 1: Not applicable. RAID 5 and RAID 6: • ○ With 2,4, or 8 non-parity disks: 512k. For example, a RAID-5 group with 3, 5, or 9 total disks or a RAID-6 group with 4, 6, or 10 total disks.
Required. Specifies the type of disk group to create. • • • linear : A disk group for linear storage. virtual : A disk group for virtual storage. read-cache : A disk group for use as read cache for a virtual pool. name Optional for a virtual or read-cache disk group. Required for a linear disk group. Specifies a name for the new disk group. The name must be unique system-wide. Input rules: • • • • The value is case sensitive. The value can have a maximum of 32 bytes.
See also remove host-group-members show host-groups show initiators add host-members Description Adds initiators to a host. A host can contain a maximum of 128 initiators. To add an initiator to a host, the initiator must be mapped with the same access, port, and LUN settings to the same volumes or volume groups as every other initiator in the host.
• • • The value can include spaces and printable UTF-8 characters except: " , < \ A value that includes a space must be enclosed in double quotes. If this parameter is specified, each interface needs a unique name withinthe scope of each controller. For example, controller A can have only one address labeled vlan1, and controller B can also have only one address labeled vlan1 . controller a|b Optional. Specifies to change controller A or B, only.
disks Parameters disk-group disk-group Optional. The name or serial number of a linear disk group to assign the disks to as dedicated spares. A name that includes a space must be enclosed in double quotes. If this parameter is omitted, the disks will be global spares. vdisk vdisk Optional. The name or serial number of the linear disk group to assign the disks to as dedicated spares. A name that includes a space must be enclosed in double quotes.
# add storage Add storage to a single enclosure. # add storage enclosure 3 Preview a storage configuration which could be added.
check firmware-upgrade-health Description Checks that the system is ready for a firmware upgrade. Under normal conditions, firmware upgrade can be performed safely without risk to data availability or integrity. However, when the system is degraded—for example, because of failed or missing components or lack of multipathing to disks—upgrade failure or loss of availability can occur.
show enclosures show fans show power-supplies show sensor-status show system show vdisks check support-assist Description Checks the connection from the storage system to the SupportAssist server. Minimum role manage Syntax check support-assist Output A message specifies whether the storage system can connect to the SupportAssist server and transmit data to it. Examples Check the connection from the storage system to the SupportAssist server.
show volumes clear disk-metadata Description Clears metadata from leftover disks. For a leftover disk, the show disks command shows the Usage value LEFTOVR. CAUTION: Only use this command when all disk groups are online and leftover disks exist. Improper use of this command may result in data loss. NOTE: If you are uncertain whether to use this command, contact technical support for assistance.
Optional. Specifies whether to change controller A, B, or both. If this parameter is omitted, changes affect the controller being accessed. Examples Clear DNS settings for controller A. # clear dns-parameters controller a See also set dns-parameters set email-parameters show dns-parameters show email-parameters clear events Description Clears the event log in controller A, B, or both. Minimum role manage Syntax clear events [a|b|both] Parameters [a|b|both] Optional.
clear fde-keys Description Clears the lock key ID and import lock ID used with Full Disk Encryption. Use this command to temporarily deny access to data on the disks during a period when the system will not be under your physical control. If the lock keys are cleared while the system is secured, the system enters the Secured, Lock Ready state, in preparation for the system being powered off and transported. No further FDE configuration is allowed until the system has been power that is cycled.
clear replication-queue Description Clears the replication queue for a specified replication set. If a replication request is initiated for a replication set that is already running a replication, and the replication set’s queue policy is Queue Latest, the new replication request will be queued. A maximum of one replication can be queued. If a queued replication is removed, event 587 will be logged with Informational severity.
Reasons to promote a snapshot include: • • • • • • You want to delete the snapshot's base volume without losing the data in the snapshot. You want to set a different tier preference for a snapshot than for its parent (or for another snapshot in the same tree). You don't want the volume's unique data to be counted against overall pool snapshot space (because it might cause deletion of other snapshots).
show volumes create certificate Description Creates or removes a custom security certificate. The storage system supports use of unique certificates for secure data communications, to authenticate that the expected storage systems are being managed. Use of authentication certificates applies to the HTTPS protocol, which is used by the web server in each controller module. The PowerVault Manager and SMI-S interfaces use the same certificate.
See also restart mc restart sc show certificate create chap-record Description Creates a CHAP record to authenticate iSCSI login requests. When CHAP is enabled, the record enables authentication between the originator (initiator) and recipient (target) of a login request. This command is permitted whether or not CHAP is enabled.
set chap-record show chap-records show iscsi-parameters show ports create host Description Creates a host with an associated name. You can use the create host command to create a host that groups together specified initiators, and optionally to add the host to a host group. You can create a maximum of 512 hosts, each containing a maximum of 128 initiators. To create a single initiator, use the set initiator command.
create host-group Description Creates a host group that includes specified hosts. You can create a maximum of 32 host groups, each containing a maximum of 256 hosts. Minimum role manage Syntax create host-group hosts hosts host-group Parameters hosts hosts A comma-separated list of the names of hosts to include in the host group. A name that includes a space must be enclosed in double quotes. host-group A name for the host group. Input rules: • • • • Examples The value is case sensitive.
• • Ports with optimized paths are used first. If no optimized path exists, ports with unoptimized paths are used . If only one port has an optimized path, then only that port is used. The replication does not use another available port until all used ports become unavailable. If a single host port loses connectivity, event 112 is logged. Because a peer connection is likely to be associated with multiple host ports, the loss of a single host port may degrade performance.
For the maximum number of replication sets that can be created, see the “System configuration limits” topic in the PowerVault Manager help. This command designates the specified source volume or volume group as the primary volume or volume group. This command also creates the secondary volume or volume group, and creates the internal snapshots that are required to support replications.
Syntax create replication-set peer-connection peer-connection-ID primary-address ip= IPs|wwnn= WWNNs] primary-volume volume-ID | volume-group-ID [queue-policy discard|queue-latest] [secondary-pool A|B] [secondary-volume-name name] [snapshot-basename basename] [snapshot-count #] [snapshot-history disabled|off|secondary|both] [snapshot-retention-priority never-delete|high|medium|low] name Parameters peer-connection peer-connection-ID Specifies the name or serial number of the peer connection on which to cr
Specifies the number of snapshots that are taken of the replication volume to retain, from 1 to 16. When a new snapshot exceeds this limit, the oldest snapshot in the snapshot history is deleted. The snapshot-count setting can be changed at any time. Its value must be greater than the number of existing snapshots in the replication set, regardless of whether snapshot-history is enabled. snapshot-history disabled|off|secondary|both Optional.
create schedule Description Schedules a task to run automatically. You can schedule a replication task on the replication set of the primary system only. Minimum role manage Syntax create schedule schedule-specification "specification" task-name task-name schedule-name Parameters schedule-specification "specification" Defines when the task first runs, and optionally when it recurs and expires. You can use a comma to separate optional conditions. Dates cannot be in the past.
# create schedule schedule-specification "start 2018-03-01 00:01, every 1 days, between 12:00 AM and 1:00 AM, expires 2019-01-01 1:00 AM" task-name Task1 Sched1 Create schedule Sched2 that runs Task2 for the first time on March 1, 2019, and on the first weekday of each month, with no expiration.
• • • Create a snapshot of a source volume, which can be a virtual base volume or a virtual snapshot. Reset a snapshot. This deletes the data in the snapshot and resets it to the current data in the volume from which the snapshot was created. The snapshot’s name and other volume characteristics are not changed.
For a TakeSnapshot task this specifies the number of snapshots created by this task to retain, from 1 to 8 if the large-pools feature is enabled, or from 1 to 16 if the large-pools feature is disabled. When a new snapshot exceeds this limit, the oldest snapshot with the same prefix is deleted snapshot-prefix prefix For a TakeSnapshot task this specifies a label to identify snapshots created by this task. Input rules: • • • • The value is case sensitive. The value can have a maximum of 26 bytes.
show volumes create user Description Creates a user account. The system supports 12 user accounts. You can create a standard user that can access the PowerVault Manager, CLI, SFTP, or FTP interface. You can also create an SNMPv3 user that can access the MIB or receive trap notifications. SNMPv3 user accounts support SNMPv3 security features such as authentication and encryption.
Optional. Specifies the interfaces that the user can access. Multiple values must be separated by commas and no spaces. A command that specifies snmpuser or snmptarget cannot also specify a non-SNMP interface. • • • • • • • cli: Command-line interface. This is enabled by default. wbi: PowerVault Manager web-browser interface. This is enabled by default. ftp: FTP or SFTP interface. smis: Storage Management Initiative Specification (SMI-S) interface. Not supported for a system with 5U84 enclosures.
Multiple values must be separated with a comma (with no spaces). If multiple values are specified, the access to commands is determined by the highest role specified. storage-size-base 2|10 Optional. Alias for base. storage-size-precision # Optional. Alias for precision storage-size-units auto|MB|GB|TB Optional. Alias for units. temperature-scale celsius|c|fahrenheit|f Optional. Sets the scale for display of temperature values: • • fahrenheit or f: Temperatures are shown in degrees Fahrenheit.
Enter new password: ******** Re-enter new password: ******** See also delete user set snmp-parameters set user show users create vdisk Description Creates a linear disk group using the specified RAID level, disks, and spares. This command applies to linear storage only. All disks in the disk group must be the same type (enterprise SAS, for example). NOTE: A disk group can contain a mix of 512-byte native sector size (512n) disks and 512-byte emulated sector size (512e) disks.
level nraid|raid0|r0|raid1|r1|raid3|r3|raid5|r5|raid6|r6|raid10|r10 |raid50| r50Specifies the RAID level. mode online|offline Optional. Specifies whether the disk group is initialized online or offline. • • online: Enables you to use the disk group immediately after creating it while it is initializing. Because online uses the verify method to create the disk group, it takes longer to complete initializing than offline. Online initialization is fault-tolerant. This option is the default.
snapshots to delete. Snapshots are considered to be eligible for deletion if they have any retention priority other than never-delete. Eligible snapshots are considered for deletion by priority and age. The oldest, lowest priority snapshots are deleted first. Snapshots that are mapped or are not leaves of a volume’s snapshot tree are not eligible for automatic deletion.
snapshot-retention-priority never-delete|high|medium|low Optional. For virtual storage, this specifies the retention priority for snapshots of the volume. • • • • never-delete: Snapshots will never be deleted. high: Snapshots may be deleted after all eligible medium-priority snapshots have been deleted. medium: Snapshots may be deleted after all eligible low-priority snapshots have been deleted. This is the default. low: Snapshots may be deleted. tier-affinity no-affinity|archive|performance Optional.
show volumes create volume-group Description Creates a volume group that includes specified volumes. You can create a maximum of 256 volume groups. A volume group can contain a maximum of 1024 volumes. All volumes in a volume group must be in the same pool. Minimum role manage Syntax create volume-group volumes volumes volume-group Parameters volumes volumes A comma-separated list of the names or serial numbers of virtual volumes to add to the specified volume group.
priority snapshots are deleted first. Snapshots that are mapped or are not leaves of a volume’s snapshot tree are not eligible for automatic deletion.
Optional. The controller ports to use for the mapping. All ports must be the same type (FC, for example). For port syntax, see Command syntax. If not all ports are specified, the unspecified ports are not mapped. If the ports and baselun parameters are omitted, the volumes are not mapped. size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] Sets the volume size. The unit is optional (B represents bytes). If base 2 is in use, whether you specify a base-2 or base-10 unit, the resulting size will be in base 2.
delete volumes map volume set volume show maps show pools show vdisks show volume-groups show volumes unmap volume delete all-snapshots Description Deletes all snapshots associated with a specified source volume. This command applies to virtual storage only. The source volume can be a base volume or a snapshot. All data associated with the snapshots is deleted and their space in the snap pool is freed for use. The snapshot schedules and tasks are also deleted.
delete chap-records name originator-name To delete all CHAP records: delete chap-records all Parameters name originator-name The originator name, typically in IQN format. all Delete all CHAP records in the database. Examples Delete the CHAP record for a specific originator. # delete chap-records name iqn.1991-05.com.microsoft:myhost.domain Delete all CHAP records.
delete hosts Description Deletes specified hosts that are not in a host group. Mapped and unmapped hosts can be deleted. Deleting a host does not delete its initiators. Volume maps continue to apply to the initiators in the host that is deleted. Minimum role manage Syntax delete hosts hosts|all Parameters hosts|all Specifies either: • • Examples A comma-separated list of the names of hosts to delete. A name that includes a space must be enclosed in double quotes. all: Deletes all hosts.
set initiator show initiators delete peer-connection Description Deletes a peer connection between two storage systems. You can run this command on either the local or remote system. You cannot delete a peer connection if any replication sets are using it Minimum role manage Syntax delete peer-connection [local-only] peer-connection-ID Parameters local-only Optional.
Minimum role manage Syntax delete pools [prompt yes|no] pools Parameters [prompt yes|no] Optional. For scripting, this specifies an automatic reply to confirmation prompts: • • yes: Allow the command to proceed. no: Cancel the command. If this parameter is omitted, you must manually reply to prompts. pools A comma-separated list of the names or serial numbers of the pools to delete. For a linear pool, a name that includes a space must be enclosed in double quotes. Examples Delete virtual pool A.
When you delete a virtual replication set, the internal snapshots created by the system are also deleted. However, no user data is deleted. The primary and secondary volumes can be used like any other base volumes. You cannot delete a virtual replication set if it has a replication in progress. If you want to delete a replication set that has a replication in progress, you must first suspend and then abort replication for that replication set.
If this parameter is omitted, you must manually reply to prompts. schedule The name of the schedule to delete. Examples Delete schedule Sched1. # delete schedule Sched1 See also create schedule set schedule show schedules delete snapshot Description Deletes specified snapshots. This command applies to virtual storage only. All data uniquely associated with the snapshot is deleted and associated space in the pool is freed for use. The snapshot's schedules are also deleted.
The name of the task to delete. Examples Delete task Task1. # delete task Task1 See also create task delete schedule show schedules show tasks delete user Description Deletes a user account. You can delete any user, except for the user you are logged in as. However, the system requires at least one CLI user with the manage role to exist. When a user is deleted, any sessions associated with that user name are terminated. This command has a confirmation prompt in interactive console mode.
Optional. For scripting, this specifies an automatic reply to confirmation prompts: • • yes: Allow the command to proceed. no: Cancel the command. vdisks If this parameter is omitted, you must manually reply to prompts. A comma-separated list of the names or serial numbers of the linear disk groups to delete. A name that includes a space must be enclosed in double quotes. Examples Delete linear disk groups VD1 and VD2.
CAUTION: Deleting a volume will delete all data it contains, and its schedules. NOTE: For virtual storage, you cannot delete a volume that is in a replication set. This command has a confirmation prompt in interactive console mode. Minimum role manage Syntax delete volumes volumes Parameters volumes A comma-separated list of the names or serial numbers of the volumes to delete. A name that includes a space must be enclosed in double quotes Examples Delete volumes vol1 and vol2.
• During system operation, a disk group loses redundancy plus one more disk. For example, three disks are inaccessible in a RAID-6 disk group or two disks are inaccessible for other fault-tolerant RAID levels. The disk group will be automatically dequarantined if after 60 seconds the disk group status is FTOL, FTDN, or CRIT. Quarantine isolates the disk group from host access and prevents the system from changing the disk group status to OFFL (offline).
vdisk vdisk Parameters disk-group disk-groupThe name or serial number of the disk group to remove from quarantine. A name that includes a space must be enclosed in double quotes.vdisk vdisk The name or serial number of the linear disk group to remove from quarantine. A name that includes a space must be enclosed in double quotes. Examples After determining that linear disk group VD1 is quarantined, remove it from quarantine and re-check its status. # show vdisks Name ... Status ...
replacement of spares or failed disks—the disk group is changed to contain only one type of disk, you will only be able to add disks of that type to the disk group. NOTE: A disk group can contain a mix of 512-byte native sector size (512n) disks and 512-byte emulated sector size (512e) disks. For consistent and predictable performance, do not mix disks of different sector size types (512n, 512e).
• • yes: Allow the command to proceed. no: Cancel the command If this parameter is omitted, you must manually reply to prompts. disk-group The name or serial number of the disk group to expand. A name that includes a space must be enclosed in double quotes. Examples Expand disk group DG1 to include disk 1.11. # expand disk-group disks 1.11 DG1 Expand a RAID-10 disk group named R10 to include an additional mirror pair. # expand disk-group disks 2.
• • • When set to the default spare capacity, the system will try to replenish spare capacity to be the sum of the two largest disks in the group. When default spare capacity has been overridden (via the set vdisk on page 156 adapt-targetspare-capacity parameter), the system will try to replenish spare capacity to meet the configured target GiB. If the actual spare capacity meets the target spare capacity, the new disk capacity will be allocated to user data.
For virtual storage, if overcommit is disabled, expansion is restricted to the space available in the pool that contains the volume. If overcommit is enabled, the volume size can exceed the physical capacity of the pool. The maximum volume size is 140 TB (128 TiB). To see whether overcommit is enabled, use the show pools command. For linear storage, if insufficient space is available for expansion in the disk group, first expand the disk group by using expand vdisk.
help Description Shows brief help for all available commands or full help for a specific command. This help topic also provides tips for using command shortcuts.
initiator initiators|hosts|host-groups [lun LUN] [ports ports] Parameters volumes|volume-groups A comma-separated list of the names or serial numbers of the volumes or volume groups to map. For volume and volume-group syntax, see Command syntax access read-write|rw|read-only|ro|no-access Optional. The access permission to use for the mapping: read-write (rw), read-only (ro), or no-access. If the access parameter is specified as read-write or read-only, the lun parameter must be specified.
unmap volume meta Description In API format only, shows all property metadata for objects. This includes data not shown in brief mode. Minimum role monitor Syntax meta basetypes Parameters basetypes A basetype or a list of basetypes separated by commas (with no spaces) to specify the objects for which to show metadata.
remote-port-address Parameters remote-port-addressSpecifies the FC WWN or iSCSI IP address of the system to query. IPv4 and IPv6 formats are supported. Output Controller • • A: Controller A. B: Controller B. Storage Controller Code Version Storage Controller firmware version and loader version. Management Controller Code Version Management Controller firmware version and loader version. IPv4 Address Controller network port IPv4 address.
release volume Description Clears initiator registrations and releases persistent reservations for all or specified volumes. Normally, reservations placed on volumes by initiators accessing those volumes can be released by host software. This command should be used only when the system is in an abnormal state, perhaps due to a configuration problem, and you need to remove all reservations for specified volumes and return them to a “clean” state.
• • You cannot remove the last disk group from the only pool in a system that is used in a peer connection, or a disk group that contains a volume that is used in a replication set. If you delete a quarantined disk group and its missing disks are later found, the group will reappear as quarantined or offline and you must delete it again (to clear those disks). Minimum role manage Syntax remove disk-groups [prompt yes|no] disk-groups Parameters prompt yes|no Optional.
show initiators remove host-members Description Removes specified initiators from a host. You cannot remove all initiators from a host. At least one initiator must remain. The initiators are ungrouped but not deleted. Minimum role manage Syntax remove host-members initiators initiators host-name Parameters initiators initiators A comma-separated list of the names of initiators to remove from the host. A name that includes a space must be enclosed in double quotes. host-name The name of the host.
ip-address IP-address Optional. Specifies the address to remove. Examples Remove the IPv6 address named vlan1 from controller A. # remove ipv6-address controller a address-label vlan1 See also add ipv6-address set ipv6-network-parameters show ipv6-addresses show ipv6-network-parameters remove spares Description Removes specified spares. You can remove global spares and dedicated spares (linear storage only) in the same command.
volume-groupThe name of the volume group. A name that includes a space must be enclosed in double quotes. Examples Remove volumes Vol0002 and Vol0003 from volume group VolumeGroup1. # remove volume-group-members volumes Vol0002,Vol0003 VolumeGroup1 See also delete replication-set delete volume-groups show volume-groups show volumes replicate Description Initiates replication of volumes in a replication set. This command must be run on the replication set’s primary system.
rescan Description This command forces rediscovery of disks and enclosures in the storage system. CAUTION: Performing a rescan will temporarily pause all I/O processes. If both Storage Controllers are online and able to communicate with both expansion modules in each connected enclosure, this command rebuilds the internal SAS layout information, reassigns enclosure IDs based on controller A’s enclosure cabling order, and ensures that the enclosures are displayed in the proper order.
reset controller-statistics reset disk-group-statistics reset disk-statistics reset host-port-statistics reset pool-statistics reset vdisks-statistics reset volume-statistics show controller-statistics reset controller-statistics Description Resets performance statistics for controllers. This command resets all controller statistics except Power On Time and Total Power On Hours. Minimum role manage Syntax reset controller-statistics [a|b|both] Parameters a|b|both Optional.
• Number of bad blocks found To reset other disk statistics, use the reset disk-statistics command. Minimum role manage Syntax reset disk-error-statistics [disks] Parameters disks Optional. The IDs of the disks for which to reset statistics. For disk syntax, see Command syntax. If this parameter is omitted, statistics are reset for all disks Examples Reset error statistics for disks 1.1 and 2.1. # reset disk-error-statistics 1.1,2.
show controller-statistics show disk-group-statisticsshow disk-groups reset disk-statistics Description Resets performance statistics for disks. This command resets basic disk statistics but not disk error statistics. To reset these, use the reset diskerror-statistics command. Lifetime statistics are not resettable. Minimum role manage Syntax reset disk-statistics Examples Reset statistics for all disks.
reset host-link Description Resets specified controller host ports (channels). CAUTION: Resetting host links may cause lost connection to hosts. For FC, you can reset a single port. For an FC host port configured to use FC-AL (loop) topology, a reset issues a loop initialization primitive (LIP). For iSCSI, you can reset a port pair (either the first and second ports or the third and fourth ports). For SAS, you can reset a port pair (either the first and second ports or the third and fourth ports).
show ports reset pool-statistics Description Clears resettable performance statistics for virtual pools, and resets timestamps for those statistics. Minimum role manage Syntax reset pool-statistics [pool] Parameters pool Optional. The name or serial number of the virtual pool for which to reset statistics. A name that includes a space must be enclosed in double quotes. If this parameter is omitted, statistics are reset for both pools A and B. Examples Reset statistics for pool A.
• • yes: Allow the command to proceed. no: Cancel the command. If this parameter is omitted, you must reply to prompts.noprompt Optional. Suppresses confirmation prompts. Specifying this parameter allows the command to proceed without user interaction. Output Messages are displayed when the SMI-S configuration is reset and SMI-S is restarted. Examples Reset the SMI-S configuration on controller A, to which you are logged in.
reset vdisk-statistics Description Resets performance statistics for all or specified linear disk groups. This command applies to linear storage only. Minimum role manage Syntax reset vdisk-statistics [vdisks] Parameters [vdisks] Optional. A comma-separated list of the names or serial numbers of the linear disk groups for which to reset statistics. A name that includes a space must be enclosed in double quotes. If this parameter is omitted, statistics are reset for all linear disk groups.
reset pool-statistics reset vdisks-statistics reset volume-statistics reset disk-statistics show volumes restart mc Description Restarts the Management Controller in a controller module. When you restart a Management Controller, communication with it is lost until it successfully restarts. If the restart fails, the partner Management Controller remains active with full ownership of operations and configuration information.
between the two controllers. For more information, see help for commands that show statistics. Minimum role manage Syntax restart sc [a|b|both] [noprompt] Parameters [a|b|both] Optional. The controller module containing the controller to restart. If this parameter is omitted, the command affects the controller being accessed. [noprompt] Optional. Suppresses confirmation prompts. Specifying this parameter allows the command to proceed without user interaction .
# restore defaults See also reset smis-configuration restart mc restart sc resume replication-set Description Resumes the replication operations for the specified replication set. This command applies to virtual storage only. You can run this command on the primary system. When a replication set is suspended, all replications in progress are paused and no new replications are allowed to start.
Minimum role manage Syntax rollback volume [prompt yes|no] snapshot snapshot volume Parameters [prompt yes|no] Optional. For scripting, this specifies an automatic reply to confirmation prompts: • • yes: Allow the command to proceed. no: Cancel the command. If this parameter is omitted, you must manually reply to prompts. snapshot snapshot The name or serial number of the snapshot containing the data to roll back to. A name that includes a space must be enclosed in double quotes.
scrub vdisk Description Analyzes specified linear disk groups to find and fix disk errors. This command applies to linear storage only. This command acts on disks in a linear disk group but not dedicated spares or leftover disks. This command will fix parity mismatches for RAID 3, 5, 6, and 50; find mirror mismatches for RAID 1 and 10; and fix media errors for all RAID levels. Linear disk-group scrub can last over an hour, depending on disk-group size, utility priority, and amount of I/O activity.
# scrub volume vol1 See also set advanced-settings abort scrub (with the volume parameter) show volumes send support-assist-logs Description Sends storage-system log files to the SupportAssist server. Use this command to force collection and transmittal of log data to the server, instead of waiting for the SupportAssist feature to do so automatically.
[missing-lun-response notready|illegal] [partner-firmware-upgrade enabled|disabled|on|off] [partner-notify enabled|disabled|on|off] [power-supply-failure enabled|disabled|on|off] [restart-on-capi-fail enabled|disabled|on|off] [single-controller] [smart enabled|disabled|on|off|detect-only] [spin-down enabled|disabled|on|off] [spin-down-delay delay] [super-cap-failure enabled|disabled|on|off] [sync-cache-mode immediate|flush] [temperature-exceeded enabled|disabled|on|off] [utility-priority low|medium|high] Pa
• • disabled or off:The CompactFlash failure trigger is disabled. enabled or on: The CompactFlash failure trigger is enabled. This is the default. controller-failure enabled|disabled|on|off Optional. Sets whether the cache policy will change from write-back to write-through when a controller fails. • • disabled or off: The controller failure trigger is disabled. This is the default. enabled or on: The controller failure trigger is enabled. dynamic-spares enabled|disabled|on|off Optional.
missing-lun-response notready|illegal Optional. Some operating systems do not look beyond LUN 0 if they do not find a LUN 0 or cannot handle noncontiguous LUNs. This parameter handles these situations by enabling the host drivers to continue probing for LUNs until they reach the LUN to which they have access.
Optional. Sets whether spinning disks that are available or are global spares will spin down after a period of inactivity shown by the spin-down-delay parameter. • • disabled or off:Drive spin down for available disks and global spares is disabled. This is the default. Disabling spin down will set the spin-down delay to 0. enabled or on:Drive spin down for available disks and global spares is enabled. If the spin-down-delay parameter is not specified, the delay will be set to 60 minutes.
show advanced-settings set chap-record Description Changes an iSCSI originator’s CHAP record. You can change the record’s secret, mutual name, and mutual secret values. This command is permitted whether or not CHAP is enabled. For a login request from an initiator to a storage system, the initiator is the originator and the storage system is the recipient. Because CHAP works during login, to make CHAP changes take effect you must reset any active iSCSI host links.
set cli-parameters Description Sets options that control CLI behavior. If you are accessing the CLI through the network port, settings apply to the current CLI session only. If you are accessing the CLI through the enclosure’s CLI port, settings persist across sessions. The base, locale, precision, temperature scale, timeout, and units settings are read from the user’s account, and can be overridden by using this command.
locale English|en|Spanish|es|French|fr|German|de|Japanese|ja|Korean|ko| Chinese-simplified|zh-s Optional. The display language. The default is English. pager enabled|on|disabled|off Optional. • • enabled or on: Halts output after each full screen to wait for keyboard input. This is the default. disabled or off: Output is not halted. When displaying output in API format, which is intended for scripting, disable paging. precision # Optional.
See also show cli-parameters set cloudiq Description Enables or disables the ability to use the Dell EMC CloudIQ application on a remote device to monitor, analyze, and troubleshoot the storage environment. Storage-system configuration data is sent hourly and performance data is sent every 15 minutes. CloudIQ cannot be used until the SupportAssist agreement is accepted and SupportAssist is enabled. When the agreement is accepted and SupportAssist is first enabled, CloudIQ is automatically enabled.
set controller-dat timestamp timestamp timezone +|-hh[:mm] To configure use of NTP: set controller-date ntp enabled|disabled|on|off ntpaddress address timezone +|-hh[:mm] Parameters jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec The month. day The day number (1–31). hh:mm:ss The hour (0–23), the minutes (0–59), and the seconds (0–59). year The year as a four-digit number. ntp enabled|disabled|on|off Enables or disables use of NTP.
set debug-log-parameters Description Sets the types of debug messages to include in the Storage Controller debug log. NOTE: This command is for use by or with direction from technical support. Minimum role manage Syntax set debug-log-parameters message-type+|- [...] Parameters message-type+|One of the following message types, followed by a plus (+) to enable or a minus (-) to disable inclusion in the log: • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • autotest: Auto-test debug messages.
set disk Description Performs a secure erase on a specified disk. This is called repurposing the disk, and only applies to an FDEcapable disk. This command can only be run on disks whose status is AVAIL, or UNUSABLE due to having a foreign lock key. AVAIL disks have had all disk group information removed from them. Secure erasing such disks is an extra step to make all data on the disk irretrievable.
[owner a|b] [spin-down-delay delay] disk-group Parameters [adapt-spare-capacity size [B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]|default] Optional. For an ADAPT disk group, this specifies the target spare capacity. • • size [B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]: Sets the target spare capacity to a specific size. The unit is optional (B represents bytes). If no unit is specified, GiB will be used, regardless of the current base. Whichever unit is set, internally the value will be rounded down to the nearest GiB.
• For spinning disks, the drive spin down feature monitors disk activity within system enclosures and spins down inactive disks, based on user-specified settings. This command sets spin-down parameters for available disks and global spares. Spin-down settings do not affect leftover disks. To set spin-down parameters for a linear disk group, use the set vdisk command.
name hostname A host name to use for a controller. • • • • • Examples The name must differ for each controller. A name can have from 1 to 63 bytes. The value is case sensitive. A name must start with a letter and end with a letter or number. A name can include letters, numbers, or hyphens; no periods. Set the domain host name for controller A.
Optional. An ordered list of domain names to search when resolving host names that are configured in the storage system. You can specify a comma-separated list containing from one to three domain names, with a maximum of 255 characters per domain name. The resolver will query the network in the order prescribed by the list until finding a match. Examples Configure the system to query the name server at IP address 8.8.8.8, or at 8.8.6.6 if 8.8.8.
Optional. When the managed logs feature is enabled, this option activates the “push” mode, automatically attaching system log files to managed-logs email notifications that are sent to the log collection system. This option is disabled by default. notification-level crit|error|warn|resolved|info|none The minimum severity for which the system should send notifications: • • • • • • crit: Sends notifications for Critical events only. error: Sends notifications for Error and Critical events.
show email-parameters test (with the email parameter) set enclosure Description Sets an enclosure’s name, location, rack number, and rack position. Set these parameters to values that help you identify and locate the enclosure.
While troubleshooting a storage system problem, a service technician can use this command to temporarily disable fault isolation for a specific Expander Controller in a specific enclosure. NOTE: If fault isolation is disabled, be sure to re-enable it before placing the system back into service. Serious problems can result if fault isolation is disabled and a PHY failure occurs.
|expander-ingress-0|expander-ingress-1|egress|expander-egress-0|expanderegress-1| drawer0-egress|drawer1-egress|drawer2-egress |drawer0-ingress|drawer1-ingress|drawer2-ingress|drawer0-ingress-0|drawer0ingress-1| drawer0-ingress-2|drawer0-egress-0|drawer0-egress-1|drawer0egress-2|drawer1-ingress-0| drawer1-ingress-1|drawer1-ingress-2|drawer1egress-0|drawer1-egress-1|drawer1-egress-2| drawer2-ingress-0|drawer2ingress-1|drawer2-ingress-2|drawer2-egress-0|drawer2-egress-1| drawer2egress-2 [wwn enclosure-WWN] Pa
• • • • • • • • • • • • • • • • • • • • drawer1-ingress: Drawer 1 drawer ingress PHY drawer2-ingress: Drawer 2 ingress PHY drawer0-ingress-0: Drawer 0 ingress PHY 0 drawer0-ingress-1: Drawer 0 ingress PHY 1 drawer0-ingress-2: Drawer 0 ingress PHY 2 drawer0-egress-0: Drawer 0 egress PHY 0 drawer0-egress-1: Drawer 0 egress PHY 1 drawer0-egress-2: Drawer 0 egress PHY 2 drawer1-ingress-0: Drawer 1 ingress PHY 0 drawer1-ingress-1: Drawer 1 ingress PHY 1 drawer1-ingress-2: Drawer 1 ingress PHY 2 drawer1-egress-0
• • • The value is case sensitive. The value can have 8–32 characters. The value can include printable UTF-8 characters except: , < > \ (Any double-quote characters in the passphrase are automatically removed.
set fde-lock-key set fde-state show fde-state set fde-state Description Changes the overall state of the system for the use of Full Disk Encryption. The system can be secured, where each disk becomes secured and not accessible outside the system. Alternatively, the system can be repurposed, where each disk is secure erased. Minimum role manage Syntax set fde-state [noprompt] [repurpose] [secure passphrase value] Either the repurpose parameter or the secure parameter must be specified.
Optional. Changes the host’s nickname to the specified name. Input rules: • • • • The value is case sensitive. The value can have a maximum of 32 bytes. The value can include spaces and printable UTF-8 characters except: " , . < \ A value that includes a space must be enclosed in double quotes. [profile standard] Optional. Default profile. CAUTION: Changing this parameter can disrupt access from connected hosts. host-name The current name of the host.
Syntax To set FC port parameters: set host-parameters [controller a|b|both] [fibre-connection-mode loop|point-to-point|auto] [fibre-loop-id values] [noprompt] [ports ports|all] [prompt yes|no|expert] [speed 4g|8g|16g|auto] To set iSCSI port parameters: set host-parameters [controller a|b|both] [default-router address] [gateway address] [ip address] [iscsi-ip-version ipv4|ipv6] [netmask address] [noprompt] [ports ports|all] [prompt yes|no|expert] Parameters [controller a|b|both] Deprecated—use the ports p
[ip address] Optional. For iSCSI, the port IP address. Ensure that each iSCSI host port in the storage system is assigned a different IP address. This parameter requires the ports parameter. [iscsi-ip-version ipv4|ipv6] Optional. Specifies whether to use IP version 4 (IPv4) or 6 (IPv6) for addressing controller iSCSI ports.
show ports set host-port-mode Description Changes host-interface characteristics for host ports in a CNC controller module. For both controller modules, all ports can be set to FC, all ports can be set to iSCSI, or the first two ports in each controller module can be set to FC and the second two ports can be set to iSCSI. This command will immediately change the host port configuration, stop I/O, restart both controllers, and log event 236.
For SAS, the ID is a WWPN. For iSCSI, the ID is an IQN. A WWPN can include a colon between each byte but the colons will be discarded. [nickname name] Optional. Sets the name of the initiator to the specified name. Input rules: • • • • The value is case sensitive. The value can have a maximum of 32 bytes. The value can include spaces and printable UTF-8 characters except: " , . < \ A value that includes a space must be enclosed in double quotes. [profile standard] Optional.
[gateway gateway Optional. Specifies a gateway IP address for the port. The value must be a valid IPv6 address. The value cannot include a prefix or /prefixLength notation. The address cannot be used elsewhere in the network port configuration. All addresses share a single gateway. Examples For controller A, enable autoconfig and set the gateway address.
Optional. Specifies the IP address of an iSNS server. The default address is all zeroes. [jumbo-frame enabled|disabled|on|off] Optional. Enables or disables support for jumbo frames. Allowing for 100 bytes of overhead, a normal frame can contain a 1400-byte payload whereas a jumbo frame can contain a maximum 8900-byte payload for larger data transfers. Use of jumbo frames can succeed only if jumbo-frame support is enabled on all network components in the data path.
Specifies the enclosure to locate. This affects the identification LED on the enclosure and on each I/O module. Examples Identify disk 5 in enclosure 1. # set led disk 1.5 on Stop identifying enclosure 1. # set led enclosure 1 off Identify controller B in enclosure 1. # set led enclosure 1 controller b on set network-parameters Description Sets parameters for the network port in each controller module.
Parameters [controller a|b|both] Optional. For IP-related parameters, this specifies whether to change controller A, B, or both. If this parameter is omitted and both controllers are set to use DHCP or are set to use ping-broadcast, changes affect both controllers. Otherwise, if this parameter is omitted and the ip parameter, netmask parameter, or gateway parameter is set, changes affect the controller being accessed. [dhcp] Optional.
Optional. The network address of an available NTP server. The value can be an IPv4 address, IPv6 address, or FQDN. [timezone +|-hh[:mm]] Optional. The system’s time zone as an offset in hours (-12 through +14) and optionally minutes (00–59) from Coordinated Universal Time (UTC). To specify a positive offset, the '+' is optional. To specify a negative offset, the '-' is required. The hour value can have one or two digits and can omit a leading zero. If the minutes value is specified it must have two digits.
set peer-connection Description Modifies a peer connection between two systems. You can use this command to change the name of a current peer connection or to change the port address of the remote system without changing the peer connection configurations. For example, you could configure a peer connection and then move one of the peers to a different network. You can run this command on either the local system or the remote system.
# set peer-connection name PeerCon1 remote-username John remote-password John1234 Peer1 See also create peer-connection delete peer-connection query peer-connection show peer-connection set pool Description Sets parameters for a virtual pool. Each virtual pool has three thresholds for page allocation as a percentage of pool capacity. You can set the low and middle thresholds. The high threshold is automatically calculated based on the available capacity of the pool minus 200 GB of reserved space.
pool The name of the storage pool for which to change settings. Examples For pool A, set the low threshold to 30%. # set pool low-threshold 30% A For pool B, disable overcommit. # set pool overcommit off B See also delete pools show pools set prompt Description Sets the prompt for the current CLI session. This setting does not persist beyond the current session. Minimum role manage Syntax set prompt prompt Parameters prompt The new prompt.
[slp enabled|disabled|on|off] [smis enabled|disabled|on|off] [snmp enabled|disabled|on|off] [ssh enabled|disabled|on|off] [ssh-port port] [telnet enabled|disabled|on|off] [usmis enabled|disabled|on|off] Parameters [activity enabled|disabled|on|off] Optional. Enables or disables access to the activity progress interface via HTTP port 8081. This mechanism reports whether a firmware update or partner firmware update operation is active and shows the progress through each step of the operation.
Optional. Enables or disables the Service Location Protocol (SLP) interface. SLP is a discovery protocol that enables computers and other devices to find services in a LAN without prior configuration. This system uses SLP v2. This is enabled by default. SMI-S uses SLP to advertise WBEM interfaces. If SMI-S is enabled, disabling SLP will prevent WBEM interfaces from being advertised. [smis enabled|disabled|on|off] Optional.
You can run this command on either the primary or secondary system. Minimum role manage Syntax set replication-set [name new-name] [queue-policy discard|queue-latest] [snapshot-basename basename] [snapshot-count #] [snapshot-history disabled|off|secondary|both] [snapshot-retention-priority never-delete|high|medium|low] current-replication-set-ID Parameters [name new-name] Optional. Specifies a new name for the replication set. Input rules: • • • • The value is case sensitive.
If you change this parameter while a replication is running, for the current replication it will affect only the secondary system. In this case the value can only be increased, so you might have one less expected snapshot on the primary system than on the secondary system. [snapshot-history disabled|off|secondary|both] Optional. Specifies whether to maintain a replication snapshot history for the replication set, as described above. • • • disabled or off: A snapshot history will not be kept.
set schedule Description Changes parameters for a specified schedule. If you want to change the schedule name, create a new schedule to replace the existing one. You must specify at least one of the optional parameters for the command to succeed. You can schedule a replication task on the primary system only.
See also show schedules show tasks set snapshot-space Description Sets the snapshot space usage as a percentage of the pool and thresholds for notification. You can set the percent of the pool that can be used for snapshots (the snapshot space). NOTE: If the percentage of the pool used by snapshots is higher than the percentage specified in this command, the command will fail. You can specify a limit policy to enact when the snapshot space reaches the percentage.
Examples For pool A, limit the maximum amount of pool space that can be occupied by snapshot data to 15%, set the middle-threshold warning event to be logged when 85% of that space has filled, and set a policy to automatically delete snapshots (per deletion rules) when the 15% limit is reached. # set snapshot-space pool A limit 15% middle-threshold 85% limit-policy delete See also show snapshot-space show pools set snmp-parameters Description Sets SNMP parameters for event notification.
[write-community string] Optional. Sets a community string for write access. This string must differ from the read-community string. Input rules: • • • • The value is case sensitive. The value can have a maximum of 31 bytes. The value can include any characters characters except: " <> A value that includes a space must be enclosed in double quotes. The default is private. Examples Enable Critical events only, specify a trap host, and set the community string for read-only access.
• disabled or off – Disables the SupportAssist feature NOTE: If you specify this parameter, do not specify the maintenance-mode parameter. Examples Enable the SupportAssist feature. # set support-assist enable Temporarily suspend the SupportAssist service. # set support-assist state pause Put the system into maintenance mode.
GAB|GMB|GEO|DEU|GHA| GIB|GRC|GRL|GRD|GLP|GUM|GTM|GGY|GIN|GNB|GUY|HTI|HMD|HND|HKG|HUN|ISL|IND| IDN|IRQ|IRL|IRN|IMN| ISR|ITA|JAM|JPN|JEY|JOR|KAZ|KEN|KIR|KWT|KGZ|LAO|LVA|LBN|LSO|LBR|LBY|LIE| LTU|LUX|MAC|MDG|MWI| MYS|MDV|MLI|MLT|MHL|MTQ|MRT|MUS|MYT|MEX|MCO|MNG|MNE|MSR|MAR|MOZ|MMR|NAM| NRU|NPL|NLD|ANT|NCL| NZL|NIC|NER|NGA|NIU|NFK|MNP|NOR|OMN|PAK|PLW|PAN|PNG|PRY|PER|PHL|PCN|BOL| POL|PRT|PRI|QAT|KOR| MDA|REU|ROU|RUS|RWA|BLM|SHN|KNA|LCA|MAF|SPM|VCT|WSM|SMR|STP|SAU|SEN|SRB| SCG|SYC|SLE|SGP|SXM| SVK|SVN|SLB|SOM|ZAF|S
[host IP-or-name] [password proxy-password] [port port] {protocol HTTP] [user proxy-user] [enabled|disabled|on|off] Parameters At minimum the host and port parameters must be specified when you enable this feature the first time. [host IP-or-name] Optional. Specifies the IPv4 address or name of a proxy host. [port port] Optional. Specifies the port number to use on the proxy host. protocol HTTP Optional. Specifies the communication protocol. Only HTTP is supported. [user proxy-user] Optional.
Optional. The network address for the host. The value can be an IPv4 address, IPv6 address, or FQDN. If notification-level is other than none, the host parameter must be specified. [host-ip address] Deprecated—use the host parameter instead. [host-port port-number] Optional. A specific port number on the host. notification-level crit|error|warn|resolved|info|none The minimum severity for which the system should send notifications: • • • • • • crit: Sends notifications for Critical events only.
Optional. A name to identify the system. The default is Uninitialized Name. Examples Set the system name to Test and the contact to J. Doe. # set system name Test contact "J. Doe" See also show system set task Description Changes parameters for a TakeSnapshot or VolumeCopy task. For these types of tasks, you can change parameters other than name, type, or associated volumes. If you change the parameters for a running task, the changes will take effect the next time the task runs.
See also create task delete task set schedule show schedules show tasks set user Description Changes user preferences for the session or permanently. The system requires at least one CLI user with the manage role to exist. A user with the manage role can change any parameter except name. A user with the monitor role can change any parameter for that user except name, roles, and interfaces. NOTE: User changes take effect the next time that the user logs in.
Optional. Sets the base for entry and display of storage-space sizes: • • 2: Sizes are shown as powers of 2, using 1024 as a divisor for each magnitude. In base 2 when you set a size, whether you specify a base-2 or base-10 size unit, the resulting size will be in base 2. 10: Sizes are shown as powers of 10, using 1000 as a divisor for each magnitude. This is the default. In base 10 when you set a size, the resulting size will be in the specified unit. This option is the default.
• • manage: User can view and change system settings. diagnostic: User can view and change system settings. Multiple values must be separated with a comma (with no spaces). If multiple values are specified, the user’s access to commands will be determined by the highest role specified. [session-preferences] Optional. Specifies that the current CLI settings will become permanent settings for the user. This parameter cannot be combined with any other parameter. [storage-size-base 2|10] Optional.
See also set password show users set vdisk Description Changes parameters for a specified linear disk group. This command applies to linear storage only. Minimum role manage Syntax set vdisk [adapt-spare-capacity size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]|default] [name new-name] [owner a|b] [spin-down-delay delay] vdisk Parameters [adapt-spare-capacity size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]|default] Optional. For an ADAPT disk group, this specifies the target spare capacity.
See also show vdisks on page 252 set volume Description Changes parameters for a volume. CAUTION: Applying new parameters may disrupt access from connected hosts. For virtual storage, you can set the retention priority for snapshots of the volume. If automatic deletion of snapshots is enabled, snapshots will be considered for automatic deletion first by priority and then by date, so the oldest low-priority snapshot will be deleted first.
• • medium: Snapshots may be deleted after all eligible low-priority snapshots have been deleted. This is the default. low: Snapshots may be deleted. [tier-affinity no-affinity|archive|performance] Optional. For virtual storage, this specifies how to tune the tier-migration algorithm for the volume. The tier-affinity setting affects all members of a snapshot tree.
• • standard: This controller cache mode of operation is optimized for sequential and random I/O and is the optimization of choice for most workloads. In this mode, the cache is kept coherent with the partner controller. This mode gives you high performance and high redundancy. This is the default. no-mirror: In this mode of operation, the controller cache performs the same as the standard mode with the exception that the cache metadata is not mirrored to the partner.
NOTE: You cannot rename a volume group that is in a replication set. Minimum role manage Syntax set volume-group name new-name volume-group Parameters name new-name A new name for the volume group. Input rules: • • • • The value is case sensitive. The value can have a maximum of 32 bytes. The value can include spaces and printable UTF-8 characters except: " , .< \ A value that includes a space must be enclosed in double quotes. volume-group The current name of the volume group.
Priority at which data-redundancy utilities, such as disk-group verify and reconstruct, run with respect to I/O operations competing for the system's processors. (This does not affect disk-group background scrub, which always runs at “background” priority.) • • • High: Utilities have higher priority than host I/O. Use when your highest priority is to return the system to a fully fault-tolerant state. This can cause heavy I/O to be slower than normal.
Shows whether the cache policy will change from write-back to write-through when a controller fails. • • Disabled : The controller failure trigger is disabled. Enabled:The controller failure trigger is enabled. Supercap Failure Shows whether the cache policy will change from write-back to write-through when the supercapacitor that provides backup power for cache is not fully charged or fails. • • Disabled:The supercapacitor failure trigger is disabled.
• Enabled: Background disk scrub is enabled. Managed Logs Shows whether the managed logs feature is enabled, which allows log files to be transferred from the storage system to a log collection system to avoid losing diagnostic data as logs fill. • • Disabled: The managed logs feature is disabled. Enabled: The managed logs feature is enabled.
Output System cache parameters: Operation Mode Shows the system’s operating mode, also called the cache redundancy mode: • • • • • Independent Cache Performance Mode: For a dual-controller system, controller failover is disabled and data in a controller’s write-back cache is not mirrored to the partner controller. This improves write performance at the risk of losing unwritten data if a controller failure occurs while there is data in controller cache.
If a volume is specified, its cache optimization mode: • • standard: This controller cache mode of operation is optimized for sequential and random I/O and is the optimization of choice for most workloads. In this mode, the cache is kept coherent with the partner controller. This mode gives you high performance and high redundancy. no-mirror: In this mode of operation, the controller cache performs the same as the standard mode with the exception that the cache metadata is not mirrored to the partner.
The date and time in the format year-month-day hour:minutes:seconds when the certificate was created. Examples Show certificate status for the system. # show certificate Basetypes certificate-status status See also create certificate show chap-records Description Shows CHAP records for iSCSI originators. This command is permitted whether or not CHAP is enabled Minimum role monitor Syntax show chap-records [name originator-name] [show-secrets] Parameters [name originator-name] Optional.
show cli-parameters Description Shows the current CLI session preferences. Minimum role monitor Syntax show cli-parameters Output Timeout The time in seconds that the session can be idle before it automatically ends. Valid values are 120-43200 seconds (2-720 minutes). Output Format • • • • • • console: Supports interactive use of the CLI by displaying command output in easily readable format. This format automatically sizes fields according to content and adjusts content to window resizes.
Management Mode The management mode used in the current CLI session. • • Linear: Uses linear-storage terminology in command output and system messages. For example, vdiskfor disk groups and pools. Virtual: Uses terminology in command output and system messages that is generalized for managing virtual and linear storage. For example, disk group for disk groups and pool for pools. To see the default management mode, use the show protocols command. Examples Show current CLI settings.
Output • • • • • • • • • • • Examples Show information about the system configuration.
show controllers Description Shows information about each controller module. Minimum role monitor Syntax show controllers Output Controller module ID: A or B. Serial Number • • Serial number. Not Available: The controller module is down or not installed. Hardware Version Hardware version. CPLD Version Complex Programmable Logic Device firmware version. MAC Address Network port MAC address. WWNN Storage system World Wide Node Name (WWNN). IP Address Network port IP address.
• Not Installed Failed Over to This Controller Indicates whether the partner controller has failed over to this controller: • • No: The partner controller has not failed over to this controller. Yes: The partner controller has either failed or been shut down, and its responsibilities have been taken over by this controller.
• Down: Both controllers are not operational. Controller Redundancy Status • • • • • Examples Redundant with independent cache: Both controllers are operational but are not mirroring their cache metadata to each other. Redundant: Both controllers are operational. Operational but not redundant: In active-active mode, one controller is operational and the other is offline. In single-controller mode, the controller is operational. Down: This controller is not operational.
Data Written The amount of data written since these statistics were last reset or since the controller was restarted. Num Forwarded Cmds The current count of commands that are being forwarded or are queued to be forwarded to the partner controller for processing. This value will be zero if no commands are being forwarded or are queued to be forwarded.
Optional. Specifies the name or serial number of the pool that contains the disk groups for which to show information. If this parameter is omitted, information is shown for disk groups in all pools. [disk-groups] Optional. A comma-separated list of the names or serial numbers of the disk groups for which to show information. A name that includes a space must be enclosed in double quotes. If this parameter is omitted, information is shown for all disk groups.
• • • • • • • • • RBAL: The ADAPT disk group is being rebalanced. RCON: At least one disk in the disk group is being reconstructed. VDRAIN: The virtual disk group is being removed and its data is being drained to another disk group. VPREP: The virtual disk group is being prepared for use in a virtual pool. VRECV: The virtual disk group is being recovered to restore its membership in the virtual pool. VREMV: The disk group and its data are being removed. VRFY: The disk group is being verified.
• • 512e: All disks use 512-byte emulated sector size. Each logical block is 512 bytes and each physical block is 4096 bytes. Eight logical blocks will be stored sequentially in each physical block. Logical blocks may or may not be aligned with physical block boundaries. Mixed: The disk group contains a mix of 512n and 512e disks. This is supported, but for consistent and predictable performance, do not mix disks of different sector size types (512n, 512e). Sector Format Shown by the detail parameter.
show disk-group-statistics Description Shows live performance statistics for disk groups. The command will show information for all disk groups by default, or you can use parameters to filter the output. For disk-group performance statistics, the system samples live data every 30 seconds. Properties shown only in API format are described in API basetype properties.
Shown for a virtual disk group. The rate, in pages per minute, at which pages are allocated to volumes in the disk group because they need more space to store data. Pages Deallocated per Min Shown for a virtual disk group. The rate, in pages per minute, at which pages are deallocated from volumes in the disk group because they no longer need the space to store data. Pages Reclaimed Shown for a virtual disk group.
Total time in seconds before an I/O operation is failed regardless of the Attempt Timeout and Timeout Retry Maximum settings. This value cannot be changed. Inactive Drive Spin Down Shows whether spinning disks that are available or are global spares will spin down after a period of inactivity shown by the Inactive Drive Spin Down Delay field. • • Disabled: Drive spin down for available disks and global spares is disabled. Enabled: Drive spin down for available disks and global spares is enabled.
Optional. For all or specified disks, this parameter shows performance statistics from the latest historical sample for each disk. Statistics shown include total I/Os (reads and writes), total amount of data transferred, and average I/O response time. temp Optional. Shows the temperature for all installed disks. vdisk vdisks Optional. A comma-separated list of the IDs or serial numbers of linear disk groups for which to show disk information. A name that includes a space must be enclosed in double quotes.
Shown by the detail or fde parameter. The FDE state of the disk: • • • • • • Unknown: The FDE state is unknown. Not FDE Capable: The disk is not FDE-capable. Not Secured: The disk is not secured. Secured, Unlocked: The system is secured and the disk is unlocked. Secured, Locked: The system is secured and the disk is locked to data access, preventing its use. FDE Protocol Failure: A temporary state that can occur while the system is securing the disk.
Shown by the encl parameter. The model number of the disk. Pool Shown by default. The name of the pool that contains the disk. Pool Name Shown by the detail parameter. See Pool, above. Power On Hours Shown by the detail parameter. The total number of hours that the disk has been powered on since it was manufactured. This value is stored in disk metadata and is updated in 30-minute increments. Recon State Shown by the detail parameter.
Shown by default, detail, fde, or perf parameter. The speed of a spinning disk, in thousands of revolutions per minute, as specified by the disk vendor. For an SSD, 0 is shown. SSD Life Remaining% Shown by the detail parameter. • • 100%–0%: For an SSD, this field shows the percentage of disk life remaining. This value is polled every 5 minutes. When the value decreases to 20%, event 502 is logged with Informational severity.
Shown by default or by the detail parameter. • • • • • • • AVAIL: Available. DEDICATED SP: The disk is a spare assigned to a linear disk group. FAILED: The disk is unusable and must be replaced. Reasons for this status include: excessive media errors, SMART error, disk hardware failure, or unsupported disk. GLOBAL SP: The disk is a global spare. LEFTOVR: The disk is a leftover. LINEAR POOL: The disk is a member of a linear disk group. UNUSABLE: The disk cannot be used in a disk group.
The historical option allows you to specify a time range or a number (count) of data samples to include. It is not recommended to specify both the time-range and count parameters. If both parameters are specified, and more samples exist for the specified time range, the samples' values will be aggregated to show the required number of samples. Statistics shown only in API output are described in API basetype properties.
Serial Number The serial number of the disk. Pwr Hrs The total number of hours that the disk has been powered on since it was manufactured. This value is stored in disk metadata and is updated in 30-minute increments. Bps The data transfer rate, in bytes per second, calculated over the interval since these statistics were last requested or reset. This value will be zero if it has not been requested or reset since a controller restart.
BAsgn port# The number of times blocks were reassigned to alternate locations. BBlk port# The number of bad blocks encountered. Historical Durable ID The disk ID in the format disk_enclosure-number.disk-number. Serial Number The serial number of the disk. Total I/Os The total number of read and write operations since the last sampling time. Reads Shown by the all parameter. The number of read operations since the last sampling time. Writes Shown by the all parameter.
Shown by the all parameter. The average response time, in microseconds, for write operations since the last sampling time. Average I/O Size Shown by the all parameter. The average data size of read and write operations since the last sampling time. Average Read I/O Size Shown by the all parameter. The average data size of read operations since the last sampling time. Average Write I/O Size Shown by the all parameter. The average data size of write operations since the last sampling time.
DNS management-hostname The management host name of the controller. Domain Name (DNS) The FQDN of the controller or '-'. Examples Show the management host name for each controller module. # show dns-management-hostname Basetypes mgmt-hostnames status See also clear dns-parameters set dns-managment-hostname reset dns-management-hostname set dns-parameters show dns-parameters on page 189 show dns-parameters Description Shows configured DNS settings for each controller module.
Output Email Notification • • Disabled: Email notification is disabled. Enabled: Email notification is enabled. Email Notification Filter Shows the minimum severity for which the system should send notifications: • • • • • • crit: Sends notifications for Critical events only. error: Sends notifications for Error and Critical events. warn: Sends notifications for Warning, Error, and Critical events. resolved: Sends notifications for Resolved, Warning, Error, and Critical events.
show enclosures Description Shows information about the enclosures in the storage system. Full detail available in API output only. If a connected expansion enclosure is not supported, it will not be listed and events 315 and 443 will be logged. Minimum role monitor Syntax show enclosures Parameters Encl The enclosure ID. Encl WWN The enclosure WWN. Name The enclosure name. Location The enclosure location, or blank if not set. Rack The number of the rack that contains the enclosure.
The number of the drawer. Name The name of the drawer. Status Status of the drawer • • • • • • Up Warning Error Unknown Unavailable Not Present Health • • • • • OK Degraded Fault N/A Unknown Reason If Health is not OK, this field shows the reason for the health state. Action If Health is not OK, this field shows recommended actions to take to resolve the health issue. Examples Show information about all enclosures in the system.
[to-event event-ID] Parameters a|b|both|error Optional. Specifies to filter the event listing: • • • • a: Shows events from controller A only. Do not use this parameter with the from-event parameter or the to-event parameter. b: Shows events from controller B only. Do not use this parameter with the from-event parameter or the to-event parameter. both: Shows events from both controllers. Do not use this parameter with the from-event parameter or the to-event parameter.
• Examples ○ INFORMATIONAL: A configuration or state change occurred, or a problem occurred that the system corrected. No action is required. ○ RESOLVED: A condition that caused an event to be logged has been resolved. Event-specific message giving details about the event. Show the last two events. # show events last 2 Show the last three non-Informational events. # show events last 3 error Show all events from April 30 2014 at 11:59:00 p.m. through May 2 2014 at 11:59:00 a.m.
• • • • • • • • • • • • • • • • • • • • • • • Drawer0-Egress: Drawer 0 egress PHY Drawer0-Ingress-0: Drawer 0 ingress PHY 0 Drawer1-Egress: Drawer 1 egress PHY Drawer1-Ingress: Drawer 1 drawer ingress PHY Drawer2-Egress: Drawer 2 egress PHY Drawer2-Ingress: Drawer 2 ingress PHY Drive: Drive slot PHY Egress: Expansion port egress PHY Expander-Egress-0: Expansion port 0 egress PHY Expander-Egress-1: Expansion port 1 egress PHY Expander-Ingress-0: Expansion port 0 ingress PHY Expander-Ingress-1: Expansion por
• • • • Examples Drive removed: PHY disabled because drive slot is empty. Unused - disabled by default: PHY is disabled by default because it is not used. Excessive Phy changes: PHY is disabled because of excessive PHY change counts. Did not initialize Show expander status for each enclosure.
show power-supplies show fans Description Shows information about each fan in the storage system. To see information about the fan modules that contain each pair of fans, use the show fan-modules command. Minimum role monitor Syntax show fans Output Name The fan name. Location The fan location in the format Enclosure enclosure-ID- position. The position is as viewed from the back of the enclosure. Status • • • • Up Error Off Missing Speed The fan speed (revolutions per minute).
Examples Show about all fans in the system. # show fans Basetypes fan status See also show power-supplies show fde-state Description Shows Full Disk Encryption information for the storage system. NOTE: If you insert an FDE disk into a secured system and the disk does not come up in the expected state, perform a manual rescan by using the rescan command. Minimum role monitor Syntax show fde-state Output FDE Security Status • • • • Unsecured. The system has not been secured with a passphrase.
• • Typically, fenced data occurs when a disk in a non-fault-tolerant disk group detects an unrecoverable media error. Fenced data can also occur if multiple unrecoverable blocks are detected which exceed the capacity of the RAID error-recovery algorithms. Unrecoverable data blocks are “fenced” by marking them unreadable by the storage system. A data block remains fenced until the host writes the block, at which time it is again accessible. For NRAID and RAID 0, fenced data is not tracked.
# show fenced-data all Basetypes fenced-data status See also show disk-groups show events show vdisks show volumes show frus Description Shows FRU (field-replaceable unit) information for the storage system. Some information is for use by service technicians. Minimum role monitor Syntax show frus Output Enclosure ID The enclosure ID.
The JEDEC ID (global manufacturing code) of the manufacturer. FRU Location The location of the FRU in the enclosure. Configuration SN The configuration serial number. FRU Status • • • • • Absent: The FRU is not present. Fault: The FRU’s health is Degraded or Fault. Invalid Data: The FRU ID data is invalid. The FRU’s EEPROM is improperly programmed. OK: The FRU is operating normally. Power OFF: The FRU is powered off. Original SN For a power supply module, the original manufacturer serial number.
Number of Members The number of hosts in the host group. Host information: Name The host name. Number of Members The number of initiators in the host. Initiator information: Nickname The nickname of the initiator. Discovered • • Yes: The initiator was discovered and its entry was automatically created. No: The initiator was manually created Mapped Shows whether the initiator is explicitly mapped to any volumes: • • Yes: At least one volume is explicitly mapped to the initiator.
Syntax show host-phy-statistics Output Ports The controller ID and port number of the SAS host ports for which PHY statistics are displayed. Phy Identifies a PHY’s logical location within a group based on the PHY type. Logical IDs are 0–3 for host port PHYs. Each SAS host will have multiple PHYs. Disparity The number of doublewords containing running disparity errors that have been received by the PHY, not including those received during Link Reset sequences.
Reads The number of read operations since these statistics were last reset or since the controller was restarted. Writes The number of write operations since these statistics were last reset or since the controller was restarted. Data Read The amount of data read since these statistics were last reset or since the controller was restarted. Data Written The amount of data written since these statistics were last reset or since the controller was restarted.
[initiators] Parameters hosts hosts Optional. A comma-separated list of the names of hosts containing initiators for which to show information. If this parameter is omitted, information is shown for all initiators. initiators Optional. A comma-separated list of the names of initiators for which to show information. If this parameter is omitted, information is shown for all initiators. Output Nickname The name of the initiator.
• • Examples Media Access Control (MAC) address Network port Show inquiry data for controller modules in the system. # show inquiry Basetypes inquiry status See also show versions show ipv6-addresses Description Shows static IPv6 addresses assigned to each controller's network port. Minimum role monitor Syntax show ipv6-addresses [controller a|b|both] Parameters controller a|b|both Optional. Specifies whether to show addresses for controller A, controller B, or both.
Output Autoconfig • • enabled: Uses an IPv6 address computed by SLAAC or assigned by a DHCPv6 server, depending on the network configuration. If a DHCPv6 address is available, then that address is used. Otherwise SLAAC is used. disabled: Uses static IPv6 addresses set with the add ipv6-address command. Gateway The network port gateway IPv6 address. Link-Local Address The link-local IPv6 address. Autoconfig IP The automatically configured IPv6 address. IPv6 Address (1-4) Shown if Autoconfig is disabled.
The iSCSI host port link speed. • • auto: The proper speed is auto-negotiated. 1Gbps: The speed is forced to 1 Gbit/s, overriding a downshift that can occur during auto-negotiation with 1-Gbit/s HBAs. This setting does not apply to 10-Gbit/s HBAs. iSCSI IP Version • • Examples 4: iSCSI host port addresses use IPv4 format. 6: iSCSI host port addresses use IPv6 format. Show system-wide parameters for iSCSI ports.
You can specify: • • • A host by name in the format host-name.*, where * represents all initiators in the host. Example: FCServer.* A host group by name in the format host-group.*.*, where the first * represents all hosts in the group and the second * represents all initiators in those hosts. Example: TestLab.*.* A volume group by name in the format volume-group.*, where * represents all volumes in the group. Example:TestVolumes.* Do not include both host-type and volume-type items in a list.
Standard: Default profile. Serial Number The serial number of the volume group or volume. Volume • • Examples For a volume, its name. For a volume group, its name in the format volume-group.*, where the * represents all volumes in the group. Show mappings for all volumes. # show maps Show mapping information for all initiators. # show maps initiator Show mappings for volume group VGroup1 and ungrouped volume v1. # show maps VGroup1.
• DHCP: DHCP is used to set network parameters. Link Speed • • • • Unknown: For a system operating in Single Controller mode, this controller module is not present. 10mbps: The network port link speed is set to 10 Mb/s. 100mbps: The network port link speed is set to 100 Mb/s. 1000mbps: The network port link speed is set to 1000 Mb/s. Duplex Mode • • • Undefined: For a system operating in Single Controller mode, this controller module is not present.
• 0.0.0.0 if the NTP server IP address has not been set. Last Server Contact The date and time in the format year-month-day hour:minutes:seconds of the last message received from the NTP server, or none. Examples Show NTP status for the system. # show ntp-status Basetypes ntp-status status See also set controller-date show peer-connections Description Shows information about a peer connection between two systems. You can run this command on either the local or remote system.
Port Address The assigned port address. Remote Port The IDs of ports in the remote system. Reachable Remote Links Shown by the verify-links parameter. The IDs of linked ports in the remote system. Reachable Local Links Shown by the verify-links parameter. The IDs of linked ports in the local system Examples Show information for all peer connections. # show peer-connections Show information for peer connection Peer1.
Class • • Linear: Linear pool. Virtual: Virtual pool. Total Size The total capacity of the pool. Avail The available capacity in the pool. Snap Size The pool capacity used by linear snap pools or virtual snapshots OverCommit • • Enabled: The allocated size of the volumes can exceed the physical capacity of the pool. Disabled: The allocated size of the volumes cannot exceed the physical capacity of the pool. Disk Groups The number of disk groups in the pool. Volumes The number of volumes in the pool.
Examples Show information about all pools. # show pools Show information about virtual pools. # show pools type virtual Basetypes pools disk-groups tiers See also delete pools set pool show pool-statistics show pool-statistics Description Shows live or historical performance statistics for virtual pools. For pool performance statistics, the system samples live data every 30 seconds and historical data every 5 minutes, and retains historical data for 6 months.
Optional. Specifies to save historical statistics, in CSV format, to a file on the controller. To access the file, use SFTP or FTP. historical Optional. Specifies to show historical statistics. If this parameter is omitted, live statistics will be shown. pools pool Optional. Specifies the name or serial number of the virtual pool for which to show information. If this parameter is omitted, information will be shown for both pools A and B. A name that includes a space must be enclosed in double quotes.
IOPS The number of input/output operations per second, calculated over the interval since these statistics were last requested or reset. This value will be zero if it has not been requested or reset since a controller restart. I/O Resp Time The average response time, in microseconds, for read and write operations since the last sampling time. Read Resp Time Shown by the all parameter. The average response time, in microseconds, for read operations since the last sampling time.
The number of 4 MB pages allocated to volumes in the pool. Sample Time Date and time, in the format year-month-day hour:minutes:seconds, when the data sample was taken. For each tier in the pool: Pool The name of the pool. Tier The name of the tier. Total I/Os, Reads, Writes, Data Transferred, Data Read, Data Written, Total IOPS, Read IOPS, Write IOPS, Total B/s, Read B/s, Write B/s As described for a pool, above. Allocated Pages The number of 4 MB pages allocated to volumes in the tier.
pool-summary (historical) pool-hist-statistics (historical) tier-summary (historical) tier-hist-statistics (historical) readcache-hist-statistics (historical) status See also reset all-statistics reset pool-statistics show pools show ports Description Shows information about host ports in each controller. Minimum role monitor Syntax show ports [detail] Parmeters detail Optional. This parameter shows additional detail about the port status, including SFP information.
• • • • • OK Degraded Fault N/A Unknown Reason If Health is not OK, this field shows the reason for the health state. Action If Health is not OK, this field shows recommended actions to take to resolve the health issue. Topo (C) FC and SAS only. Configured topology. Lanes Expected SAS only. If the detail parameter is specified, this field shows the expected number of PHY lanes in the SAS port. Active Lanes SAS only.
• Incorrect protocol: The SFP protocol does not match the port protocol. When this condition is detected, event 464 is logged. Part Number If the detail parameter is specified, this field shows the SFP part number. Supported Speeds FC only. If the detail parameter is specified, this field shows the link speeds that the SFP supports. 10G Compliance iSCSI only. If the detail parameter is specified, this field shows the SFP's 10G compliance code.
• • (blank): Not applicable. The firmware revision of the power supply. Health • • • • • OK Degraded Fault N/A Unknown Reason If Health is not OK, this field shows the reason for the health state. Action If Health is not OK, this field shows recommended actions to take to resolve the health issue. Examples Show information about each power supply in each enclosure.
Shows whether the unsecure secondary interface for installing firmware updates, installing security certificates and keys and downloading logs is enabled or disabled. SSH File Transfer Protocol (SFTP) Shows whether the secure secondary interface for installing firmware updates, installing security certificates and keys and downloading logs is enabled or disabled. Simple Network Management Protocol (SNMP) Shows whether the SNMP interface is enabled or disabled.
• • You know of a disk-related issue (perhaps from the event log) and want to understand what components it may be impacting. You can use this command to see which volume WWNs are affected, which you can use on the host to determine which device node might be seeing errors. You know of a volume-level issue and want to determine which associated components to investigate. You can use this command to quickly see which controller owns the volume and which disks are associated with the volume.
Pool (v3) Pool name. Vdisk (v2) Disk group name. Health • • • • • OK Degraded Fault N/A Unknown Mapped Indicates whether the volume is mapped. This is useful when the no-mapping parameter is specified to hide detailed mapping information. • • Yes: The volume is mapped. No: The volume is not mapped. Mapping information: Ports • • Controller host ports that the mapping applies to. Blank if not mapped or mapped as no-access. . LUN • • LUN that identifies the volume to a host.
See also show disk-groups show disks show maps show pools show vdisks show redundancy-mode Description Shows the redundancy status of the system. Minimum role monitor Syntax show redundancy-mode Output Controller Redundancy Mode Shows the system’s operating mode, also called the cache redundancy mode: • • • • • Independent Cache Performance Mode: For a dual-controller system, controller failover is disabled and data in a controller’s write-back cache is not mirrored to the partner controller.
# show redundancy-mode Basetypes redundancy status show refresh-counters (Deprecated) Description In XML API format only, shows when the data represented by the basetype was last updated. The value 0 means the data has never been updated and is not cached. A value other than 0 is a timestamp indicating that the data has been updated. If the value has changed since the last time you called this command then the data has changed.
IP Address Controller B The IP address of the network port in controller B in the remote system. Username The name of a user with the manage role in the remote system. Status • • • • Uninitialized: This system hasn’t communicated with the remote system. Ready: This system has contacted the remote system and it is ready to use. Connected: This system is transferring data to the remote system. Not Connected: The system is not connected to the remote system.
• • Yes: The replication set is part of a group. No: The replication set is not part of a group. Primary Location The location of the primary volume in the replication set: Local or Remote. Peer The name of the peer connection. Primary Volume The primary volume name. If it is a volume group, it uses the .* notation. Secondary Volume The secondary volume name. If it is a volume group, it uses the .* notation Policy The action to take when a replication is running and a new replication is requested.
For the current run, the date and time when the replication is estimated to end. Run Error A message that says whether the replication succeeded or an error occurred. Examples Show information about all replication sets. # show replication-sets Show information about replication set RS1.
Basename The user-defined prefix for the snapshots. Retention Priority The retention priority for snapshots, which is used when automatic deletion of snapshots is enabled by using the set snapshot-space command. In a snapshot tree, only leaf snapshots can be deleted automatically. Deletion based on retention priority is unrelated to deleting the oldest snapshots to maintain a snapshot count. • • • • never-delete: Snapshots will never be deleted automatically to make space.
• • In Port: Ingress port in an expansion module. Can be connected to an egress (expansion) port in a controller module or an expansion module. Universal Port: Port that can function as either an egress or ingress port in a controller module or an expansion module. Status • • • • • Up: The port is cabled and has an I/O link. Warning: Not all of the port's PHYs are up. Error: The port is reporting an error condition. Not Present: The controller module is not installed or is down.
Schedule Specification Shown by the detail parameter. The schedule settings for running the associated task. Status • • • • • • Uninitialized: The task is not yet ready to run. Ready: The task is ready to run at the next scheduled time. Suspended: The task had an error and is holding in its current state. Expired: The task exceeded a constraint and will not run again. Invalid: The task is invalid. Deleted: The task has been deleted.
Value • • For a sensor, its value. For Overall Unit Status, one of the status values below. Status • • • • • • • • Examples OK: The sensor is present and detects no error condition. Warning: The sensor detected a non-critical error condition. Temperature, voltage, or current is between the warning and critical thresholds. Critical: The sensor detected a critical error condition. Temperature, voltage, or current exceeds the critical threshold.
The name of the user for which session information is shown. Interface Shows whether the session is using the CLI or the PowerVault Manager. Locale The display language. Host For a CLI session, the connected system's IP address and port number. State Shown by the detail parameter. Shows whether the session is active or expired. Timeout Shown by the detail parameter. The time in seconds that the session can be idle before it automatically ends. Idle Time The time in seconds that the session has been idle.
Examples Show the shutdown status of each controller. # show shutdown-status Basetypes show-other-MC-status shutdown-status status See also restart mc restart sc shutdown show snapshot-space Description Shows snapshot-space settings for each virtual pool. This includes space used by replication snapshots. Minimum role monitor Syntax show snapshot-space Output Pool The pool for which information is displayed (A or B).
See also set snapshot-space set snapshot-space show snapshots Description Shows information about snapshots. The command will show information for all snapshots by default, or you can use parameters to filter the output. Minimum role monitor Syntax show snapshots [pattern string] [pool pool] [type standard|replication|all] [volume volume] Parameters pattern string Optional. Shows snapshots whose names contain the specified string.
Status-Reason Shows N/A for Available status, or one of the following reasons for Unavailable status: • • • • • • snapshot not found master volume not found snapshot pending (not yet committed) master volume not accessible Volume copy with modified data is in progress Unknown reason Parent Volume The name of the volume of which the snapshot was taken. Base Vol The root of the snapshot tree, if any. A snapshot tree is a series of inter-related snapshots of a volume and can be 254 levels deep.
show snmp-parameters Description Shows SNMP settings for event notification. Minimum role monitor Syntax show snmp-parameters Output SNMP Trap Notification Level • • • • • • crit: Sends notifications for Critical events only. error: Sends notifications for Error and Critical events. warn: Sends notifications for Warning, Error, and Critical events. resolved: Sends notifications for Resolved, Warning, Error, and Critical events. info: Sends notifications for all events.
maintenance mode manually to notify SupportAssist not to create support tickets during planned system downtime. Specifies the status and date/time of the last transmission of system log data to the SupportAssist server. Last Logs Send Status Last Logs Send Time Specifies the status and date/time of the last transmission of system event data to the SupportAssist server. Last Event Send Status Last Event Send Time Proxy information: Proxy State • • Enabled – Use of a proxy for HTTP communication is enabled.
Shows the minimum severity for which the system sends notifications: • • • • • • crit: Sends notifications for Critical events only. error: Sends notifications for Error and Critical events. warn: Sends notifications for Warning, Error, and Critical events. resolved: Sends notifications for Resolved, Warning, Error, and Critical events. info: Sends notifications for all events. none: Disables syslog notification and clears the settings.
SCSI Product ID Shown by the detail parameter. The product identifier returned by the SCSI INQUIRY command. Enclosure Count The number of enclosures in the system. Health • • • • • OK Degraded Fault N/A Unknown Reason If Health is not OK, this field shows the reason for the health state. Other MC Status The operational status of the Management Controller in the partner controller. This is not factored into system health.
Shows whether host profiles are enabled. Number of Host Ports The number of host-interface ports in the controller enclosure. Maximum Disks The number of disks that the system supports. Maximum Volumes The number of volumes that the system supports. Maximum Linear Disk Groups (v3) The number of linear disk groups that the system supports. Maximum Linear Vdisks (v2) The number of disk groups that the system supports. Maximum LUNs The number of LUNs that the system supports.
See also show system show tasks Description Shows information about tasks. Minimum role monitor Syntax show tasks [detail] [task-name] detail Optional. Shows additional detail about each task. task-name Optional. Shows information about the specified task only. If this parameter is omitted, information is shown for all tasks. Output Any task type, no detail Name The name of the task. Type The task type. Status The task status. Status values for each task type are listed in the following sections.
• • • • • • VerifySnap InspectRetention FindOldestSnap UnmapSnap ResetSnap RenameSnap Error Message • • If an error occurred while processing the task, the error message. Blank if no error has occurred. Source Volume The name of the source volume. Source Volume Serial The serial number of the source volume. Prefix The label that identifies snapshots created by this task. Retention Count The number of snapshots to retain with this prefix.
• • If an error occurred while processing the task, the error message. Blank if no error has occurred. Snapshot Name The name of the snapshot to reset. Snapshot Serial Number The serial number of the snapshot to reset. VolumeCopy task, detail Task Name The name of the task. Task Type VolumeCopy Status • • • • • Uninitialized: The task is not yet ready to run. Ready: The task is ready to run. Active: The task is running. Error: The task has an error.
Replicate task, detail Task Name The name of the task. Task Type Replicate Status • • • • • Uninitialized: The task is not yet ready to run. Ready: The task is ready to run. Active: The task is running. Error: The task has an error. Deleted: The task is expired but this state is not yet synchronized to the partner controller. Task State The current step of the task: • • • Idle Replicate VerifyRunning Error Message • • If an error occurred while processing the task, the error message.
• Deleted: The task is expired but this state is not yet synchronized to the partner controller. Task State The current step of the task, which is always Start. Error Message • • Examples If an error occurred while processing the task, the error message. Blank if no error has occurred. Show information about all tasks. # show tasks Show information about task Task1.
Affinity Size The total size of volumes configured to have affinity for that tier. Examples Show information about all tiers. # show tiers tier all Show information about the Standard tier. # show tiers tier standard Basetypes tiers status See also show tier-statistics show tier-statistics Description Shows live performance statistics for tiers. The command will show information for all tiers by default, or you can use parameters to filter the output.
The amount of time, in seconds, since these statistics were last reset, either by a user or by a controller restart. Reads The number of read operations since these statistics were last reset or since the controller was restarted. Writes The number of write operations since these statistics were last reset or since the controller was restarted. Data Read The amount of data read since these statistics were last reset or since the controller was restarted.
Output Percent of unwritable cache in controller ID The percentage of cache space occupied by unwritable data in the indicated controller module. Examples Show the percentage of unwritable cache data in each controller. # show unwritable-cache Basetypes unwritable-cache status See also clear cache show users Description Shows configured user accounts. Minimum role monitor Syntax show users [show-snmp-password] [user] Parameters show-snmp-password Optional. Minimum role: manage.
• • x: The user can access the Storage Management Initiative Specification (SMI-S) interface. (blank): The user cannot access this interface. SNMP • • • U: The user can access the SNMPv3 interface and view the MIB. (blank): The user cannot access this interface. T: The user can access the SNMPv3 interface and receive trap notifications. Authentication Type • • • MD5: MD5 authentication. SHA: SHA-1 authentication. none: No authentication. Privacy Type • • • DES: Data Encryption Standard.
The name of the disk group. Size The size of the disk group. Free The amount of free (available) space in the disk group. Own Either the preferred owner during normal operation or the partner controller when the preferred owner is offline. Pref The controller that owns the disk group and its volumes during normal operation. RAID The disk-group RAID level. Class • • Linear: The disk group acts as a linear pool. Virtual: The disk group is in a virtual pool. Disks The number of disks in the disk group.
• • • • • • • • • • • • DRSC: A disk is being scrubbed. EXPD: The disk group is being expanded. INIT: The disk group is initializing. RBAL: The ADAPT disk group is being rebalanced. RCON: At least one disk in the vdisk is being reconstructed. VDRAIN: The virtual disk group is being removed and its data is being drained to another disk group. VPREP: The virtual disk group is being prepared for use in a virtual pool.
# show vdisks vd0002 Base types virtual-disks status See also create vdisk delete vdisks expand vdisk set vdisk show vdisk-statistics Description Shows live or historical performance statistics for linear disk groups. This command applies to linear storage only. You can view live statistics for all or specified disk groups, or historical statistics for a specified disk group.
Parameters all Optional. Specifies to show the full set of performance metrics. If this parameter is omitted, the default set of performance metrics will be shown. count number-of-data-samples Optional. Specifies the number of data samples to display, from 1 to 100. Each sample will be shown as a separate row in the command output. If this parameter is omitted, 100 samples will be shown. If you specify this parameter, do not specify the time-range parameter. historical Optional.
The average response time in microseconds for all read operations, calculated over the interval since these statistics were last requested or reset. Write Resp Time The average response time in microseconds for all write operations, calculated over the interval since these statistics were last requested or reset. Reset Time The date and time, in the format yyyy-mm-dd hh : mm : seconds, when these statistics were last reset, either by a user or by a controller restart.
# show vdisk-statistics VD2 historical time-range "start 2013-01-18 4:40 PM end 2013-01-18 5:00 PM" Show all historical statistics (the latest 100 samples) for linear disk group VD2. # show vdisk-statistics VD2 historical all Basetypes vdisk-statistics (live) virtual-disk-summary (historical) vdisk-hist-statistics (historical) status See also reset all-statistics reset vdisk-statistics show vdisks show versions Description Shows firmware and hardware version information for the system.
Syntax show volume-copies Output Src Volume The name of the source volume. Src Type The type of the source volume: Virtual Src Pool The name of the source pool: A or B. Dest Volume The name of the destination volume. Dest Type The type of the destination volume. Dest Pool The name of the destination pool: A or B. Progress The percent complete of the operation. Examples Show information about in-progress copy volume operations.
The name of the volume. Total Size The total size of the volume. Alloc Size The amount of space currently allocated to a virtual volume, or the total size of a linear volume. Class • Virtual: The volume is in a virtual pool. Type • • base: Base volume standard: Standard volume Health • • • • • OK Degraded Fault N/A Unknown Reason If Health is not OK, this field shows the reason for the health state. Action If Health is not OK, this field shows recommended actions to take to resolve the health issue.
The name of the volume. Serial Number The serial number of the volume. Examples Show volume names and serial numbers. # show volume-names Base types volume-names status See also show maps show volumes show volume-reservations Description Shows persistent reservations for all or specified volumes. The persistent group reservations (PGR) mechanism enables application clients on multiple hosts to control access to a storage volume, and limits access by other hosts.
• • • • Exclusive Access - Registrants Only: Certain access (read, write) commands are only allowed for registered hosts. There is a single reservation holder. Write Exclusive - All Registrants: Write commands are only allowed for registered hosts. There is a single reservation holder. Exclusive Access - All Registrants: Certain access (read, write) commands are only allowed for registered hosts. There is a single reservation holder. Undefined: The volume has no persistent reservations.
IOPS The input/output operations per second, calculated over the interval since these statistics were last requested or reset. This value will be zero if it has not been requested or reset since a controller restart. Reads The number of read operations since these statistics were last reset or since the controller was restarted. Writes The number of write operations since these statistics were last reset or since the controller was restarted.
[pool pool] [type all|base|standard|snapshot|primary-volume|secondary-volume] [vdisk vdisks] [volumes] Parameters details Optional. Shows additional information about the volumes. pattern string Optional. Shows volumes whose names contain the specified string. The string can include the following wildcards, singly or in combination. * Matches zero or more characters. ? Matches any one character. Use multiple '?' wildcards to find names of a specific length.
Class • • Linear: The volume is in a linear pool. Virtual: The volume is in a virtual pool. Desc Shown by the details parameter. Blank if not set. Health • • • • • OK Degraded Fault N/A Unknown Large Virtual Extents For a virtual volume, this shows whether the system will try to allocate pages in a sequentially optimized way to reduce I/O latency and improve performance. • • disabled or off: Optimized page allocation is disabled. This is the default. enabled or on: Optimized page allocation is enabled.
• • • • never-delete: Snapshots will never be deleted. high: Snapshots may be deleted after all eligible medium-priority snapshots have been deleted. medium: Snapshots may be deleted after all eligible low-priority snapshots have been deleted. low: Snapshots may be deleted. Snapshots that are mapped or are not leaves of a volume's snapshot tree are not eligible for automatic deletion. Tier Affinity Shown by the details parameter.
show disk-groups show maps show pools show vdisks shutdown Description Shuts down the Storage Controller in a controller module. This ensures that a proper failover sequence is used, which includes stopping all I/O operations and writing any data in write cache to disk. CAUTION: Performing a shut down will cause data to be unavailable from the Storage Controller that is shut down. If the Storage Controller in each controller module is shut down, hosts cannot access the system’s data.
create replication-set delete replication-set resume replication-set set replication-set show replication-sets test Description Sends a test message to configured destinations for event notification and managed logs. After issuing this command, verify that the test message reached its destinations.
trust Description Enables an offline disk group to be brought online for emergency data recovery. CAUTION: Improper use of trust may cause data corruption or data loss. NOTE: This command is for use by or with direction from technical support. This command must be enabled before each use. If used improperly this command can cause unstable operation and data loss. Before use, carefully read the cautions and procedures below.
5. Unseat the spare disks associated with the disk group to prevent reconstruction. CAUTION: It is recommended to avoid reconstruction after using the trust command. Reconstruction causes heavy usage of disks that were already reporting errors. This usage could cause the disks to fail during reconstruction, which can cause data to be unrecoverable. 6. Enable the trust command. 7. Run the trust command on the disk group. 8. If the trust command determines that it would be unsafe to proceed, it will fail.
The serial number of the disk. Type • • • SAS: Enterprise SAS spinning disk. SAS MDL: Midline SAS spinning disk. SSD SAS: Dual-port, SAS solid-state disk (SSD). State • • • • • • AVAIL: Available FAILED: The disk is unusable and must be replaced. Reasons for this status include: excessive media errors, SMART error, disk hardware failure, or unsupported disk.
group to an accessible state. Continuing with the trust operation may lead to data corruption. Please contact Support for further assistance. (2013-09-08 09:06:46) Continuing the previous example, you decide to re-enable trust and proceed by specifying the unsafe parameter. # trust enable Success: Command completed successfully. - Trust is enabled.
verify vdisk unfail controller Description Allows the partner controller module to recover from a simulated failure performed with the fail command (which requires the manage role). If you attempt to unfail a controller that is operating, the command will have no effect. Minimum role manage Syntax unfail controller Examples From controller A, unfail the partner controller.
Examples Delete explicit mappings for Host1 to volumes vol1 and vol3 (leaving the default mappings, if any, unchanged). # unmap volume initiator Host1.* vol1,vol3 Delete volume vol2’s default mapping (leaving explicit mappings, if any, unchanged). # unmap volume vol2 Delete explicit mappings for initiator FC-port1 to volume group MyVolumes (leaving the default mappings, if any, unchanged). # unmap volume initiator FC-port1 MyVolumes.*.
verify links Description Verifies FC or iSCSI host-port link paths between controller A and controller B. Minimum role manage Syntax verify link [link-type FC|iSCSI|ALL] Parameters link-type FC|iSCSI|ALL Optional. Specifies the type of host-port links to verify: • • • FC: Verify FC-to-FC links only. iSCSI: Verify iSCSI-to-iSCSI links only. ALL: Verify all FC-to-FC and iSCSI-to-iSCSI links. If this parameter is omitted, all links are verified. Output Port The port ID. Type • • • FC: FC port.
Optional. Specifies whether or not to automatically fix parity mismatches by making parity match the data in all cases. The default is no. vdisks A comma-separated list of the names or serial numbers of the vdisks to verify. A name that includes a space must be enclosed in double quotes. Examples Start verifying vdisk vd1.
4 API basetype properties Chapter 3 describes command output that is shown in console format. This chapter describes the basetype properties that CLI commands display in API format, and is organized to help you find a basetype by name. This chapter excludes basetypes that are for internal use only. Each basetype topic includes the following information: • • • References to CLI commands that directly use the basetype.
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 278 expander-ports expander-versions expanders fan fan-module-versions fan-modules fc-port fde-state fenced-data fru-versions host host-group host-group-view host-port-statistics host-view-mappings initiator initiator-view inquiry io-modules iom-versions ipv6-network-parameters iscsi-parameters iscsi-port license local-ports local-ports-detail log-header-table mgmt-hostnames midplane-versions
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • sas-status-drawer schedules security-communications-protocols sensors service-tag-info sessions show-other-MC-status shutdown-status sideplanes snap-space snapshots snapshot-with-retention-tasks snap-tasks snmp-parameters spares-preview status storage-preview support-assist syslog-parameters system system-parameters-table tasks tier-hist-statistics tier-statistics tier-summary tiers time-settings-table unhealthy-compo
Table 6. adapt-expand-preview properties (continued) Name Type Description type string Disk description. • • • type-numeric uint32 SAS: Enterprise SAS spinning disk. SAS MDL: Midline SAS spinning disk. SSD SAS: SAS solid-state disk. Numeric equivalents for type values. • • • 4: SAS 8: SSD SAS 11: SAS MDL size string Disk group capacity, formatted to use the current base, precision, and units. size-numeric uint64 Unformatted size value in blocks.
Table 6. adapt-expand-preview properties (continued) Name Type Description enclosure-id string Enclosure ID. disk-count uint32 Number of disks in the disk group. disk-display string The disks that would be used, listed as hyphenated disk ranges where possible to aid readability (e.g., 1.1-12,...). If the list exceeds 60 characters, see the full list shown by disk-display-full. disk-display-full string The disks that would be used, listed individually (e.g., 1.1,1.2,...).
Table 7. advanced-settings-table properties (continued) Name Type Description • • • smart-numeric uint32 Numeric equivalents for smart values. • • • dynamic-spares string Detect-Only: Each disk in the system retains its individual SMART setting, as will new disks added to the system. Enabled: SMART is enabled for all disks in the system and will be enabled for new disks added to the system.
Table 7. advanced-settings-table properties (continued) Name Type Description • • missing-lun-response-numeric uint32 Numeric equivalents for missing-lun-response values. • • controller-failure string uint32 string uint32 string uint32 string uint32 string uint32 0: Disabled 1: Enabled Shows whether the cache policy will change from write-back to write-through when a fan fails. • • fan-failure-numeric Disabled: The power-supply failure trigger is disabled.
Table 7. advanced-settings-table properties (continued) Name Type Description • temperature-exceeded string Shows whether the system will shut down a controller when its temperature exceeds the critical operating range. • • temperature-exceeded-numeric uint32 string • uint32 string uint32 string uint32 0: Disabled 1: Enabled Shows whether spinning disks that are available or are global spares will spin down after a period of inactivity shown by the disk-dsd-delay property.
Table 7. advanced-settings-table properties (continued) Name Type Description managed-logs string Shows whether the managed logs feature is enabled, which allows log files to be transferred from the storage system to a log-collection system to avoid losing diagnostic data as logs fill. • • managed-logs-numeric uint32 Numeric equivalents for managed-logs values.
Table 7. advanced-settings-table properties (continued) Name Type Description • • 0: Disabled 1: Enabled random-io-performanceoptimization string Shows whether random I/O performance optimization is enabled or disabled. random-io-performanceoptimization-numeric uint32 • • cache-flush-timeout string Shows whether the cache flush timeout is enabled or disabled.
Table 8. cache-parameter properties (continued) Name Type Description • • • read-ahead-numeric uint32 Adaptive: Adaptive read-ahead is enabled, which allows the controller to dynamically calculate the optimum read-ahead size for the current workload. Stripe: Read-ahead is set to one stripe. The controllers treat NRAID and RAID-1 disk groups internally as if they have a stripe size of 512 KB, even though they are not striped. 512 KB, 1 MB, 2 MB, 4 MB, 8 MB, 16 MB, or 32 MB: Size selected by a user.
Table 10. certificate-status properties Name Type Description controller string • • controller-numeric uint32 Numeric equivalents for controller values. certificate-status string • • 0: A 1: B • Customer-supplied: The controller is using a certificate that you have uploaded. System-generated: The controller is using system-generated certificates. Unknown status: The controller certificate cannot be read.
Table 12. cli-parameters properties (continued) Name Type Description • • • api-embed: Alternate form of XML output which displays “child” objects embedded (indented) under “parent” objects. ipa: Alternate form of XML output which displays like api-embed format with brief mode enabled. ipa: Alternate form of XML output which displays like api-embed format with brief mode enabled. json: Standard JavaScript Object Notation (JSON) output. wbi: A JSON-like format used internally by the PowerVault Manager.
Table 12. cli-parameters properties (continued) Name Type Description • storage-size-base uint8 11: Chinese-simplified Base for entry and display of storage-space sizes. • • 2: Sizes are shown as powers of 2, using 1024 as a divisor for each magnitude. 10: Sizes are shown as powers of 10, using 1000 as a divisor for each magnitude. Operating systems usually show volume size in base 2. Disk drives usually show size in base 10. Memory (RAM and ROM) size is always shown in base 2.
Table 12. cli-parameters properties (continued) Name Type Description • management-mode-numeric uint32 Virtual: Uses terminology in command output and system messages that is generalized for managing virtual and linear storage. For example, disk group for disk groups and pool for pools. Numeric equivalents for management-mode values. • • 2: Linear 3: Virtual cloud-iq This basetype is used by show cloudiq on page 168. Table 13.
Table 14. code-load-readiness properties (continued) Name Type Description code-load-readiness-reasons Embedded; see code-load-readiness-reasons on page 292. code-load-readiness-reasons This basetype is used by check firmware-upgrade-health on page 37. Table 15. code-load-readiness-reasons properties Name Type Description readiness-reason string The condition that was detected.
Table 17. compact-flash properties (continued) Name Type Description cache-flush string • • cache-flush-numeric uint32 Enabled: If the controller loses power, it will automatically write cache data to the CompactFlash card. Cache flush is normally enabled, but is temporarily disabled during controller shut down. Disabled: Cache flush is disabled. Numeric equivalents for cache-flush values.
Table 18. contact-information properties (continued) Name Type Description preferred-contact-hours-starttime string The preferred contact hours: start and end. preferred-contact-hours-endtime string preferred-email-language string The preferred email language. email-notifications string • • email-notifications-numeric uint32 Numeric equivalents for email-notifications values. • • Disabled: Email notifications are disabled. Enabled: Email notifications are enabled.
Table 19. controller-cache-parameters properties (continued) Name Type Description • 1: Installed OK Degraded Fault N/A Unknown compact-flash-health string • • • • • compact-flash-health-numeric uint32 Numeric equivalents for compact-flash-health values. cache-flush string • • • • • 0: OK 1: Degraded 2: Fault 3: Unknown 4: N/A • Enabled: If the controller loses power, it will automatically write cache data to the CompactFlash card.
Table 21. controllers properties (continued) Name Type Description controller-id-numeric uint32 • • 0: B 1: A serial-number string • • Serial number of the controller module. Not Available: The controller module is down or not installed. hardware-version string Controller module hardware version. cpld-version string Complex Programmable Logic Device (CPLD) firmware version. mac-address string Controller network port MAC address.
Table 21. controllers properties (continued) Name Type Description • Yes: The partner controller has either failed or been shut down, and its responsibilities have been taken over by this controller. There will be a delay between the time that the value of the status property becomes Down for one controller and the time that the value of the failed-over property becomes Yes for the other controller.
Table 21. controllers properties (continued) Name Type Description • • • 0: write-back 1: write-through 2: Not up description string FRU long description. part-number string Part number for the FRU. revision string Hardware revision level for the FRU. dash-level string FRU template revision number. fru-shortname string FRU short description. mfg-date string Date and time, in the format year-month-day hour:minutes:seconds (UTC), when the PCBA of the controller was programmed.
Table 21. controllers properties (continued) Name Type Description • • • • rotation string Rotation of the controller module in the enclosure. • • • • rotation-numeric string string uint32 string • • • redundancy-status uint32 string 0: Enabled 1: Disabled The operating mode of the sytem, also called the cache redundancy mode. • redundancy-mode-numeric Enabled: PHY fault isolation is enabled. Disabled: PHY fault isolation is disabled. Numeric equivalents for phy-isolation values.
Table 21. controllers properties (continued) Name Type Description • redundancy-status-numeric uint32 Unknown: Status information is not available. Numeric equivalents for redundancy-status values. • • • • • 0: Operational but not redundant 1: Redundant with independent cache 3: Redundant 4: Down 5: Unknown unhealthy-component Embedded; see unhealthy-component on page 412. ip-address Embedded; see network-parameters on page 362. port-details Embedded; see port on page 371.
Table 22. controller-statistics properties (continued) Name Type Description write-cache-misses uint64 For the controller that owns the volume, the number of times the block written to is not found in cache. data-read string Amount of data read since these statistics were last reset or since the controller was restarted. data-read-numeric uint64 Unformatted data-read value. data-written string Amount of data written since these statistics were last reset or since the controller was restarted.
Table 23. copy-volumes properties (continued) Name Type Description progress string The percent complete of the operation. cs-replicate-tasks This basetype is used by show schedules on page 232. Table 24. cs-replicate-tasks properties Name Type Description replication-set-name string The name of the replication set. replication-set-serialnum string The serial number of the replication set.
Table 25. cs-replication-set properties (continued) Name Type Description most-recent- suspend-time string The most recent time that the replication was suspended. most-recent- suspend-timenumeric uint32 Unformatted most-recent-suspend-time value. num-seconds- suspended uint32 The amount of time, in seconds, that the replication was suspended. suspend-count uint32 The number of times the replication was suspended. error-count uint32 The number of times the replication experienced an error.
Table 26. cs-replication-set-properties (continued) Name Type Description queue-policy-numeric uint32 Numeric equivalents for queue-policy values. • • • 0: none 1: discard 2: queue-latest queue-count uint8 The number of queued replications for the replication set: either 0 or 1. snapshot-history string Specifies whether to maintain a replication snapshot history for the replication set. • • • snapshot-history-numeric uint32 disabled or off: A snapshot history will not be kept.
Table 26. cs-replication-set-properties (continued) Name Type Description status-numeric uint32 Numeric equivalents for status values. failback-in-progress string Not supported. failback-in-progress-numeric uint32 Not supported. failback-sync- complete string Not supported. failback-sync-complete-numeric uint32 Not supported. last-success-time string The date and time when the system took a snapshot of the primary volume in preparation for starting the last successful replication run.
debug-log-parameters This basetype is used by show debug-log-parameters on page 173. Table 28. debug-log-parameters properties Name Type Description host-dbg string Shows whether host interface debug messages are enabled for inclusion in the Storage Controller debug log. • • host-dbg-numeric uint32 Numeric equivalents for host values.
Table 28. debug-log-parameters properties (continued) Name Type Description ioa-numeric uint32 Numeric equivalents for ioa values. • • iob string Shows whether resource-count debug messages for an I/O interface driver are enabled for inclusion in the Storage Controller debug log. • • iob-numeric uint32 string uint32 string uint32 string uint32 string uint32 string Off: Disabled. On: Enabled. Numeric equivalents for host2 values.
Table 28. debug-log-parameters properties (continued) Name Type Description raid-numeric uint32 Numeric equivalents for raid values. • • cache string Shows whether cache debug messages are enabled for inclusion in the Storage Controller debug log.
Table 28. debug-log-parameters properties (continued) Name Type Description awt-numeric uint32 Numeric equivalents for awt values. • • res2 string Shows whether internal debug messages are enabled for inclusion in the Storage Controller debug log. • • res2-numeric uint32 string uint32 0: Off 1: On Shows whether Internal Configuration API tracing messages are enabled for inclusion in the Storage Controller debug log. • • capi2-numeric Off: Disabled. On: Enabled.
Table 28. debug-log-parameters properties (continued) Name Type Description ps string Shows whether paged storage debug messages are enabled for inclusion in the Storage Controller debug log. • • ps-numeric uint32 Numeric equivalents for ps values. • • cache2 string uint32 string uint32 string uint32 string uint32 string uint32 API basetype properties Off: Disabled. On: Enabled. Numeric equivalents for cs values.
disk-groups This basetype is used by show configuration on page 168, show disk-groups on page 173, and show pools on page 213. Table 29. disk-groups properties Name Type Description name string The name of the disk group. url string Disk group URL. blocksize uint32 The size of a block, in bytes. size string Disk group capacity, formatted to use the current base, precision, and units. size-numeric uint64 Unformatted size value in blocks.
Table 29. disk-groups properties (continued) Name Type Description pool-percentage uint8 The percentage of pool capacity that the disk group occupies. performance-rank uint8 Disk group performance rank within the virtual pool. owner string Either the preferred owner during normal operation or the partner controller when the preferred owner is offline. • • owner-numeric uint32 Numeric equivalents for owner values.
Table 29. disk-groups properties (continued) Name Type Description status string • • • • • • • • • • • • status-numeric uint32 CRIT: Critical. The disk group is online but isn't fault tolerant because some of its disks are down. DMGD: Damaged. The disk group is online and fault tolerant, but some of its disks are damaged. FTDN: Fault tolerant with a down disk. The disk group is online and fault tolerant, but some of its disks are down. FTOL: Fault tolerant and online. MSNG: Missing.
Table 29. disk-groups properties (continued) Name Type Description read-ahead-enabled string Deprecated. read-ahead-enabled-numeric uint32 Deprecated. write-back-enabled string Deprecated. write-back-enabled-numeric uint32 Deprecated. job-running string Same as current-job. current-job string Job running on the disk group, if any. • • • • • • • • • • • • current-job-numeric uint32 DRSC: A disk is being scrubbed. EXPD: The disk group is being expanded.
Table 29. disk-groups properties (continued) Name Type Description new-partition-lba string Maximum number of blocks that could be allocated to a newly created volume. The value is formatted to use the current base, precision, and units. Expanding a volume in the same disk group will reduce this amount. new-partition-lba-numeric uint64 Unformatted new-partition-lba value in blocks. array-drive-type string Type of disks used in the disk group.
Table 29. disk-groups properties (continued) Name Type Description disk-dsd-delay-vdisk uint32 For spinning disks in a linear disk group, the period of inactivity after which the disks and dedicated spares will automatically spin down, from 1 to 360 minutes. The value 0 means spin down is disabled. adapt-target-spare-capacity string For an ADAPT disk group, the target spare capacity in GiB. Typically twice the capacity of the largest disk in the disk group.
Table 29. disk-groups properties (continued) Name Type Description unhealthy-component Embedded; see unhealthy-component on page 412. disk-groups-preview This basetype is used by add storage on page 35 when the preview parameter is specified. Table 30. disk-groups-preview properties Name Type Description name string The name of the disk group. pool string The name of the pool that contains the disk group. type string Disk description.
Table 30. disk-groups-preview properties (continued) Name Type Description tier-numeric uint32 Numeric equivalents for storage-tier values. • • • • • 0: N/A 1: Permance 2: Standard 4: Archive 8: Read Cache enclosure-id string Enclosure ID. disk-count unit32 Number of disks in the disk group. disk-display string The disks that would be used, listed as hyphenated disk ranges where possible to aid readability (e.g., 1.1-12,...).
Table 31. disk-group-statistics properties (continued) Name Type Description avg-read-rsp-time uint32 Average response time in microseconds for all read operations, calculated over the interval since these statistics were last requested or reset. avg-write-rsp-time uint32 Average response time in microseconds for all write operations, calculated over the interval since these statistics were last requested or reset. disk-group-statistics-paged Embedded; see disk-group-statistics-paged on page 319.
Table 33. disk-hist-statistics properties (continued) Name Type Description read-bytes-per-sec string Data transfer rate, in bytes per second, for read operations since the last sampling time. read-bytes-per-sec-numeric uint64 Unformatted read-bytes-per-second value. write-bytes-per-sec string Data transfer rate, in bytes per second, for write operations last sampling time. write-bytes-per-sec-numeric uint64 Unformatted write-bytes-per-second value.
Table 34. disk-statistics properties (continued) Name Type Description bytes-per-second-numeric uint64 Unformatted bytes-per-second value. iops uint32 Input/output operations per second, calculated over the interval since these statistics were last requested or reset. This value will be zero if it has not been requested or reset since a controller restart. number-of-reads uint64 Number of read operations since these statistics were last reset or since the controller was restarted.
Table 34. disk-statistics properties (continued) Name Type Description spinup-retry-count-2 uint32 For port 2, the number of times the disk did not respond. number-of-media-errors-2 uint32 For port 2, the number of attempts by the storage system to spin up the disk. number-of-nonmedia-errors-2 uint32 For port 2, the number of media errors generated by the disk, as specified by its manufacturer.
Table 36. drawers properties (continued) Name Type Description • 3: Bottom rows uint8 Number of rows of disk slots. columns uint8 Number of columns of disk slots. slots uint8 Number of disk slots in drawer. number-of-disks uint8 Number of disk slots (not installed disks) in drawer. emp-a-busid string SCSI channel ID of Enclosure Management Processor (EMP) A in the Expander Controller of a drawer.
Table 36. drawers properties (continued) Name Type Description • • • • 4: Unrecoverable 5: Not Installed 6: Unknown 7: Unavailable extended-status hex32 A numeric value that supplements the standard SES status shown by the status and status-numeric properties, and represents a specific condition. health string • • • • • health-numeric uint32 Numeric equivalents for health values.
Table 37. drive-parameters properties (continued) Name Type Description drive-timeout-retry-max uint8 Maximum number of times a timed-out I/O operation can be retried before the operation is failed. This value cannot be changed. drive-attempt-timeout uint8 Number of seconds before an I/O operation is aborted and possibly retried. This value cannot be changed.
Table 39. drives properties (continued) Name Type Description port uint32 For internal use only. scsi-id uint32 SCSI ID assigned to this disk for the primary channel. blocksize uint32 The size of a block, in bytes. blocks uint64 The number of blocks, whose size is specified by the blocksize property. serial-number string Disk serial number. vendor string Disk vendor. model string Disk model. revision string Disk firmware revision level.
Table 39. drives properties (continued) Name Type Description • • • usage string Shows the usage of the disk. • • • • • • • • • • usage-numeric uint32 uint32 AVAIL: The disk is available. DEDICATED SP: The disk is a spare assigned to a linear disk group. FAILED: The disk is unusable and must be replaced. Reasons for this status include: excessive media errors, SMART error, disk hardware failure, or unsupported disk. GLOBAL SP: The disk is a global spare. LEFTOVR: The disk is a leftover.
Table 39. drives properties (continued) Name Type Description owner string Current owner, which is either the preferred owner during normal operation or the partner controller when the preferred owner is offline. • • owner-numeric uint32 A: Controller A. B: Controller B. Numeric equivalents for owner values. • • 0: B 1: A index uint32 For internal use only. rpm uint32 The speed of a spinning disk, in thousands of revolutions per minute, as specified by the disk vendor.
Table 39. drives properties (continued) Name Type Description • • • • • • • recon-state string The state of the disk (source or destination) if it is involved in a reconstruct operation. • • • recon-state-numeric uint32 Warning: The disk is present but the system is having communication problems with the disk LED processor. For disk and midplane types where this processor also controls power to the disk, power-on failure will result in Error status.
Table 39. drives properties (continued) Name Type Description fde-config-time string If the system is secured, the time at which the current lock ID was set in the format year-month-day hour:minutes:seconds (UTC). Otherwise, N/A. fde-config-time-numeric uint32 Unformatted fde-config-time value. temperature string Temperature of the disk. temperature-numeric uint32 Numeric equivalent for the temperature value.
Table 39. drives properties (continued) Name Type Description • • • • • • health string Disk health. • • • • • health-numeric uint32 0x04000000: Unexpected usage 0x08000000: Enclosure fault sensed 0x10000000: Unsupported block size 0x20000000: Unsupported vendor 0x40000000: Timed-out 0x200000000: Preemptive pending degraded OK Degraded Fault Unknown N/A Numeric equivalents for health values.
Table 40. email-parameters properties (continued) Name Type Description • • • • 2: warn 3: error 4: crit 5: none email-notify-address-1 string Up to three email addresses for recipients of event notifications. email-notify-address-2 string email-notify-address-3 string email-notify-address-4 string Shows the email address for the log-collection system used by the log- management feature.
Table 41. enclosure-fru properties (continued) Name Type Description part-number string FRU part number. serial-number string FRU serial number. revision string FRU hardware revision level. dash-level string FRU template revision number. fru-shortname string FRU short description. mfg-date string Date and time, in the format year-month-day hour:minutes:seconds (UTC), when a PCBA was programmed or a power supply module was manufactured.
enclosure-list This basetype is used by show configuration on page 168, and by show disks on page 179 when the encl parameter is specified. Table 42. enclosure-list properties Name Type Description status string Disk slot status. • • • • • • • • • status-numeric uint32 Up: The disk is present and is properly communicating with the expander. Spun Down: The disk is present and has been spun down by the drive spin down feature.
Table 43. enclosure properties (continued) Name Type Description name string Enclosure name. type string Internal name for the enclosure type. type-numeric uint32 Numeric equivalents for type values. iom-type string I/O module type. iom-type-numeric uint32 Numeric equivalents for iom-type values. platform-type string Hardware platform type. platform-type-numeric uint32 Numeric equivalents for platform-type values. board-model string Board model.
Table 43. enclosure properties (continued) Name Type Description fru-shortname string FRU short description. fru-location string FRU location. • • MID-PLANE SLOT: Chassis midplane. (blank): Not applicable. part-number string FRU part number. mfg-date string Date and time, in the format year-month-day hour:minutes:seconds(UTC), when a PCBA was programmed or a power supply module was manufactured. mfg-date-numeric uint32 Unformatted mfg-date value.
Table 43. enclosure properties (continued) Name Type Description emp-a string Shows the field name EMP A in console format. emp-a-ch-id-rev string SCSI address and firmware revision of controller A EMP. emp-b string Shows the field name EMP B in console format. emp-b-ch-id-rev string SCSI address and firmware revision of controller B EMP.
Table 44. event properties Name Type Description time-stamp string Date and time, in the format year-month-day hour:minutes:seconds (UTC), when this event was detected. time-stamp-numeric uint32 Unformatted time-stamp value. event-code string Event code. event-id string Event ID. model string Controller model. serial-number string Controller serial number. controller string • • controller-numeric uint32 Numeric equivalents for controller values.
Table 45. eventsLogs properties (continued) Name Type Description severity string Event severity. • • • • • severity-numeric uint32 Numeric equivalents for severity values. • • • • • message string CRITICAL: A failure occurred that may cause a controller to shut down. Correct the problem immediately. ERROR: A failure occurred that may affect data integrity or system stability. Correct the problem as soon as possible.
Table 46. expander-ports properties (continued) Name Type Description name string • • • status string Expander port status. • • • • • status-numeric uint32 Out Port: Egress (expansion) port on controller module or an expansion module. Can be connected to an ingress port in an expansion module. In Port: Ingress port on an expansion module. Can be connected to an egress (expansion) port in a controller module or an expansion module.
Table 47. expander-versions properties (continued) Name Type Description expander-id uint8 Expander ID. controller string • • controller-numeric uint32 Numeric equivalents for controller values. • • A: Controller A. B: Controller B. 0: B 1: A fw-revision string lOM firmware version, short form. fw-revision-full string IOM firmware version, long form. vpd-format-version string Vital Product Data (VPD) version. vpd-crc string VPD CRC.
Table 48. expanders properties (continued) Name Type Description • • • • • status-numeric uint32 Warning Unrecoverable Not Installed Unknown Unavailable Numeric equivalents for status values. • • • • • • • • 0: Unsupported 1: OK 2: Critical 3: Warning 4: Unrecoverable 5: Not Installed 6: Unknown 7: Unavailable extended-status hex32 Always 0 for this component. fw-revision string Expander firmware revision.
Table 49. fan properties (continued) Name Type Description • • • • • • • status-ses-numeric uint32 Numeric equivalents for status-ses values. • • • • • • • • extended-status hex32 • • • • string uint32 1: The device has reported a failure. 2: The device is off. 4: The device FRU is not installed. 8: The device status cannot be determined. 16: The device is requested to be on (not off). This is the default status and represents normal operation. 17: Device has failed. 18: Device is off.
Table 49. fan properties (continued) Name Type Description • • • 0: Left 1: Right 6: N/A serial-number string • (blank): Not applicable. part-number string • (blank): Not applicable. fw-revision string • • (blank): Not applicable. Firmware revision of a fan FRU. hw-revision string • (blank): Not applicable. locator-led string Shows the state of the locator LED on a fan unit. • • locator-led-numeric uint32 Off On Numeric equivalents for locator-led values.
fan-modules This basetype is used by show fan-modules on page 196. Table 51. fan-modules properties Name Type Description durable-id string Fan module ID. enclosure-id uint32 Enclosure ID. dom-id uint32 The fan module position, shown as an index value that starts at 0 and increments from left to right as viewed from the back of the enclosure. name string Fan module name. location string Fan module location. status string Fan module status.
Table 51. fan-modules properties (continued) Name Type Description • 4: Unknown health-reason string If Health is not OK, the reason for the health state. health-recommendation string If Health is not OK, the recommended action to take to resolve the health issue. unhealthy-component Embedded; see unhealthy-component on page 412. fan-details Embedded; see fan on page 342. fc-port This basetype is used by show ports on page 219 for a Fibre Channel port. Table 52.
Table 52. fc-port properties (continued) Name Type Description sfp-part-number string The SFP part number. sfp-revision string The SFP revision. sfp-supported-speeds string The link speeds that the SFP supports. sfp-supported-speeds-numeric uint32 Numeric equivalents for sfp-supported-speeds values. fde-state This basetype is used by show fde-state on page 198. Table 53.
fru-versions This basetype is used by show versions on page 258 when the frus parameter is specified. Table 55. fru-versions properties Name Type Description enclosure-id uint32 The enclosure ID. midplane-versions Embedded; see midplane-versions on page 362. expander-versions Embedded; see expander-versions on page 340. fan-module- versions Embedded; see fan-module-versions on page 344 psu-versions Embedded; see psu-versions on page 377.
Table 58. host-group-view properties Name Type Description durable-id string Host group ID. serial-number string The serial number of the host group. group-name string The name of the host group in the format host-group.*.*, where the first * represents all hosts in the group and the second * represents all initiators in those hosts. host-view-mappings Embedded; see host-view-mappings on page 350. host-port-statistics This basetype is used by show host-port statistics on page 203. Table 59.
Table 59. host-port-statistics properties (continued) Name Type Description stop-sample-time string Date and time, in the format year-month-day hour:minutes:seconds, when sampling stopped for the iops and bytes-per-second values. stop-sample-time-numeric uint32 Unformatted stop-sample-time value. host-view-mappings This basetype is used by show maps on page 208 when the initiator parameter is specified. Table 60.
Table 61. initiator properties (continued) Name Type Description • host-bus-type- numeric uint32 If the host entry was manually created: Undefined. Numeric equivalents of host-bus-type values. • • • • 0: UNKNOWN 6: FC 8: SAS 9: iSCSI For an FC initiator, its WWPN. For a SAS initiator, its WWPN. For an iSCSI initiator, its node name (typically the IQN). id string • • • host-id string If the initiator is a member of a host, the serial number of the host. Otherwise, NOHOST.
Table 63. inquiry properties (continued) Name Type Description ip-address string Controller network port IP address. ip6-link-local-address string The link-local IPv6 address. ip6-auto-source-address string The automatically configured IPv6 address, when applicable. ip6-auto-address-sourcenumeric uint32 The method used to assign or compute the automatic address: ip61-address string First IPv6 address for the controller management port, if set.
Table 64. io-modules properties (continued) Name Type Description • • position-numeric uint32 Numeric equivalents for position values. • • • • rotation string string 0: Left 1: Right 2: Top 3: Bottom Rotation of the controller module in the enclosure. • • • • rotation-numeric Top Bottom 0 Degrees 90 Degrees 180 Degrees 270 Degrees Numeric equivalents for position values.
Table 64. io-modules properties (continued) Name Type Description • • • • health-numeric uint32 Degraded Fault N/A Unknown Numeric equivalents for health values. • • • • • 0: OK 1: Degraded 2: Fault 3: Unknown 4: N/A health-reason string If Health is not OK, the reason for the health state. health-recommendation string If Health is not OK, the recommended action to take to resolve the health issue. unhealthy-component Embedded; see unhealthy-component on page 412.
Table 66. ipv6-network-parameters properties Name Type Description controller string • • controller-numeric uint32 Numeric equivalents for controller values. A: Controller A. B: Controller B. • • 0: A 1: B Enabled Disabled firewall string • • firewall-numeric uint32 Numeric equivalents for firewall values. • • 0: Disabled 1: Enabled Enabled Disabled autoconfig string • • autoconfig-numeric uint32 Numeric equivalents for autoconfig values.
Table 67. iscsi-parameters properties (continued) Name Type Description jumbo-frames string Shows whether support for jumbo frames is enabled. • • jumbo-frames-numeric uint32 Numeric equivalents for jumbo-frames values. • • isns string uint32 0: Disabled 1: Enabled Shows whether support for Internet Storage Name Service (iSNS) is enabled. • • isns-numeric Enabled: Jumbo-frame support is enabled. Disabled: Jumbo-frame support is disabled. Enabled: iSNS is enabled. Disabled: iSNS is disabled.
Table 68. iscsi-port properties (continued) Name Type Description mac-address string Unique Media Access Control (MAC) hardware address, also called the physical address. sfp-status string SFP status. • • • • sfp-status-numeric uint32 Numeric equivalents for sfp-status values. • • • • sfp-present string uint32 0: Not compatible 1: Incorrect protocol 2: Not present 3: OK Shows whether the port contains an SFP. • • sfp-present-numeric OK Not present: No SFP is inserted in this port.
Table 69. license properties (continued) Name Type Description platform-max-snapshots uint32 Maximum number of snapshots that the highest-level license allows. base-max-snapshots uint32 Maximum number of snapshots allowed without an installed license. max-snapshots uint32 Maximum number of snapshots allowed by the installed license. in-use-snapshots uint32 Number of existing licensed snapshots. max-snapshots-expiry string Shows when the snapshot license will expire.
Table 69. license properties (continued) Name Type Description volume-copy-numeric uint32 Numeric equivalents for volume-copy values. • • volume-copy-expiry string Shows when the volume copy license will expire.
Table 69. license properties (continued) Name Type Description • • vss-expiry string Shows when the VSS (Volume Shadow Copy Service) Hardware Provider will expire. • • • vss-expiry-numeric uint32 string uint32 string uint32 string uint32 string uint32 0: Disabled 1: Enabled Shows when the SRA feature will expire. • • • sra-expiry-numeric Disabled: SRA is disabled. Enabled: SRA is enabled. Numeric equivalents for sra values.
Table 70. local-ports properties Name Type Description local-host-port string The ID of the port in the local system. port-address string The assigned port address. local-ports-detail This basetype is used by show peer-connections on page 212 when the verify-links parameter is specified. Table 71. local-ports-detail properties Name Type Description local-host-port string The ID of the port in the local system. port-address string The assigned port address.
midplane-versions This basetype is used by show versions on page 258 when the frus parameter is specified. Table 74. midplane-versions properties Name Type Description vpd-format-version string Vital Product Data (VPD) version. vpd-crc string VPD CRC. cfg-mismatch- version string Configuration mismatch version. cpld-version string Complex Programmable Logic Device (CPLD) firmware version. fru-descriptor string FRU descriptor. part-number string Midplane part number.
Table 75. network-parameters properties (continued) Name Type Description duplex-mode string • • • duplex-mode-numeric uint32 Numeric equivalents for duplex-mode values. • • • health string uint32 0: full 1: half 2: Undefined The health of the network connection. • • • • • health-numeric Undefined: For a system operating in Single Controller mode, this controller module is not present. Half: The network port duplex mode is set to half duplex.
Table 76. ntp-status properties (continued) Name Type Description • • Date and time, in the format year-month-day hour:minutes:seconds (UTC), of the last message received from the NTP server. none: No contact. peer-connection-info This basetype is used by query peer-connection on page 84. Table 77. peer-connection-info properties Name Type Description system-name string The name of the system. system-contact string The name of the person who administers the system.
Table 78. peer-connections properties (continued) Name Type Description • • • • • 0: 1: 2: 3: 4: OK Degraded Fault Unknown N/A health-reason string If Health is not OK, this field shows the reason for the health state. health-recommendation string If Health is not OK, this field shows recommended actions to take to resolve the health issue. local-ports Embedded; see local-ports on page 360. remote-ports Embedded; see remote-ports on page 380.
Table 80. peer-ports properties Name Type Description local-host-port string The ID of the port in the local system. connection-type string The type of ports being used for the peer connection: • connection-type-numeric uint32 iSCSI Numeric equivalents for connection-type values. • 2: iSCSI OK Degraded Fault N/A host-port-health string • • • • host-port-health-numeric uint32 Numeric equivalents for health values.
Table 81. pool-hist-statistics properties (continued) Name Type Description read-bytes-per-sec-numeric uint64 Unformatted read-bytes-per-second value. write-bytes-per-sec string The data transfer rate, in bytes per second, for write operations since the last sampling time. write-bytes-per-sec-numeric uint64 Unformatted write-bytes-per-second value. number-of-allocated-pages uint64 The number of 4 MB pages allocated to volumes in the pool.
Table 82. pool-statistics properties (continued) Name Type Description num-page-promotions-to-ssdblocked uint64 The number of pages that could not be moved to SSD since statistics were last reset. num-hot-page-moves uint64 The number of “hot” pages promoted from lower tiers to higher tiers since statistics were last reset. num-cold-page-moves uint64 The number of “cold” pages promoted from lower tiers to higher tiers since statistics were last reset.
Table 84. pools properties (continued) Name Type Description available-pages uint32 For a virtual pool, the number of 4 MB pages that are still available to be allocated. For a linear pool, 0. overcommit string • • • overcommit-numeric uint32 Disabled: The allocated size of the volumes cannot exceed the physical capacity of the pool. Enabled: The allocated size of the volumes can exceed the physical capacity of the pool. N/A: Not applicable (linear pool).
Table 84. pools properties (continued) Name Type Description • • • • • • • • • • preferred-owner string Controller that owns the disk group and its volumes during normal operation. • • preferred-owner-numeric uint32 string uint32 0: B 1: A Current owner, which is either the preferred owner during normal operation or the partner controller when the preferred owner is offline. • • owner-numeric A: Controller A. B: Controller B. Numeric equivalents for preferred-owner values.
Table 84. pools properties (continued) Name Type Description reserved-size string The total number of pages that are reserved for virtual volumes in the pool. reserved-size-numeric unit64 Unformatted reserved-size value in blocks. reserved-unalloc-size string The total number of pages that are reserved, but not yet allocated, for virtual volumes in the pool. reserved-unalloc-size-numeric unit64 Unformatted reserved-unalloc-size value in blocks.
Table 85. port properties (continued) Name Type Description controller string • • controller-numeric uint32 Numeric equivalents for controller values. • • A : Controller A. B : Controller B. 0: B 1: A port string Controller ID and port number. port-type string • • • port-type-numeric uint32 Numeric equivalents for port-type values. FC : Fibre Channel. iSCSI : Internet SCSI. SAS : Serial Attached SCSI.
Table 85. port properties (continued) Name Type Description actual-speed-numeric uint32 Numeric equivalents for actual-speed values. • • • • • • • • • configured-speed string Configured host-port link speed in Gbit/s. • • • • • • configured-speed-numeric uint32 0: 1Gb 2: 4Gb 6: 6Gb 7: 8Gb 8: 10Mb 9: 100Mb 11: 12Gb 12: 16Gb 255 : Port is disconnected. Auto 1Gb 4Gb 8Gb 12Gb 16Gb Numeric equivalents for configured-speed values.
Table 86. power-supplies properties Name Type Description durable-id string Power supply ID in the format psu_enclosure-ID.power-supply-number. enclosure-id uint32 Enclosure ID. dom-id uint32 The power supply position, shown as an index value that starts at 0 and increments from left to right as viewed from the back of the enclosure. serial-number string Power supply serial number. part-number string FRU part number. description string FRU long description.
Table 86. power-supplies properties (continued) Name Type Description health string • • • • • health-numeric uint32 Numeric equivalents for health values. • • • • • OK Degraded Fault N/A Unknown 0: 1: 2: 3: 4: OK Degraded Fault Unknown N/A health-reason string If Health is not OK , the reason for the health state. health-recommendation string If Health is not OK , the recommended actions to take to resolve the health issue. status string Power supply status.
Table 88. provisioning properties Name Type Description volume string • • volume-serial string Volume serial number. wwn string • • controller string Owning controller of the disk group or pool. • • controller-numeric uint32 Volume name. Blank if the disk group or pool does not have a volume. Volume World Wide Name. Blank if the disk group or pool does not have a volume. A : Controller A. B : Controller B. Numeric equivalents for controller values.
Table 89. proxy-information properties (continued) Name Type Description • • 0: Disabled 1: Enabled host string The proxy host ID. port string The proxy host port number. protocol string • HTTP protocol-numeric uint32 • 0: HTTP user-name string The proxy user name used to access the proxy server. psu-versions This basetype is used by show versions on page 258 when the frus parameter is specified. Table 90.
Table 91. readcache-hist-statistics properties (continued) Name Type Description write-iops uint64 The number of write operations per second since the last sampling time. total-bytes-per-sec string The total data transfer rate, in bytes per second, since the last sampling time. total-bytes-per-sec-numeric uint64 Unformatted total-bytes-per-second value. read-bytes-per-sec string The data transfer rate, in bytes per second, for read operations since the last sampling time.
Table 92. redundancy properties (continued) Name Type Description • • • redundancy-status-numeric uint32 Operational but not redundant : In active-active mode, one controller is operational and the other is offline. In single-controller mode, the controller is operational. Down : Thi s controller is not operational. Unknown: Status information is not available. Numeric equivalents for redundancy-status values. • • • • 0: 3: 4: 5: Operational : The controller is operational.
Table 93. refresh-counters properties Name Type Description basetype-name (Not shown) Shows when the data represented by the base type was last updated. • • 0: The data has never been updated and is not cached. nonzero-number : A timestamp indicating that the data has been updated. If the value has changed since the last time you called this command then the data has changed. remote-ports This basetype is used by show peer-connections on page 212. Table 94.
Table 96. remote-system properties (continued) Name Type Description ip-address-a string • • The IP address of the network port in controller A in the remote system. Not Present ip-address-b string • • The IP address of the network port in controller B in the remote system. Not Present username string The name of a user that is configured in the remote system. This must be a user with the manage role to remotely configure or provision that system.
replication-snapshot-history This basetype is used by show replication-snapshot-history on page 230. Table 97. replication-snapshot-history properties Name Type Description name string The replication set name. serial-number string The replication set serial number. snapshot-history string Specifies whether to maintain a replication snapshot history for the replication set. • • • snapshot-history- numeric uint32 disabled or off : A snapshot history will not be kept.
resettable-statistics This basetype is used by show pool-statistics on page 215 and show tier-statistics on page 249. Table 99. resettable-statistics properties Name Type Description serial-number string The serial number of the pool or tier. time-since-reset uint32 The amount of time, in seconds, since these statistics were last reset, either by a user or by a controller restart.
Table 100. sas-host-phy-statistics properties (continued) Name Type Description lost-dwords uint32 The number of times the PHY has lost doubleword synchronization and restarted the Link Reset sequence. invalid-dwords uint32 The number of invalid doublewords that have been received by the PHY, not including those received during Link Reset sequences. reset-error-counter uint32 The number of times the PHY Reset sequence has failed.
Table 102. sas-status-controller-a properties (continued) Name Type Description • • • • • • • • wide-port-role-numeric uint32 Drawer Egress Drawer Ingress Expansion Egress Expansion Ingress SC Primary SC Alternate Inter Expander Unused Numeric equivalents for wide-port-role values. • • • • • • • • • • 0: 1: 2: 3: 4: 5: 6: 7: 8: 9: Unknown Drive Drawer Egress Drawer Ingress Expansion Egress Expansion Ingress SC Primary SC Alternate Inter Expander Unused wide-port-num uint32 The wide-port number.
Table 102. sas-status-controller-a properties (continued) Name Type Description • • status-numeric uint32 Numeric equivalents for status values. • • • • elem-status string Enabled - Degraded : The PHY is enabled but degraded. Disabled : The PHY has been disabled by a user or by the system. 0: 1: 2: 3: Unavailable Enabled - Healthy Enabled - Degraded Disabled The SES status that corresponds to the PHY status. • • • • • • Disabled : Critical condition is detected.
Table 102. sas-status-controller-a properties (continued) Name Type Description • • • elem-reason-numeric uint32 Unused - disabled by default : PHY is disabled by default because it is not used. Excessive PHY changes : PHY is disabled because of excessive PHY change counts. Did not initialize : PHY is enabled but not ready because it did not pass COMINIT. Numeric equivalents for elem-reason values.
Table 103. schedules properties (continued) Name Type Description status string Schedule status. • • • • • • Uninitialized : The schedule is not yet ready to run. Ready : The schedule is ready to run at the next scheduled time. Suspended : The schedule had an error and is holding in its current state. Expired : The schedule has exceeded a constraint and will not run again. Invalid : The schedule is invalid. Deleted : The task has been deleted.
Table 104. security-communications-protocols properties (continued) Name Type Description smis string • • smis-numeric uint32 Numeric equivalents for smis values. Disabled : The secure SMI-S interface is disabled. Enabled : The secure SMI-S interface is enabled. This option allows SMI-S clients to communicate with each controller's embedded SMI-S provider via HTTP port 5989. • • 0: Disabled 1: Enabled Disabled : The unsecure SMI-S interface is disabled.
Table 104. security-communications-protocols properties (continued) Name Type Description • 1: Enabled Disabled : The in-band SES interface is disabled. Enabled : The in-band SES interface is enabled. inband-ses string • • inband-ses-numeric uint32 Numeric equivalents for inband-ses values. activity-progress string • • 0: Disabled 1: Enabled • Enabled : Access to the activity progress interface via HTTP port 8081 is enabled.
Table 105. sensors properties (continued) Name Type Description • • • • 0: B 1: A 2: both N/A sensor-name string Sensor name and location. value string • • For a sensor, its value. For overall unit status, one of the status values below. status string • • OK : The sensor is present and detects no error condition. Warning : The sensor detected a non-critical error condition. Temperature, voltage, or current is between the warning and critical thresholds.
Table 105. sensors properties (continued) Name Type Description • • • • sensor-type-numeric uint32 Voltage Current Charge Capacity Unknown Type Numeric equivalents for sensor-type values. • • • • • 0: 1: 2: 3: 4: Temperature Current Voltage Charge capacity Unknown Type service-tag-info This basetype is used by show service-tag-info on page 234. Table 106. service-tag-info properties Name Type Description service-tag string An alphanumeric string that uniquely identifies the product.
Table 107. sessions properties (continued) Name Type Description host string For a CLI session, the IP address and port number of the connected system. state uint32 • • timeout uint32 The time in seconds that the session can be idle before it automatically ends. timeout-counter uint32 The time in seconds remaining before the session automatically ends. idle-time uint32 The time in seconds that the session has been idle. first-access string The date and time when the session started.
Table 109. shutdown-status properties (continued) Name Type Description • • • 0: up 1: down 2: not installed sideplanes This basetype is used by show enclosures on page 191. Table 110. sideplanes properties Name Type Description durable-id string Sideplane ID. enclosure-id uint32 Enclosure ID. drawer-id uint8 • • uint8 Not applicable ( 255 ).
Table 110. sideplanes properties (continued) Name Type Description • • • • • • • • extended-status hex32 0: 1: 2: 3: 4: 5: 6: 7: Unsupported OK Critical Warning Unrecoverable Not Installed Unknown Unavailable A numeric value that supplements the standard SES status shown by the status and status-numeric properties, and represents a specific condition.
Table 111. snap-space properties (continued) Name Type Description allocated-size-numeric uint64 Numeric equivalents for allocated-size values. snap-low-threshold string A percentage of the snapshot space designated as the low threshold. snap-middle-threshold string A percentage of the snapshot space designated as the middle threshold. snap-high-threshold string A percentage of the snapshot space designated as the high threshold.
Table 112. snapshots properties (continued) Name Type Description • status-reason-numeric uint32 Unknown reason Numeric equivalents for status-reason values. • • • • • • • 1: snapshot pending (not yet committed) 4: master volume not accessible 7: Volume copy with modified data is in progress 8: snapshot not found 10: master volume not found 254: N/A hex-code : Unknown reason master-volume-name string Name of the volume of which the snapshot was taken.
Table 112. snapshots properties (continued) Name Type Description • 0xa000: Volume-copy snapshot. Snapshot that is being used to copy data from a source volume to a destination volume. user_priority-value string User-defined retention priority for the snapshot type. snapshot-type string Snapshot type. • snapshot-type-numeric uint64 Standard snapshot : Snapshot of a source volume that consumes a snapshot license. Numeric equivalents for snapshot-type values.
snmp-parameters This basetype is used by show snmp-parameters on page 239. Table 115. snmp-parameters properties Name Type Description snmp-enabled string Shows whether the Simple Network Management Protocol (SNMP) interface is enabled or disabled. • • snmp-enabled- numeric uint32 Numeric equivalents for snmp-enabled values. • • snmp-filter string uint32 0: Disabled 1: Enabled Minimum level of events to include for SNMP traps • • • • • • snmp-filter- numeric Disabled—SNMP is disabled.
Table 116. spares-preview properties (continued) Name Type Description type-numeric uint32 Numeric equivalents for description values. tier string • • • 4: SAS 8: SSD SAS 11: SAS MDL • Archive: The disk group is in the lowest storage tier, which uses midline spinning SAS disks (<10k RPM, high capacity). Performance: The disk group is in the highest storage tier, which uses SSDs (high speed). Read Cache: The disk is an SSD providing high-speed read cache for a storage pool.
Table 116. spares-preview properties (continued) Name Type Description • • • 3: Secure, Locked 4: FDE Protocol Failure 5: Unknown status This basetype is used by all commands except exit on page 77, help on page 82, and meta on page 84. NOTE: The exit command does not provide a response; the help command always prints text; and the meta command does not use the status object. Table 117. status properties Name Type Description response-type string • • • • Success: The command succeeded.
Table 118. storage-preview properties (continued) Name Type Description spares-preview Embedded; see spares-preview on page 399. unused-disks-preview Embedded; see unused-disks-preview on page 413. support-assist This basetype is used by show support-assist. Table 119.
syslog-parameters This basetype is used by show syslog-parameters. Table 120. syslog-parameters properties Name Type Description syslog-host string The IP address of the remote syslog server to use for the notifications. syslog-notification-level string Shows the minimum severity for which the system sends notifications: • • • • • • syslog-notification-level-numeric uint32 Numeric equivalents for syslog-notification-level values.
Table 121. system properties (continued) Name Type Description • • • • • 0: 1: 2: 3: 4: OK Degraded Fault Unknown N/A health-reason string If Health is not OK , the reason for the health state. other-MC-status string The operational status of the Management Controller in the partner controller. This is not factored into system health. • • • • other-MC-status- numeric uint32 Operational Not Operational Not Communicating Unknown Numeric equivalents for other-mc-status values.
system-parameters-table This basetype is used by show system-parameters. Table 122. system-parameters-table properties Name Type Description ulp-enabled string Shows true to indicate that the system is using Unified LUN Presentation, which can expose all LUNs through all host ports on both controllers. The interconnect information is managed in the controller firmware.
Table 122. system-parameters-table properties (continued) Name Type Description max-volumes-per-volume-group uint32 The maximum number of volumes that a volume group can contain. max-replication-sets uint32 Number of replication sets that the system supports. max-enclosures uint32 Number of enclosures that the system supports. local-controller string The ID of the controller you are accessing. • • local-controller-numeric uint32 A: Controller A. B: Controller B.
Table 122. system-parameters-table properties (continued) Name Type Description max-ar-vols-allowed uint32 The maximum number of virtual replication volumes that the system supports. ar-sets-in-use-count uint32 The number of virtual replication volumes present in the system. linear-replication-configured string Not applicable. linear-replication-configurednumeric uint32 Not applicable.
Table 123. tasks properties (continued) Name Type Description • ○ Start ○ VerifyVolume ○ ValidateLicensingLimit ○ CreateName ○ CreateSnap ○ VerifySnap ○ InspectRetention ○ FindOldestSnap ○ UnmapSnap ○ ResetSnap ○ RenameSnap For a ResetSnapshot task: • ○ Start ○ VerifySnap ○ UnmapSnap ○ ResetSnap For a Replicate task: ○ Idle ○ Replicate ○ VerifyRunning error-message string • • associated-vdisk-serial string Not applicable.
Table 124. tier-hist-statistics properties (continued) Name Type Description total-bytes-per-sec string Total data transfer rate, in bytes per second, since the last sampling time. total-bytes-per-sec-numeric uint64 Unformatted total-bytes-per-second value. read-bytes-per-sec string Data transfer rate, in bytes per second, for read operations since the last sampling time. read-bytes-per-sec-numeric uint64 Unformatted read-bytes-per-second value.
Table 125. tier-statistics properties (continued) Name Type Description • 8: Read Cache pages-alloc-per-minute uint32 The rate, in pages per minute, at which pages are allocated to volumes in the pool because they need more space to store data. pages-dealloc-per-minute uint32 The rate, in pages per minute, at which pages are deallocated from volumes in the pool because they no longer need the space to store data.
Table 127. tiers properties (continued) Name Type Description tier string • • • • tier-numeric uint32 Archive: The lowest storage tier, which uses midline spinning SAS disks (<10k RPM, high capacity). Performance: The highest storage tier, which uses SSDs (high speed). Read Cache: The tier that provides read cache for a storage pool. Standard: The tier that uses enterprise-class spinning SAS disks (10k/15k RPM, higher capacity). Numeric equivalents for tier values.
unhealthy-component This basetype is used by all commands that show component health. Table 129. unhealthy-component properties Name Type Description component-type string Component type. • • • • • • • • • • • • • • • • • • • • • • • • component-type-numeric uint32 Numeric equivalents for component-type values.
Table 129. unhealthy-component properties (continued) Name Type Description • • • • 20: 21: 25: 26: snapshot host volume map system component-id string Component identifier, such as A for controller A. basetype string Component basetype. primary-key string Durable ID of the component. health string Component health. • • • • • health-numeric uint32 OK Degraded Fault Unknown N/A Numeric equivalents for health values.
Table 130. unused-disks-preview properties (continued) Name Type Description • tier-numeric uint32 Standard: The disk group is in the storage tier that uses enterprise-class spinning SAS disks (10k/15k RPM, higher capacity) Numeric equivalents for storage-tier values. • • • • • 0: N/A 1: Permance 2: Standard 4: Archive 8: Read Cache size string Disk group capacity, formatted to use the current base, precision, and units. size-numeric uint64 Unformatted size value in blocks.
Table 131. unwritable-cache properties (continued) Name Type Description unwritable-b-percentage uint8 The percentage of cache space occupied by unwritable data in controller B. users This basetype is used by show users. Table 132. users properties Name Type Description username string User name. roles string • • • user-type string The experience level of the user: Novice , Standard , Advanced , or Diagnostic . This parameter does not affect access to commands.
Table 132. users properties (continued) Name Type Description • 10: Sizes are shown as powers of 10, using 1000 as a divisor for each magnitude. Operating systems usually show volume size in base 2. Disk drives usually show size in base 10. Memory (RAM and ROM) size is always shown in base 2. storage-size-precision uint8 The number of decimal places (1-10) for display of storage-space sizes. storage-size-units string The unit for display of storage-space sizes.
vdisk-hist-statistics This basetype is used by show vdisk-statistics when the historical parameter is specified. Table 133. vdisk-hist-statistics properties Name Type Description total-data-transferred string Total amount of data read and written since the last sampling time. total-data-transferred-numeric uint64 Unformatted total-data-transferred value. data-read string Amount of data read since the last sampling time. data-read-numeric uint64 Unformatted data-read value.
Table 134. vdisk-statistics properties (continued) Name Type Description data-read-numeric uint64 Unformatted data-read value. data-written string Amount of data written since these statistics were last reset or since the controller was restarted. data-written- numeric uint64 Unformatted data-written value. avg-rsp-time uint32 Average response time in microseconds for read and write operations, calculated over the interval since these statistics were last requested or reset.
Table 135. versions properties (continued) Name Type Description ec-fw string Expander Controller firmware version. pld-rev string Complex Programmable Logic Device (CPLD) firmware version. prm-version string CPLD Power Reset Manager (PRM) version. hw-rev string Controller hardware version. him-rev string Host interface module revision. him-model string Host interface module model. backplane-type uint8 Backplane type.
Table 137. virtual-disks properties (continued) Name Type Description • • preferred-owner string Controller that owns the disk group and its volumes during normal operation. • • preferred-owner- numeric uint32 string uint32 0: B 1: A The disk-group RAID level. • • • • • • • • • raidtype-numeric A: Controller A. B: Controller B. Numeric equivalents for preferred-owner values.
Table 137. virtual-disks properties (continued) Name Type Description • • • • • • • • • • • • status-numeric uint32 CRIT: Critical. The disk group is online but isn't fault tolerant because some of its disks are down. DMGD: Damaged. The disk group is online and fault tolerant, but some of its disks are damaged. FTDN: Fault tolerant with a down disk. The disk group is online and fault tolerant, but some of its disks are down. FTOL: Fault tolerant and online. MSNG: Missing.
Table 137. virtual-disks properties (continued) Name Type Description read-ahead-enabled-numeric uint32 Deprecated. write-back-enabled string Deprecated. write-back-enabled-numeric uint32 Deprecated. job-running string Same as current-job. current-job string Job running on the disk group, if any. • • • • • • • • • • • • array-drive-type-numeric uint32 Numeric equivalents for array-drive-type values.
Table 137. virtual-disks properties (continued) Name Type Description • • • disk-dsd-enable-vdisk-numeric uint32 Enabled - all spinning: DSD is enabled for the disk group. Partial spin-down: DSD is enabled for the disk group and its disks are partially spun down to conserve power. Full spin-down: DSD is enabled for the disk group and its disks are fully spun down to conserve power. Numeric equivalents for disk-dsd-enable-vdisk values.
volume-groups This basetype is used by show volume-groups. Table 138. volume-groups Name Type Description durable-id string Volume group ID. group-name string The name of the volume group in the format volume-group.* , where * represents all volumes in the group. serial-number string The serial number of the volume group. type string The group type, which is Volume. type-numeric uint32 Numeric equivalents for type values. member-count uint32 The number of volumes in the volume group.
Table 140. volume-group-view-mappings properties (continued) Name Type Description access-numeric uint32 Numeric equivalents of access values. • • • • 0: 1: 2: 3: not-mapped no-access read-only read-write initiator-id string • • • • For an FC initiator, its WWPN. For a SAS initiator, its WWPN. For an iSCSI initiator, its node name (typically the IQN). all other initiators: The volume's default mapping. nickname string • For a host, its name in the format host-name.
Table 142. volume-reservations (continued) Name Type Description host-id string • • • port string The controller host-port identifiers. reserve-key string The reservation key, shown as a hexadecimal value. reserve-scope string The reservation scope, Logical Unit . reserve-scope- numeric uint32 Numeric equivalents for reserve-scope values. • reserve-type string • • • • • uint32 0: Logical Unit The reservation type. • • reserve-type- numeric For an FC initiator, its WWPN.
Table 143. volumes properties (continued) Name Type Description size string Volume capacity, formatted to use the current base, precision, and units. size-numeric uint64 Unformatted size value in blocks. total-size string The total size of the volume. total-size-numeric uint64 Unformatted total-size value in blocks. allocated-size string The amount of space currently allocated to a virtual volume, or the total size of a linear volume.
Table 143. volumes properties (continued) Name Type Description • cache-optimization-numeric uint32 Numeric equivalents for cache-optimization values. • • read-ahead-size string • • uint32 0: standard 2: no-mirror The read-ahead cache setting of the volume. • • read-ahead-size-numeric no-mirror: In this mode of operation, the controller cache performs the same as the standard mode with the exception that the cache metadata is not mirrored to the partner.
Table 143. volumes properties (continued) Name Type Description • tier-affinity-numeric uint32 Performance: This setting prioritizes volume data to the higher performing tiers. If no space is available, lower performing tier space is used. Performance affinity volume data will swap into higher tiers based upon frequency of access or when space is made available Numeric equivalents for tier-affinity values.
Table 143. volumes properties (continued) Name Type Description • • • • Copy Destination : The volume is the destination for a volume copy operation. Primary: The volume is the primary volume in a replication set. Secondary: The volume is the secondary volume in a replication set. (blank): Not applicable. Off: Not applicable. On: The volume is the destination for a volume copy operation. cs-copy-dest string • • cs-copy-dest-numeric uint32 Numeric equivalents for cs-copy-dest values.
Table 143. volumes properties (continued) Name Type Description group-key string If the volume is in a volume group, the durable ID of the volume group. Otherwise, VGU . volume-statistics This basetype is used by show volume-statistics. Table 144. volume-statistics properties Name Type Description volume-name string The name of the volume. serial-number string The serial number of the volume.
volume-view This basetype is used by show maps. Table 145. volume-view properties Name Type Description durable-id string Volume ID in the format V#, where # starts at 1 and increments for each new volume to uniquely identify it. The value is generated from available data in the current CLI session and may change after a Management Controller restart. volume-serial string The serial number of the volume. volume-name string Volume name.
Table 146. volume-view-mappings properties (continued) Name Type Description • • For a host group, its name in the format host-group.*.* , where the first * represents all hosts in the host group and the second * represents all initiators in those hosts. Blank if not set or for all other initiators. host-profile string Standard : Default profile. host-profile-numeric uint32 Numeric equivalents of host-profile values.
A Settings changed by restore defaults This appendix summarizes the system settings that result from using the restore defaults command. Table 147.
Table 147.
Table 147.
