Dell EMC PowerVault ME4 Series Storage System CLI Guide July 2021 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 – 2021 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................................................................................................................................................... 49 create replication-set....................................................................................................................................................... 50 create schedule...................................................................................................................................................
reset disk-group-statistics.............................................................................................................................................. 97 reset disk-statistics...........................................................................................................................................................97 reset dns-management-hostname................................................................................................................................
set prompt......................................................................................................................................................................... 143 set protocols..................................................................................................................................................................... 144 set replication-set..............................................................................................................................
show ipv6-network-parameters...................................................................................................................................212 show iscsi-parameters....................................................................................................................................................213 show license....................................................................................................................................................................
unmap volume..................................................................................................................................................................280 verify disk-groups............................................................................................................................................................ 281 verify links...............................................................................................................................................
fan-modules......................................................................................................................................................................349 fc-port............................................................................................................................................................................... 350 fde-state.......................................................................................................................................
sas-port............................................................................................................................................................................. 387 sas-status-controller-a.................................................................................................................................................. 387 sas-status-drawer.......................................................................................................................................
1 Using the CLI This chapter introduces the command-line interface (CLI). This document might contain third-party content that is not under the control of Dell EMC. The language in the third-party content might be in inconsistent with the current guidelines for Dell EMC content. Dell EMC reserves the right to update this document after the content is updated by the relevant third parties.
Using CLI interactively The CLI is an interactive application. When you are logged into the CLI, the CLI waits for a command and then responds to the command. NOTE: In the interactive mode, confirmation is required for commands that can cause data unavailability or data loss.
# Generate the login hash used to authenticate the user. The username # and password are hard coded here to illustrate the requirements for the string. # The user name and password must be joined with an underscore. my $auth_data = "username_password"; my $sha256_hash = sha256_hex( $auth_data ); # Create a user agent for sending https requests and generate a request object. $user_agent = LWP::UserAgent->new( ); $url = 'https://IP-address/api/login/' .
$request->header('dataType' => 'ipa' ); $response = $user_agent->request( $request ); print $response->content; Alternatively, the dataType in the request header can be set to json for JSON output, or to console for standard CLI text output. Do not use the console output should for parsing. However, the console output can be useful for tabular reports that are obtained directly from the CLI commands.
Using JSON API output The simplest mechanism to handle JSON output is by using either a JavaScript or a Python parser to interpret the data. The JSON output is organized according to the basetypes defined for the system. All basetype objects are returned in an array. The JSON object uses the same name for the key as the XML API uses in the name attribute. Objects can also be embedded inside of other objects are always presented as an array as well.
2017-07-20 11:38:26 1500550706 The following example shows the API status object, using the json output option: "status":[ { "object-name":"status", "response-type":"Success", "response-type-numeric":0, "response":"Command completed successfully.
"time-stamp-numeric":1501151266 } ] } XML API optimization For the XML API only, the following are two ways to optimize performance: ● Use embedded objects. This allows one object to contain not only properties but also other objects. In general, parsing a structure such as this is easier as the association between objects is simpler. This is an alternative to using COMP elements. ● Use brief mode. In brief mode, which is disabled by default, returns a subset of attributes of object properties.
Parameters can be entered in any order. However, for a parameter with no keyword, if you want to specify a value that is partially or entirely the same as the keyword of an optional parameter, you must specify the optional parameter before the value. For example, to create a user named base you must specify the optional base parameter before the name base: create user base 2 base Specifying drawers In an enclosure with drawers: ● Disk drawers are specified by enclosure ID and drawer number.
Specifying ports Controller module host ports are specified by port number only (to use the same port in both controllers) or by controller ID and port number (to specify a port in one controller). In a 2U12 or 2U24 enclosure, the top controller module ID is A and the bottom controller module ID is B. In a 5U84 enclosure, the left controller module ID is A and the right controller module ID is B. Controller module IDs are not case sensitive. Port IDs increment from 0 in each controller module.
few letters to uniquely identify a keyword, pressing Tab or Ctrl+i will list commands or keywords that match the entered string and redisplays the string so you can complete it. When scripting commands, type commands in full to aid readability. The history contains commands entered in the active CLI session. You can recall a command from the history, edit it, and run it. Table 2.
Event log A controller enclosure’s event log records all events that have occurred in or been detected by the controller modules and encompasses all field-replaceable units (FRUs) in the storage system. Each event has one of the following levels, in decreasing severity: ● 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. ● Warning.
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.
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • create vdisk 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
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 26 restore defaults resume replication-set rollback volume scrub disk-groups scrub vdisk scrub volume send support-assist-logs set advanced-settings set chap-record set cli-parameters set cloud-iq set controller-date set debug-log-parameters set disk set disk-group set disk-parameters set dns-management-hostname set dns-parameters set email-parameters set enclosure set expander-fault-isolation s
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show show cache-parameters certificate chap-records cli-parameters cloud-iq configuration controller-date controllers controller
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • show snapshot-space show snapshots show snmp-parameters show support-assist show syslog-parameters 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 v
abort replication Description Aborts the current replication operation for the specified replication set. This command applies to virtual storage only. This command must be run on the replication set of the primary system. For the command to succeed, the replication set state must be either Running or Suspended. Attempting to abort replication for a replication set whose state is either Ready or Unsynchronized fails with an error message.
Examples Abort scrubbing disk group dg1 # abort scrub disk-group dg1 Abort scrubbing linear disk group vd1. # abort scrub vdisk vd1 # abort scrub volume vol1 scrub disk-groups scrub vdisk See also scrub disk-groups 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.
● All disks in a disk group must be the same type (enterprise SAS, for example). All disks in a 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. For consistent and predictable performance, do not mix disks of different sector size types (512n, 512e). For virtual storage, a disk group of midline SAS disks will be used in the Archive tier.
load-balance groups between controller modules, use auto or omit this parameter. In Single Controller mode, this parameter is ignored; the system automatically load-balances groups in anticipation of the insertion of a second controller in the future. chunk-size 64k|128k|256k|512k Optional for linear storage. Prohibited for virtual storage. Prohibited for ADAPT.
pool a|b Required for a virtual or read-cache disk group. Prohibited for a linear disk group. Specifies the name of the virtual pool to contain the disk group. If the pool does not already exist, it will be created. spare disks Optional for a linear disk group. Prohibited for a virtual or read-cache disk group. Prohibited for ADAPT. Specifies the IDs of 1-4 dedicated spares to assign to a RAID 1, 3, 5, 6, 10, or 50 disk group. For disk syntax, see Command syntax on page 17.
host-group Parameters hosts hosts A comma-separated list of the names of hosts to add to the specified host group. A name that includes a space must be enclosed in double quotes. Examples Add existing hosts Host3 and Host4 to existing host group HostGroup1. # add host-group-members hosts Host3,Host4 HostGroup1 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.
[controller a|b] ip-address IP-address [prefix-length value] Parameters address-label name Optional. Lets you specify a name for how the address is used. 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. ● If this parameter is specified, each interface needs a unique name withinthe scope of each controller.
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). To add disks to a disk group to expand its capacity, use the expand disk-group on page 79 command. Minimum role manage Syntax add spares [disk-group disk-group] [vdisk vdisk] disks Parameters disk-group disk-group Optional.
[preview] Parameters enclosure enclosure-IDs Optional. Limits provisioning to a specified enclosure. If this parameter is omitted, the command uses disks from all enclosures. preview Optional. Toggles between adding storage and displaying a possible storage configuration. Examples Add storage to the system. # add storage Add storage to a single enclosure. # add storage enclosure 3 Preview a storage configuration which could be added.
Examples Add existing volumes Vol0002 and Vol0003 to existing volume group VolumeGroup1. # add volume-group-members volumes Vol0002,Vol0003 VolumeGroup1 See also create volume-group remove volume-group-members show volume-groups show volumes 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.
One or more temperature sensors indicate a critical temperature. Code load failure At least one controller contains unwritten cache data. Data corruption, data loss One or more supercapacitors have failed. Code load failure One or more power supplies are not functioning. Code load failure One or more fans are not functioning. Code load failure One or vdisks are in a quarantied state.
data is not needed it can be cleared, in which case it will be lost and data will differ between the host and disk. Unwritable cache is also called orphan data. CAUTION: Only use this command when all disk groups are online and accessible from the host. Clearing cache for a volume that is offline or quarantined could result in data loss. You can clear unwritable cache data for a specified volume or for all volumes Minimum role manage Syntax clear cache [volume volume] Parameters volume volume Optional.
Parameters disks The IDs of the leftover disks from which to clear metadata. For disk syntax, see Command syntax. Examples Clear metadata from leftover disk 1.1. # clear disk-metadata 1.1 See also show disks clear dns-parameters Description Clears configured DNS settings for each controller module. Minimum role manage Syntax clear dns-parameters [controller a|b|both] Parameters controller a|b|both Optional. Specifies whether to change controller A, B, or both.
NOTE: If a rescan is in progress, the clear operation will fail with an error message saying that an EMP does exist. Wait for the rescan to complete and then retry the clear operation. Minimum role manage Syntax clear expander-status [enclosure ID] Parameters [enclosure ID] Optional. The enclosure number. If this parameter is omitted, the command clears the counters and status of all enclosures. Examples Clear the expander status for the enclosure with ID 1.
Syntax clear fenced-data [disk-group disk-group] [vdisk vdisk] Parameters disk-group disk-group Optional. The name or serial number of a virtual disk group. A value that includes a space must be enclosed in double quotes. vdisk vdisk Optional. The name or serial number of a linear disk group. A name that includes a space must be enclosed in double quotes. Examples Clear fenced data for disk group ar5.
set support-assist-info on page 153 show support-assist on page 245 copy volume Description Copies all data in a specified source volume to a destination volume. The source volume can be a virtual base volume or a virtual snapshot. The destination volume will be completely independent of the source volume and will have a different serial number.
A ● ● ● ● name for the volume to create in the destination pool. 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. source-volume-ID The name or serial number of the source volume to copy. A name that includes a space must be enclosed in double quotes. Examples Copy volume SourceVol in pool A to new volume DestVol in pool B.
restore Optional. The system-generated certificate is restored and the custom certificate is discarded. The custom certificate may have been created with this CLI command or uploaded using SFTP or FTP. You must specify either this parameter or the contents parameter or the unique parameter. unique Optional. A security certificate is generated based on the system's serial number and other standard values. This certificate is installed, and the original certificate is archived.
The secret that the recipient uses to authenticate the originator. The secret is case sensitive and can include 12–16 bytes. The value can include spaces and printable UTF-8 characters except: " < mutual-name recipient-name Optional; for mutual CHAP only. The recipient name, typically in IQN format. The name is case sensitive and can have a maximum of 223 bytes, including 0–9, lowercase a–z, hyphen, colon, and period.
● ● ● ● Examples 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. Create host Host1 that includes two FC initiators # create host initiators 10000090fa13870e,10000090fa13870f Host1 Create host Host2 that includes two iSCSI initiators. # create host initiators iqn.1992-01.com.example:storage.host2.port1, iqn.1992-01.com.example:storage.host2.
create peer-connection Description Creates a peer connection between two storage systems. The peer connection is defined by the ports that connect the two peer systems, and the name of the peer connection. The local system uses the remote address to internally run the query peerconnection command. The results of the query are used to configure the peer connection. The prerequisites to create a peer connection are: ● Both systems must have iSCSI or FC host ports.
# create peer-connection remote-port-address 192.168.200.22 remoteusername John remote-password P@ssw0rd Peer1 On a storage system that will replicate using FC to a second system, create peer connection Peer2 to remote port address 247000c0ff1a45b8, using the credentials of remote user Admin1.
● The snapshots are named basename_nnnn, where nnnn starts at 0000 and increments for each subsequent snapshot. If primary-volume snapshots are enabled, snapshots with the same name will exist on the primary and secondary systems. The snapshot number is incremented each time that a replication is requested, whether the replication completes. For example, if the replication was queued and removed later from the queue. ● You can set the number of snapshots to retain, referred to as the snapshot count.
● discard: Discard the new replication request. ● queue-latest: Take a snapshot of the primary volume and queue the new replication request. If the queue contained an older replication request, discard that older request. A maximum of one replication can be queued. This is the default. NOTE: If the queue policy is queue-latest and a replication is running and another is queued, you cannot change the queue policy to discard. The queued replication must be manually removed before you can change the policy.
● ● ● ● Examples 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. Create replication set RS1 for primary volume Vol1 on the peer connection Peer1. # create replication-set peer-connection Peer1 primary-volume Vol1 RS1 Create replication set RS1 for volume group VG1.* on the peer connection Peer1.
● [between hh:mm[AM|PM] and hh:mm[AM|PM]] Constrains the time range during which the task is permitted to run. Ensure that the start time is within the specified time range. ● [only any|first|second|third|fourth|fifth|last|#st|#nd|#rd|#th day| weekday|weekendday| Sunday|Monday|Tuesday|Wednesday|Thursday|Friday| Saturday of year|month|January|February| March|April|May|June|July| August|September|October|November|December] Constrains the days or months when the task is permitted to run.
A comma-separated list of the names or serial numbers of 1 to 16 source volumes of which to create snapshots. A name that includes a space must be enclosed in double quotes. snap-names A comma-separated list of names for the resulting snapshots. Snapshot names must be unique system-wide. 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 doubl
To create a task to replicate a virtual volume: create task [last-snapshot] replication-set replication-set-ID type Replicate name To create a task to enable spin down: create task type EnableDSD name To create a task to disable spin down: create task type DisableDSD name Parameters last-snapshot Optional. For a Replicate task this specifies to replicate the most recent snapshot of the primary volume.
● 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. Examples Create task Snap that creates a snapshot of volume VD1_V1 and retains only the latest four snapshots with the prefix VD1_V1 (for example, VD1_V1_S0001). # create task type TakeSnapshot source-volume VD1_V1 snapshot-prefix VD1_V1 retention-count 4 Snap Create task Reset that resets snapshot VD1_V1_S0001.
[storage-size-units auto|MB|GB|TB] [temperature-scale celsius|c|fahrenheit|f] [timeout #] [trap-host address] [type novice|standard|advanced|diagnostic] [units auto|MB|GB|TB] name Parameters authentication-type MD5|SHA|none Optional. For an SNMPv3 user, this specifies whether to use a security authentication protocol. Authentication uses the user password. ● MD5: MD5 authentication. This is the default. ● SHA: SHA-1 authentication. ● none: No authentication. base 2|10 Optional.
Optional. Sets the number of decimal places (1–10) for display of storage-space sizes. privacy-password encryption-password Optional. For an SNMPv3 user whose privacy-type parameter is set to use encryption, this specifies the encryption password. Input rules: ● The value is case-sensitive. ● The value can have 8 to 32 characters. ● The value can include spaces and printable UTF-8 characters except: " , . < \ ● A value that includes only printable ASCII characters must include at least one uppercase charact
● TB: Sizes are shown in TB. Based on the precision setting, if a size is too small to meaningfully display in the selected unit, the system uses a smaller unit for that size. For example, if units is set to TB, precision is set to 1, and base is set to 10, the size 0.11709 TB is instead shown as 117.1 GB. name A ● ● ● Examples name for the new user, which cannot already exist in the system. Input rules: The value is case-sensitive. The value can have 29 bytes.
[assigned-to a|b|auto] [chunk-size 64k|128k|256k|512k] disks disks level nraid|raid0|r0|raid1|r1|raid3|r3|raid5|r5|raid6|r6|raid10|r10 |raid50|r50 [mode online|offline] [spare disks] name Parameters assigned-to a|b|auto Optional. For a system operating in Active-Active ULP mode, this specifies the controller to own the disk group. To let the system automatically load-balance vdisks between controllers, use auto or omit this parameter.
set vdisk on page 161 show disks on page 184 show vdisks on page 259 create volume Description Creates a volume in a linear disk group or virtual pool. You must specify a size for the volume. You can create the volume unmapped or set its default mapping. Default mapping settings apply to all hosts, unless overridden by an explicit mapping between a host and the volume. You can later change the mapping by using the map volume and unmap volume commands.
● enabled or on: Optimized page allocation is enabled. lun LUN Optional if the access parameter is set to no-access. Specifies the LUN to assign to the mapping on all ports. pool pool Optional for linear volumes. Required for virtual volumes. The name or serial number of the pool in which to create the volume. ports ports Optional. The ports through which the host can access the volume. All specified ports must be the same type (FC, for example). For port syntax, see Command syntax.
Optional; required for linear volumes. The name or serial number of the linear disk group in which to create the volume. A name that includes a space must be enclosed in double quotes. volume-group volume-group Optional. The name of a volume group to which to add the volume. A name that includes a space must be enclosed in double quotes. If the group does not exist, it will be created. name A ● ● ● ● Examples name for the new volume. The name must be unique system-wide.
The name of an existing volume group. ● 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. Examples Create a volume group named VGroup1 that includes hosts Vol0001 and Vol0002.
[volume-group volume-group] Parameters 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 no-access is specified, the volume is not mapped. The default is read-write. baselun base-LUN Optional. The first in a sequence of LUNs to assign to map the volumes through ports specified by the ports parameter. If the baselun and ports parameters are omitted, the volumes are not mapped.
exceeds the high threshold value, the host loses read and write access to the pool volumes. The only way to regain read and write access to the pool volumes is to add more storage to the pool. snapshot-retention-priority never-delete|high|medium|low Optional. For virtual storage, this specifies the retention priority for snapshots of the volume set. ● never-delete: Snapshots will never be deleted.
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. CAUTION: When the snapshots are deleted, all data in those snapshots will be lost.
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 chap-records all See also create chap-record set chap-record show chap-records show iscsi-parameters delete host-groups Description Deletes specified host groups and optionally all hosts in those groups.
Syntax delete hosts hosts|all Parameters hosts|all Specifies either: ● 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. Examples Delete hosts Host1 and Host2. # delete hosts Host1,Host2 Delete all hosts.
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.
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. # delete pools A Delete linear pool dg1.
that replication set. To view replication activity, use the show replication-sets command. To suspend replication, use the suspend replication-set command. To abort replication, use the abort replication command. This command has a confirmation prompt in interactive console mode. Minimum role manage Syntax delete replication-set [local-only] replication-set-ID Parameters local-only Optional.
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. CAUTION: When a snapshot is deleted, all data in the snapshot will be lost.
# 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.
● 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. # delete vdisks VD1,VD2 See also create vdisk show vdisks delete volume-groups Description Deletes specified volume groups and optionally all volumes in those groups.
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.
status becomes FTOL (fault tolerant and online), or if after 60 seconds the disk group status is QTCR or QTDN. ● 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.
Syntax dequarantine disk-group disk-group 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.
ADAPT will use whatever space is available. The new disks must also be in the same tier as the disk group. NOTE: If you upgraded from an earlier release that did not distinguish between enterprise and midline SAS disks, you might have disk groups that contain both types of disks. For those groups, you can designate either or both types of disks for expansion.
The IDs of the disks to add. For disk syntax, see Command syntax on page 17. 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. 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.
RAID level Expansion capability Maximum disks contain the same number of disks as each original subgroup ADAPT Can add up to 68 disks at a time 128 When disks are added to an ADAPT disk group, the system will first replenish any spare capacity needed to be fully fault-tolerant, then use the remainder or expansion of user data capacity. ● 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.
expand volume Description Expands a standard or base volume. Volume sizes are aligned to 4.2 MB (4 MiB) boundaries. When a volume is created or expanded, if the resulting size would be less than 4.2 MB it will be increased to 4 MB; if the resulting size would be greater than 4.2 MB it will be decreased to the nearest 4.2 MB boundary. For virtual storage, if overcommit is disabled, expansion is restricted to the space available in the pool that contains the volume.
NOTE: Failing a controller module will reduce system redundancy and performance, and increase risk of data unavailability due to the reduced redundancy. If you are uncertain whether to use this command, contact technical support for assistance. Minimum role manage Syntax fail controller a|b Parameters controller a|b Specifies whether to kill controller A or B. You cannot kill the controller on which the command is issued. Examples From controller A, fail controller B.
CAUTION: Using a default mapping for a volume will allow multiple hosts to access the volume. To avoid multiple hosts mounting the volume and causing corruption, the hosts must be cooperatively managed, such as by using cluster software. NOTE: ● You cannot map a replication set’s secondary volume. Create a snapshot of the secondary volume or enable replication snapshot history and use the snapshot for mapping and accessing data.
# map volume vol2,vol3 access rw ports a1,b1 lun 101 initiator Init2 Mask volume vol4 from Init1 and Init3. # map volume vol4 access no-access initiator Init1,Init3 Map volumes vol1 and vol2 to initiators Init1 and Init2, using ports A1 and B1 starting with LUN 6, and view the results. # map volume vol1,vol2 ports a1,b1 lun 6 initiator Init1,Init2 Map volume group volGroupA to host group hostGroupA, starting with LUN 1 on ports A0 and B0. # map volume volGroupA.* initiator hostGroupA.*.
Optional. The number of packets to send. The default is 4 packets. Use a small count because the command cannot be interrupted. The default is 4 packets. Examples Send two packets to the remote computer at 10.134.50.6. # ping 10.134.50.6 count 2 query peer-connection Description Queries a storage system to potentially use in a peer connection and shows information about the storage system via the in-band query. The system uses this information to determine how to set up the peer connection.
● Unknown Port Address The assigned port address. Reachable Local Links The IDs of ports in the local system linked to ports in the remote system. Examples Query the system with an IP address of 192.168.200.22. # query peer-connection 192.168.200.22 Basetypes peer-connection-info status See also create peer-connection delete peer-connection set peer-connection show peer-connections recover replication-set Description Provides options to recover a replication set after a disaster.
The name or serial number of the replication set. A name that includes a space must be enclosed in double quotes. Examples Assume that a disaster took the primary system for replication set RS1 offline. To move RS1 into "failed over" state and make its secondary volume accessible, you ran the following command: # recover replication-set operation failover RS1 You then mapped the secondary volume and updates to its data started.
remove disk-groups Description Removes specified disk groups. CAUTION: ● If your system gets into a state where a virtual disk group is quarantined or offline or does not have a corresponding pool, contact technical support. ● Deleting a linear disk group will delete all data it contains. If a specified disk group has a job running, such as media scrub, the command will prompt for confirmation to stop the job.
See also delete pools delete vdisks show disk-groups show vdisks remove host-group-members Description Removes specified hosts from a host group. You cannot remove all hosts from a group. At least one host must remain. The hosts are ungrouped but not deleted. This command has a confirmation prompt in interactive console mode. Minimum role manage Syntax remove host-group-members hosts hosts host-group Parameters hosts hosts A comma-separated list of the names of hosts to remove from the host group.
See also delete hosts show initiators remove ipv6-address Description Removes a static IPv6 address from a controller network port. NOTE: When the set ipv6-network-parameters command's autoconfig parameter is disabled, you cannot remove the last IPv6 address.
Syntax remove spares disks Parameters disksThe IDs of the spares to remove. For disk syntax, see Command syntax. Examples Remove dedicated spare 1.21 and global spare 1.22. # remove spares 1.21-22 Remove global spare 1.22. # remove spares 1.22 See also addd spares show disks remove volume-group-members Description Removes volumes from a volume group. You cannot remove all volumes from a group. At least one volume must remain. The volumes are ungrouped but not deleted.
has not succeeded after six attempts using the 10-minute interval, it will switch to trying to resume if it has been over an hour since the last attempt and the peer connection is healthy. Minimum role manage Syntax replicate [last-snapshot] [snapshot snapshot-ID] replication-set-ID Parameters last-snapshot Optional. Specifies to replicate the most recent snapshot of the primary volume, instead of the base volume. You cannot specify both this parameter and the snapshot parameter.
# rescan reset all-statistics Description Resets performance statistics for both controllers. You can specify either to reset all live statistics to zero, or to reset (clear) all historical performance statistics for all disks. If you reset historical statistics, an event will be logged and new data samples will continue to be stored every fifteen minutes. Minimum role manage Syntax reset all-statistics [historical] [prompt yes|no] Parameters historicalOptional.
Syntax reset controller-statistics [a|b|both] Parameters a|b|both Optional. Specifies whether to reset statistics for controller A, B, or both. If this parameter is omitted, statistics are reset for both controllers. Examples Reset statistics for both controllers.
reset host-port-statistics reset pool-statistics reset vdisks-statistics reset volume-statistics show disk-statisticsshow disks reset disk-group-statistics Description Clears resettable performance statistics for specified disk groups, and resets timestamps for those statistics. This command behaves the same as the reset vdisks-statistics command. Minimum role manage Syntax reset disk-group-statistics disk-groups Parameters disk-groups Optional.
reset disk-error-statistics reset controller-statistics reset disk-group-statistics reset host-port-statistics reset pool-statistics reset vdisks-statistics reset volume-statistics show disk-statistics reset dns-management-hostname Description Resets each controller module's management host name to the factory default. The factory default is: .
A controller host port ID, a comma-separated list of IDs, a hyphenated range of IDs, or a combination of these. A port ID is a controller ID and port number, and is not case sensitive. Do not mix controller IDs in a range. Examples Reset the host link on port A1. # reset host-link ports A1 See also show ports reset host-port-statistics Description Resets performance statistics for controller host ports.
# reset pool-statistics A See also reset all-statistics reset disk-error-statistics reset controller-statistics reset disk-group-statistics reset host-port-statistics reset pool-statistics reset vdisks-statistics reset volume-statistics reset disk-statistics show pool-statistics show pools reset smis-configuration Description Resets the SMI-S configuration files. NOTE: This command is for use by or with direction from a service technician.
reset snapshot Description Replaces the data in a standard snapshot with the current data from its parent volume. The snapshot’s volume characteristics are not changed. Any snapshot in a snapshot tree can be reset, but the data source can only be the snapshot's immediate parent. For example, in the following snapshot tree:Vol1 |- Vol1Snap |- Vol1SnapSnap you can reset Vol1Snap to Vol1, or reset Vol1SnapSnap to Vol1Snap.
reset controller-statistics reset disk-group-statistics reset host-port-statistics reset pool-statistics reset vdisks-statistics reset volume-statistics reset disk-statistics show vdisk-statistics show vdisks reset volume-statistics Description Resets performance statistics for all or specified volumes. Minimum role manage Syntax reset volume-statistics [volumes] Parameters volumes Optional. A comma-separated list of the names or serial numbers of the volumes for which to reset statistics.
[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. Output Messages are displayed when the controller shut down, when failover is initiated, and when the controller has restarted.
Examples From controller A, restart the Storage Controller in controller B. # restart sc b Restart both Storage Controllers. # restart sc both See also restart mc shutdown restore defaults Description Restores the default configuration on the controllers. CAUTION: This command is for use only with the direction from a service technician. For details about which settings are restored, see Settings changed by restore defaults on page 437.
replication-set-ID Parameters replication-set-ID The name or serial number of the replication set for which to resume the replication. Examples Resume replications in replication set RS1. # resume replication-set RS1 See also create replication-set delete replication-set set replication-set show replication-sets suspend replication-set rollback volume Description Replaces the data in a parent volume with the data from one of its snapshots.
volumeThe name or serial number of the volume to roll back. A name that includes a space must be enclosed in double quotes. Examples Roll back volume Vol1 from snapshot Vol1Snap. # rollback volume snapshot Vol1Snap Vol1 See also show snapshots show volumes scrub disk-groups Description Analyzes specified disk groups to find and fix errors. This command acts on disks in a disk group but not dedicated spares or leftover disks.
Minimum role manage Syntax scrub vdisk vdisks Parameters vdisksA comma-separated list of the names or serial numbers of the linear disk groups to scrub. A name that includes a space must be enclosed in double quotes Examples Start scrubbing linear disk group vd1. # scrub vdisk vd1 See also set advanced-settings show vdisks abort scrub (with the vdisk parameter) scrub volume Description Analyzes specified volumes to find and fix disk errors. This command applies to linear storage only.
Data collected and sent includes: ● ● ● ● Current configuration state of the storage system XML API dump of the system Event log Full debug log Data for both controllers is sent in a single zip file. Minimum role monitor Syntax send support-assist-logs Examples Send storage-system log files to the SupportAssist server.
[super-cap-failure enabled|disabled|on|off] [sync-cache-mode immediate|flush] [temperature-exceeded enabled|disabled|on|off] [utility-priority low|medium|high] Parameters auto-stall-recovery enabled|disabled|on|off Optional. Detects situations where a controller stall is preventing I/O operations from completing, and recovers the system so that at least one controller is operational, thus avoiding data-unavailability situations. This feature focuses on failover/recovery stalls.
disk, automatically designates it a spare, and starts reconstructing the disk group. A compatible disk has enough capacity to replace the failed disk and is the same type. If a spare or available compatible disk is already present, the dynamic spares feature uses that disk to start the reconstruction and the replacement disk can be used for another purpose. ● disabled or off: The dynamic spares feature is disabled. This is the default. ● enabled or on: The dynamic spares feature is enabled.
● illegal: Sends a reply that there is a LUN but that the request is “illegal.” Sense data returned is sensekey = 5, code = 25h, qualifier = 0. If the system is used in a VMware environment, use this option. partner-firmware-upgrade enabled|disabled|on|off Optional. Sets whether component firmware versions are monitored and will be automatically updated on the partner controller. ● disabled or off: Partner firmware upgrade is disabled. ● enabled or on: Partner firmware upgrade is enabled.
NOTE: Drive spin down is not applicable to ADAPT disk groups or virtual pools. spin-down-delay delay Optional. Sets the period of inactivity after which spinning disks that are available or are global spares will spin down. Setting the delay to 1–360 minutes will enable spin down. Setting the delay to 0 will disable spin down. The default is 15 minutes. NOTE: Drive spin down is not applicable to ADAPT disk groups or virtual pools. super-cap-failure enabled|disabled|on|off Optional.
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.
set cloud-iq 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.
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. Disabled by default.
set disk Description Performs a secure erase on a specified disk. This is called repurposing the disk, and only applies to an FDE-capable 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.
[name new-name] [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.
● Disks equipped with SMART technology can alert the controller of impending disk failure. When SMART is enabled, the system checks for SMART events one minute after a restart and every five minutes thereafter. SMART events are recorded in the event log. Changes to the SMART setting take effect after a rescan or a controller restart. ● For spinning disks, the drive spin down feature monitors disk activity within system enclosures and spins down inactive disks, based on user-specified settings.
Parameters controller a|b Optional. Specifies whether to change controller A or B, only. If this parameter is omitted, changes affect the controller being accessed. name hostname A ● ● ● ● ● Examples host name to use for a controller. 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.
search-domains domain-name-list 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.
[include-logs disabled|on|off] 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.
show dns-parameters 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.
By default, the Expander Controller in each I/O module performs fault-isolation analysis of SAS expander PHY statistics. When one or more error counters for a specific PHY exceed the built-in thresholds, the PHY is disabled to maintain storage system operation. 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.
phy phy-ID type drive|inter-exp|sc|sc-0|sc-1|sc-p|sc-a|sca-p|scb-p|sca-a|scb-a| ingress |expander-ingress-0|expander-ingress-1|egress|expander-egress-0| expander-egress-1| drawer0-egress|drawer1-egress|drawer2-egress |drawer0-ingress|drawer1-ingress|drawer2-ingress|drawer0-ingress-0| drawer0-ingress-1| drawer0-ingress-2|drawer0-egress-0|drawer0-egress-1| drawer0-egress-2|drawer1-ingress-0| drawer1-ingress-1|drawer1-ingress-2| drawer1-egress-0|drawer1-egress-1|drawer1-egress-2| drawer2-ingress-0| drawer2-ing
● drawer1-egress: Drawer 1 egress PHY ● drawer2-egress: Drawer 2 egress PHY ● drawer0-ingress: Drawer 0 ingress PHY ● 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 ● drawe
Optional. Suppresses confirmation prompts. Specifying this parameter allows the command to proceed without user interaction. passphrase value A ● ● ● customer-supplied password associated with securing the system. Input rules: 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.
● The value can include printable UTF-8 characters except: , < > \ (Any double-quote characters in the passphrase are automatically removed.) Examples Set a lock key in preparation for securing the system using FDE. # set fde-lock-key passphrase "Customer lock--01/10/2014" See also clear fde-keys 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.
Minimum role manage Syntax set host [name new-name] [profile standard] host-name Parameters [name new-name] 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.
set host-parameters Description Sets controller host-port parameters for communication with attached hosts. Host ports can be configured as FC or iSCSI ports. FC ports support use of qualified 16-Gbit/s SFPs. You can set FC ports to auto-negotiate the link speed or to use a specific link speed. iSCSI ports support use of qualified 10-Gbit/s SFPs. iSCSI port speeds are auto-negotiated. 10GbE iSCSI host ports support use of qualified Direct Attach Copper (DAC) cables. iSCSI port speeds are autonegotiated.
that specific IDs be assigned to recognize the controller. If the loop ID is changed for one port, the same ID is used for other ports in the same controller. If the ports parameter is specified, loop IDs are set based on the controllers that the ports are in. You cannot specify the same value for ports on different controllers. ● soft or 255: Soft target addressing enables the LIP to determine the loop ID. Use this setting if the loop ID is permitted to change after a LIP or power cycle.
# set host-parameters speed auto ports a1,b1 noprompt On a system with iSCSI ports using IPv4 addressing, change the IP address of port A3. # set host-parameters ip 10.134.50.6 ports a3 On a system with iSCSI ports, specify to use IPv6 addressing and change the IP address and default router for port A1.
set initiator Description Sets the name of an initiator and optionally its profile. Minimum role manage Syntax set initiator id initiator [nickname name] [profile standard] Parameters id initiator The ID of the initiator.For FC, the ID is a WWPN. 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.
Optional. ● enabled or on: Specifies whether to use an automated method (either DHCPv6 or SLAAC, as defined by the network configuration) to automatically configure the address. This provides a single IPv6 address. If a DHCPv6 address is available, DHCPv6 will provide the interface address. If DHCPv6 cannot provide an address, the SLAAC address will be the single interface address. This is the default. ● disabled or off: Specifies whether to use manual mode.
When CHAP is enabled and the storage system is the recipient of a login request from a known originator (initiator), the system will request a known secret. If the originator supplies the secret, the connection will be allowed [iscsi-ip-version ipv4|ipv6] Optional. Specifies whether to use IP version 4 (IPv4) or 6 (IPv6) for addressing controller iSCSI ports.
disk ID enable|disable|on|off To set the LEDs for an enclosure and its I/O modules: set led [controller a|b] enable|disable|on|off enclosure ID Parameters [controller a|b] Optional; for use with the enclosure parameter. Specifies the I/O module to locate. This affects the identification LED on the I/O module and on the enclosure. disk ID Specifies the disk to locate. For disk syntax, see Command syntax. This overrides the fault LED on the disk. enable|disable|on|off Specifies to turn the LED on or off.
169.254.x.x addresses (including gateway 169.254.0.1) are on a private subnet that is reserved for unconfigured systems and the addresses are not routable. This prevents the DHCP server from reassigning the addresses and possibly causing a conflict where two controllers have the same IP address. As soon as possible, change these IP values to proper values for your network To switch a controller from DHCP addressing to static addressing, you must set the IP address, netmask, and gateway values.
set ntp-parameters Description Sets Network Time Protocol (NTP) parameters for the system. You can manually set system date and time parameters by using the set controller-date command. You must specify at least one of the optional parameters for the command to succeed.
● The value can have 8-32 characters. ● The value can include spaces and printable UTF-8 characters except: " , . < \ ● A value that includes only printable ASCII characters must include at least one uppercase character, one lowercase character, one numeric character, and one non-alphanumeric character. If this parameter is omitted, the command prompts you to enter and re-enter a value, which is displayed obscured for security reasons.
● A value that includes a space must be enclosed in double quotes. [remote-password password] Optional in console format; required for API format. The password of the user specified by the remote-username parameter. If this parameter is omitted, the command prompts you to enter and re-enter a value, which is displayed obscured for security reasons. [remote-port-address remote-port-address] Optional. Specifies a new FC WWN or iSCSI IP address for the remote system. IPv4 and IPv6 formats are supported.
reaches or exceeds the high threshold value. If the host is rebooted after the pool reaches or exceeds the high threshold value, the host loses read and write access to the pool volumes. The only way to regain read and write access to the pool volumes is to add more storage to the pool. If your system has a replication set, the pool might be unexpectedly overcommitted because of the size of the internal snapshots of the replication set.
Parameters prompt The new prompt. Input rules: ● The value is case sensitive. ● The value can have a maximum of 16 characters. ● The value can include spaces and printable UTF-8 characters except: " , . < \ ● A value that includes a space must be enclosed in double quotes. Examples Change the prompt from "# " to "CLI$ " and start entering a show command. # set prompt "CLI$ " Success: Command completed successfully. (2014-07-17 16:44:25) CLI$ show ...
Optional. Enables or disables File Transfer Protocol (FTP), a secondary interface for installing firmware updates, installing security certificates and keys and downloading logs. This is disabled by default. [http enabled|disabled|on|off] Optional. Enables or disables the standard PowerVault Manager web server. This is disabled by default. [https enabled|disabled|on|off] Optional. Enables or disables the secure PowerVault Manager web server. This is enabled by default.
[telnet enabled|disabled|on|off] Optional. Enables or disables the standard CLI. This is disabled by default. [usmis enabled|disabled|on|off] Optional. Enables or disables the unsecure Storage Management Initiative Specification (SMI-S) interface. This option allows SMI-S clients to communicate with each controller's embedded SMI-S provider via HTTP port 5988. HTTP port 5988 and HTTPS port 5989 cannot be enabled at the same time, so enabling this option will disable port 5989. This is disabled by default.
● A value that includes a space must be enclosed in double quotes. If you change this parameter while a replication is running, the replication set will be immediately renamed but the current replication will not be affected. [queue-policy discard|queue-latest] Optional. Specifies the action to take when a replication is running and a new replication is requested. ● discard: Discard the new replication request. ● queue-latest: Take a snapshot of the primary volume and queue the new replication request.
● never-delete: Snapshots will never be deleted automatically to make space. The oldest snapshot in the snapshot history will be deleted once the snapshot-count value has been exceeded. This is the default ● high: Snapshots can be deleted after all eligible medium-priority snapshots have been deleted. ● medium: Snapshots can be deleted after all eligible low-priority snapshots have been deleted. ● low: Snapshots can be deleted.
Specifies a date and a time in the future to be the first instance when the scheduled task will run, and to be the starting point for any specified recurrence. ● [every # minutes|hours|days|weeks|months|years] Specifies the interval at which the task will run. For better performance when scheduling a TakeSnapshot task that will run under heavy I/O conditions or on more than three volumes, the retention count and the schedule interval should be set to similar values.
The system generates events when the percentage of snapshot space used crosses low, middle, or high thresholds. The event is generated when the percentage exceeds or drops below the threshold. You can set the percentages for the thresholds.
Minimum role manage Syntax set snmp-parameters [add-trap-host address] [del-trap-host address] [enable crit|error|warn|resolved|info|none] [read-community string] [trap-host-list addresses] [write-community string] Parameters [add-trap-host address] Optional. Specifies the network address of a destination host that will receive traps. The value can be an IPv4 address, IPv6 address, or FQDN. Three trap hosts can be set. [del-trap-host address] Optional.
show snmp-parameters test (with the snmp parameter) set support-assist Description Sets parameters for the SupportAssist feature. When you specify to enable this feature, the CLI will present an agreement with a confirmation prompt. The agreement allows remote monitoring of the storage system, collection of diagnostic information, and transmission of that data to a remote support server. Reply yes to enable the support service or no to leave it disabled.
show support-assist on page 245 set support-assist-info Description Sets customer information for the SupportAssist feature.
[last-name value] [phone-number value] [preferred-contact-hours-end-time value] [preferred-contact-hours-start-time value] [preferred-contact-method Email|Phone] [preferred-email-language cs|da|de|el|en|es|es-LA|fi|fr|fr-CA|he|it| ja|ko|nl|no|pl|pt|pt-BR| ru|sk|sv|th|tr|zh-CN|zh-TW] [time-zone -12:00|-11:00|-10:00|-09:30|-09:00|-08:00|-07:00|-06:00|-05:00|-04:00| -03:30| -03:00|-02:00|-01:00|-00:00|+01:00|+02:00|+03:00|+03:30|+04:00|+04:30| +05:00|+05:30|+05:45| +06:00|+06:30|+07:00|+08:00|+08:30|+08:45|+09
[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. Specifies the proxy user name to use to access the proxy server. [password proxy-password] Optional. Specifies the proxy password to use to access the proxy host. enabled|disabled|on|off ● enabled or on – Enables the feature. ● disabled or off – Disables the feature. Examples Enable the SupportAssist Proxy feature.
● ● ● ● ● 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. If notification-level is other than none, the host parameter must be specified. Examples Set the system to send an entry to the remote server at 10.1.1.10 on port 514 when a critical event occurs.
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. If you want to change parameters for a ResetSnapshot task or the name, type, or associated volumes for another type of task, create a new task to replace the existing one.
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.
[interfaces interfaces] Optional. Specifies the interfaces that the user can access. Multiple values must be separated by commas and no spaces ● ● ● ● ● ● 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. snmpuser: Allows an SNMPv3 user to view the SNMP MIB. snmptarget: Allows an SNMPv3 user to receive SNMP trap notifications.
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. 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.
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.
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.
● no-affinity: This setting uses the highest available performing tiers first and only uses the Archive tier when space is exhausted in the other tiers. Volume data will swap into higher performing tiers based on frequency of access and tier space availability. This is the default. ● archive: This setting prioritizes the volume data to the least performing tier available. Volume data can move to higher performing tiers based on frequency of access and available space in the tiers.
● 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. While this improves the response time of write I/O, it comes at the cost of redundancy. If this option is used, the user can expect higher write performance but is exposed to data loss if a controller fails. [read-ahead-size disabled|adaptive|stripe|512KB|1MB|2MB|4MB|8MB|16MB| 32MB] Optional.
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. A value that includes a space must be enclosed in double quotes.
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.
● 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: The supercapacitor failure trigger is enabled.
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.
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. ● Active-Active ULP: Both controllers are active using ULP (Unified LUN Presentation).
● 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.
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. The originator name, typically in IQN format. If this parameter is omitted, all CHAP records are shown.
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.
● celsius or c: Temperatures are shown in degrees Celsius. This is the default. 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.
Minimum role monitor Syntax show configuration Output ● System information from show system ● Controller information from show controllers ● Controller firmware and hardware version information from show versions with the detail parameter ● Host and expansion port information from show ports ● Disk information from show disks ● Disk-slot information from show disks with the encl parameter ● Vdisk information from show vdisks ● Disk-group information from show disk-groups ● Pool information from show po
See also set controller-date set ntp-parameters show ntp-status 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.
● SAS Status ● Operational ● Down ● 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.
● Active-Active ULP: Both controllers are active using ULP (Unified LUN Presentation). Data for volumes configured to use write-back cache is automatically mirrored between the two controllers to provide fault tolerance. ● Single Controller: The enclosure contains a single controller. ● Failed Over: Operation has failed over to one controller because its partner is not operational. The system has lost redundancy. ● Down: Both controllers are not operational.
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.
Minimum role monitor Syntax show disk-groups [detail] [pool pool] [disk-groups] Parameters [detail] Optional. This parameter shows additional detail about disk groups. [pool pool] 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.
● Linear: The disk group acts as a linear pool. ● Virtual: The disk group is in a virtual pool. Current Job Completion Shown by the detail parameter. See Job%, below Current Job ● ● ● ● ● ● ● ● ● ● ● ● 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 disk group is being reconstructed.
RAID The RAID level of the disk group. Reason If Health is not OK, this field shows the reason for the health state. Sec Fmt The sector format of disks in the disk group. ● 512n: All disks use 512-byte native sector size. Each logical block and physical block is 512 bytes. ● 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.
Examples Show information about all disk groups. # show disk-groups pool A Show information about disk group dg0002 in pool B. # show disk-groups pool B dg0002 Basetypes disk-groups status See also show disks show pools 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.
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 Average response time in microseconds for read and write operations, calculated over the interval since these statistics were last requested or reset.
● Enabled: SMART is enabled for all disks in the system and will be enabled for new disks added to the system. ● Disabled: SMART is disabled for all disks in the system and will be disabled for new disks added to the system. Drive Write Back Cache ● Disabled: Disk write-back cache is disabled for all disks in the system and will be disabled for new disks added to the system. This value cannot be changed.
Parameters detail Optional. This parameter shows additional detail about the disk. disk-group disk-groups Optional. A comma-separated list of the names or serial numbers of disk groups for which to show disk information. A value that includes a space must be enclosed in double quotes. encl Optional. Shows information about each disk slot, whether it contains a disk or not. You cannot use this parameter with any other parameter. fde Optional.
Disk Group (v3) Shown by default or by the detail parameter. The name of the disk group that contains the disk. Drawer ID Shown by the detail parameter. The ID of the drawer containing the disk. Drive Spin Down Count Shown by the detail parameter. The number of times the DSD feature has spun down this disk. Encl Shown by the encl parameter. The number of the enclosure where the disk is located. FDE State Shown by the detail or fde parameter. The FDE state of the disk: ● Unknown: The FDE state is unknown.
Shown by the detail parameter. The disk LED status: ● Rebuild: The disk's disk group is being reconstructed. ● Fault: The disk has a fault. ● ID: The disk's identification LED is illuminated. ● Remove: The disk is ready to be removed from the enclosure. ● Blank if the disk is not part of a disk group or is spun down. Location Shown by default and by any parameter except encl. The disk location in the format enclosureID.slot-number. Lock Key ID Shown by the fde parameter. The current lock key ID.
Shown by default and by any parameter except fde or temp. The disk capacity, formatted to use the current base, precision, and units. Slot Shown by the encl parameter. The slot number in the enclosure where the disk is located. SMART Shown by the detail parameter. Shows whether SMART (Self-Monitoring Analysis and Reporting Technology) is enabled or disabled for disks. ● Detect-Only: Each disk in the system retains its individual SMART setting, as will new disks added to the system.
○ Standard: The disk is in the storage tier that uses enterprise-class spinning SAS disks (10k/15k RPM, higher capacity). ○ Archive: The disk is in the lowest storage tier, which uses midline spinning SAS disks (<10k RPM, high capacity). ○ Read Cache: The disk is an SSD providing high-speed read cache for a storage pool. Total I/Os Shown by the perf parameter. The total number of I/O operations (reads and writes). Transfer Rate Shown by the detail parameter. The data transfer rate in Gbit/s.
# show disks usage available Basetypes drives enclosure-list status See also show disk-groups show vdisks show disk-statistics Description Shows live or historical performance statistics for disks. For disk performance statistics, the system samples live data every 15 seconds and historical data every quarter hour, and retains historical data for 6 months. The historical option allows you to specify a time range or a number (count) of data samples to include.
Optional. Specifies to show historical statistics. If this parameter is omitted, live statistics will be shown. time-range "date/time-range" Optional. Specifies the date/time range of historical statistics to show, in the format "start yyyy-mm-dd hh:mm [AM| PM] end yyyy-mm-dd hh:mm [AM|PM]". If the start date/time is specified but no end date/time is specified, the current date/time will be used as the end date/time.
Live, error-stats Location The disk location in the format disk_enclosure-ID.slot-number. Serial Number The serial number of the disk. SMART port# The number of SMART events recorded. Time port# The number of timeouts accessing the disk. NResp port# The number of times the disk did not respond. Spin port# The number of attempts by the storage system to spin up the disk. Med port# The number of media errors generated by the disk, as specified by its manufacturer.
Write IOPS Shown by the all parameter. The number of write operations per second since the last sampling time. Total B/s The total data transfer rate, in bytes per second, since the last sampling time. Read B/s Shown by the all parameter. The data transfer rate, in bytes per second, for read operations since the last sampling time. Write B/s Shown by the all parameter. The data transfer rate, in bytes per second, for write operations since the last sampling time. Queue Depth Shown by the all parameter.
# show disk-statistics 1.5 historical all Basetypes disk-statistics (live) drive-summary (historical) status See also reset all-statistics reset disk-error-statistics reset disk-statistics show disk-group-statistics show disks show dns-management-hostname Description Shows the management host name for each controller module. If DNS server functionality is operational and reachable by the nslookup service on the controller, the FQDN for each controller is also shown.
The controller ID: A or B. Name Servers Configured name server IP address values. Search Domains Configured domain name values Examples Show the system’s DNS settings. # show dns-parameters Basetypes controller-dns-parameters dns-parameters status See also clear dns-parameters set dns-parameters set email-parameters show email-parameters show email-parameters Description Shows email (SMTP) notification parameters for events and managed logs.
Email Server The IP address or domain name of the SMTP mail server to use for the email messages. Email Domain The domain name that, with the sender name, forms the “from” address for remote notification. Email Sender The sender name that, with the domain name, forms the “from” address for remote notification. Email Sender Password The sender password.
The enclosure model. EMP controller-ID BUS:ID Rev The channel ID and firmware revision of the Enclosure Management Processor in each controller’s Expander Controller. Midplane Type An abbreviation that describes the enclosure midplane's rack-unit height, maximum number of disks, maximum data rate to disks (Gbit/s), and hardware version. Health ● Show information about all enclosures in the system.
See also set enclosure show sensor-status show events Description Shows events logged by each controller in the storage system. A separate set of event numbers is maintained for each controller. Each event number is prefixed with a letter identifying the controller that logged the event. Events are listed from newest to oldest, based on a timestamp with one-second granularity. Therefore the event log sequence matches the actual event sequence within about one second.
to timestamp Optional. Shows events that occurred on or before a timestamp specified with the format MMDDYYhhmmss. For example, 043011235900 represents April 30 2011 at 11:59:00 p.m. This parameter can be used with the from parameter or the from-event parameter. to-event event-ID Optional. Shows events before and including the specified event ID. If this number is larger than the ID of the oldest event, events are shown up to the latest event.
For each enclosure, this command shows status information for PHYs in I/O module A and then I/O module B Minimum role monitor Syntax show expander-status Output Encl The enclosure that contains the SAS Expander. Drawer Shown in drawer output. The number of the drawer. Expander Shown in drawer output. The number of the Expander. Ctlr The I/O module that contains the SAS Expander. Phy Identifies the logical location of a PHY within a group based on the PHY type.
● ● ● ● Non-critical: Non-critical condition is detected. Not Used: Element is not installed in enclosure. OK: Element is installed and no error conditions are known. Unknown: Either: ○ Sensor has failed or element status is not available. Appears only if an I/O module indicates it has fewer PHYs than the reporting I/O module, in which case all additional PHYs are reported as unknown. ○ Element is installed with no known errors, but the element has not been turned on or set into operation.
The name of the fan module in the format Fan Module ID. 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 about all fan modules in the system. # show fan-modules Basetypes fan-modules status See also show fans show power-supplies show fans Description Shows information about each fan in the storage system.
Part Number ● (blank): Not applicable. Firmware version ● (blank): Not applicable. ● The firmware revision of a fan FRU. Hardware version ● (blank): Not applicable. 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 about all fans in the system.
Examples Show FDE information. # show fde-state Basetypes fde-state status See also clear fde-keys set fde-import-key set fde-lock-key set fde-state show fenced-data Description Shows information about fenced data blocks in the storage system. The command will show information for all fenced blocks by default, or you can use parameters to filter the output.
[volumes volumes] Optional for linear storage. The names or serial numbers of linear volumes for which to show fenced data block information. A name that includes a space must be enclosed in double quotes. Output Volume Name The volume name for which fenced data is reported. Volume Serial Number The volume serial number for which fenced data is reported. Volume LBA The LBA in the volume at which fenced data is reported. Vdisk Name The name of the disk group for which fenced data is reported.
The FRU description. Part Number The FRU part number. Serial Number The FRU serial number. Revision The hardware revision level. Dash Level The FRU template revision number. FRU Shortname A short description of the FRU. Manufacturing Date The date and time in the format year-month-day hour:minutes:seconds when a PCBA was programmed or a power supply module was manufactured. Manufacturing Location The city, state/province, and country where the FRU was manufactured.
show host-groups Description Shows information about host groups and hosts. The command will show information for all host groups (and hosts) by default, or you can use parameters to filter the output. Minimum role monitor Syntax show host-groups [hosts hosts] [groups host-groups] Parameters hosts hosts Optional. A comma-separated list of the names of hosts for which to show host and initiator information. If this parameter is omitted, information is shown for all hosts.
# show host-groups groups HGroup1,HGroup3 Basetypes host-group status See also create host-group delete host-groups set host-group show host-phy-statistics Description Shows diagnostic information relating to SAS controller physical channels, known as PHY lanes, for each host port. This command shows PHY status information for each host port found in an enclosure. Each controller in an enclosure may have multiple host ports. A host port may have multiply PHYs.
show host-port statistics Description Shows live performance statistics for each controller host port. For each host port these statistics quantify I/O operations through the port between a host and a volume. For example, each time a host writes to a volume’s cache, the host port’s statistics are adjusted. For host-port performance statistics, the system samples live data every 15 seconds. Statistics shown only in API output are described in API basetypes properties.
The date and time, in the format year-month-day hour:minutes:seconds, when these statistics were last reset, either by a user or by a controller restart. Examples Show live performance statistics for all host ports. # show host-port-statistics Show live performance statistics for host port A1.
Host Type The host-interface type: FC; iSCSI; SAS. ID For an FC initiator, its WWPN. For a SAS initiator, its WWPN. For an iSCSI initiator, its node name (typically the IQN). Examples Show information about all initiators. # show initiators Show information about initiators in host Host1 only.
Output Ctlr The controller ID: A or B. Index The controller's index value for the address. The index is automatically assigned when adding a static IPv6 address. Label The name assigned to the address, or ‘-’ if the address is unnamed. Address The IPv6 address with prefix length. Examples Show static IPv6 addresses assigned to controller A.
status See also set ipv6-network-parameters show iscsi-parameters Description Shows system-wide parameters for iSCSI host ports in each controller module. Minimum role monitor Syntax show iscsi-parameters Output CHAP Shows whether Challenge-Handshake Authentication Protocol (CHAP) is enabled or disabled. ● Enabled: CHAP is enabled. ● Disabled: CHAP is disabled. Jumbo Frames Shows whether support for jumbo frames is enabled or disabled. ● Enabled: Jumbo-frame support is enabled.
Output License Key The license key, licensing serial number, and status of licensed features. All licensed features are enabled. show maps Description Shows information about mappings between volumes and initiators. If no parameter is specified, this command shows explicit mappings (but not default mappings) for all volumes. In a dual-controller system, if a mapping uses corresponding ports on both controllers, such as A1 and B1, the Ports field will simply show 1.
Shown by the initiator parameter. For an FC initiator, its WWPN. For a SAS initiator, its WWPN. For an iSCSI initiator, its node name (typically the IQN). Host-Port-Identifier (v2)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. Identifier (v3) See Host-Port-Identifier, above. Initiator-Identifier Shown for a volume group mapping. ● For an FC initiator, its WWPN.
volume-view volume-view-mappings status See also show host-groups show initiators show volume-groups show volumes show network-parameters Description Shows the settings and health of each controller module’s network port Minimum role monitor Syntax show network-parameters Output IP Address The network port IP address. Gateway The network port gateway IP address. Subnet Mask The network port IP subnet mask. MAC Address The controller’s unique Media Access Control address.
● Fault ● N/A ● Unknown Health Reason If Health is not OK, this field shows the reason for the health state. Health Recommendation If Health is not OK, this field shows recommended actions to take to resolve the health issue. Examples Show network parameters for each controller module. # show network-parameters Basetypes network-parameters status See also set network-parameters show ntp-status Description Shows the status of the use of Network Time Protocol (NTP) in the system.
peer-connection-ID Parameters [verify-links] Optional. If a peer connection ID is specified, this parameter displays the ports that can be seen by each port on each peer system. peer-connection-ID Optional. Specifies the name or serial number of the peer connection for which to show information. If this parameter is not specified the command shows information for all peer connections. Output Peer Connection Name The name of the peer connection.
delete peer-connection query peer-connection set peer-connection show pools Description Shows information about linear and virtual pools. The command will show information for all pools by default, or you can use parameters to filter the output. The system can have a maximum of two virtual pools. The system can have a maximum of two virtual pools.
Mid Thresh The middle threshold for page allocation as a percentage of pool capacity. When this threshold is exceeded, event 462 will be logged. If the pool is not overcommitted, the event will have Informational severity. If the pool is overcommitted, the event will have Warning severity. High Thresh The high threshold for page allocation as a percentage of pool capacity. The threshold value is automatically calculated based on the available capacity of the pool minus 200 GB of reserved space.
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. 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.
date/time is specified, the current date/time will be used as the end date/time. The system will return the oldest sample taken after the start time and the latest sample taken before the end time. If the specified start date/time is earlier than the oldest sample, that sample will be used as the start date/time. If you specify this parameter, do not specify the count parameter. If this parameter is omitted, the most recent 100 data samples will be displayed. disks Optional.
Write Resp Time Shown by the all parameter. The average response time, in microseconds, for write operations since the last sampling time. Historical For a pool: Pool The name of the pool. 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.
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. Page Moves In The number of pages moved into this tier from a different tier. Page Moves Out The number of pages moved out of this tier to other tiers.
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.
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. If the detail parameter is specified, this field shows the number of active lanes in the SAS port.
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. If the SFP returns an unsupported code, this field will show the equivalent hex value. Ethernet Compliance iSCSI only. If the detail parameter is specified, this field shows the SFP's Ethernet compliance code. If the SFP returns an unsupported code, this field will show the equivalent hex value.
● 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. # show power-supplies Basetypes power-supplies fan status See also show fans show frus show protocols Description Shows which management services and protocols are enabled or disabled.
Shows whether the SNMP interface is enabled or disabled. When this is disabled, all SNMP requests to the MIB are disabled and SNMP traps are disabled. Service Debug Shows whether the Telnet debug port is enabled or disabled. In-band SES Management (SES) Shows whether the in-band SES interface is enabled or disabled. Activity Progress Reporting (activity) Shows whether access to the activity progress interface via HTTP port 8081 is enabled or disabled.
the volume WWN (or LUN), and then use the command output to find the associated controller and disks. Minimum role monitor Syntax show provisioning [disks disks | luns LUNs | pool pools | ports ports | vdisks vdisks| volumes volumes ] [no-mapping] [unhealthy] Parameters disks disks Optional. Shows provisioning information for the specified list of disks. For disk syntax, see Command syntax. This command does not support the use of hyphens to indicate a range of disks. luns LUNs Optional.
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. ● Blank if not mapped or mapped as no-access.
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 refresh-counters 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.
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.
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. ● discard: Discard the new replication request. ● queue-latest: Take a snapshot of the primary volume and queue the new replication request.
# show replication-sets Show information about replication set RS1. # show replication-sets RS1 Basetypes cs-replication on page 307 cs-replication-set status See also create replication-set delete replication-set resume replication-set set replication-set suspend replication-set show replication-snapshot-history Description Shows information about the snapshot history for all replication sets or a specific replication set.
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. The oldest snapshot in snapshot history will be deleted once the snapshot-count has been exceeded.
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. Disconnected: Either no I/O link is detected or the port is not cabled. Health ● ● ● ● ● OK Degraded Fault N/A Unknown Reason If Health is not OK, this field shows the reason for the health state.
● ● ● ● ● ● 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. Next Time The date and time, in the format year-month-day hour : minutes : seconds (UTC), when the schedule will next run. Task To Run The name of the task that the schedule runs.
● For a sensor, its value. ● For Overall Unit Status, one of the status values below. Status ● 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.
● Unknown 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).
Basetypes snap-space status 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 ● Available ● Unavailable: See the Status-Reason value. 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.
See also show pools show volumes 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.
Operation Mode ● Normal – The service is operating normally. ● Maintenance – Maintenance mode is automatically enabled during maintenance activities such as a firmware update or a user-initiated controller restart. In addition, a user can put the system into 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.
Minimum role monitor Syntax show syslog-parameters Output Syslog Host IP The IP address or domain name of the remote syslog server used for the notifications. Syslog Notification Level 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.
The product model identifier. Product Brand The product brand name. SCSI Vendor ID Shown by the detail parameter. The vendor name returned by the SCSI INQUIRY command. 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.
Shows 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. ULP appears to the host as an active-active storage system where the host can choose any available path to access a LUN regardless of disk group ownership. When ULP is in use, the system’s operating/ cache-redundancy mode is shown as Active-Active ULP.
The last six digits of the midplane serial number. Examples Show settings and configuration limits for the storage system. # show system-parameters Base types system-parameters-table status 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.
● Deleted: The task is expired but this state is not yet synchronized to the partner controller. Task State The current step of the task: ● Start ● VerifyVolume ● CreateName ● CreateSnap ● 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.
The current step of the task: ● Start ● VerifySnap ● UnmapSnap ● ResetSnap Error Message ● 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.
● preserved: The copy excludes modified snapshot data Last Created ● The name of the last volume created by the task. ● Blank if the task has not created a volume. 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.
● ● ● ● 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, which is always Start. Error Message ● If an error occurred while processing the task, the error message. ● Blank if no error has occurred. Examples Show information about all tasks. # show tasks Show information about task Task1.
The amount of space currently allocated to volumes in the tier. Available Size The available capacity in the tier. 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 number of 4 MB pages that host systems have unmapped per minute, through use of the SCSI UNMAP command, to free storage space as a result of deleting files or formatting volumes on the host. Time Since Reset 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.
show unwritable-cache Description Shows the percentage of unwritable data in the system. This data has not been written to disk because it is associated with a volume that no longer exists or whose disks are not online. If the data is needed, the volume’s disks must be brought online. If the data is not needed it can be cleared, in which case it will be lost and data will differ between the host and disk.
WBI ● x: The user can access the PowerVault Manager web-browser interface. ● (blank): The user cannot access this interface. CLI ● x: The user can access the command-line interface. ● (blank): The user cannot access this interface. FTP ● x: The user can access the FTP or SFTP interface. ● (blank): The user cannot access this interface. SMI-S ● x: The user can access the Storage Management Initiative Specification (SMI-S) interface. ● (blank): The user cannot access this interface.
show vdisks Description Shows information about all or specified linear disk groups. This command applies to linear storage only. Minimum role monitor Syntax show vdisks [vdisks] Parameters vdisks Optional. A comma-separated list of the names or serial numbers of the linear disk groups to show information about. A name that includes a space must be enclosed in double quotes. Output Name The name of the disk group. Size The size of the disk group.
● QTCR: Quarantined critical. The vdisk is critical with at least one inaccessible disk. For example, two disks are inaccessible in a RAID-6 disk group or one disk is inaccessible for other faulttolerant RAID levels. If the inaccessible disks come online or if after 60 seconds from being quarantined the disk group is QTCR or QTDN, the disk group is automatically dequarantined. ● QTDN: Quarantined with a down disk. The RAID-6 disk group has one inaccessible disk.
● 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 linear disk groups. # show vdisks Show information about linear disk group vd0002.
Minimum role monitor Syntax To show live statistics: show vdisk-statistics [vdisks] To show historical statistics: show vdisk-statistics [all] [count number-of-data-samples] historical [time-range "date/time-range"] vdisk 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.
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.
Data Written Shown by the all parameter. The amount of data written since the last sampling time. Total B/s The data transfer rate, in bytes per second, since the last sampling time. This is the sum of Read B/s and Write B/s. Read B/s Shown by the all parameter. The data transfer rate, in bytes per second, for read operations since the last sampling time. Write B/s Shown by the all parameter. The data transfer rate, in bytes per second, for write operations since the last sampling time.
# show versions Show detailed version information for each controller module. # show versions detail Show version information for FRUs in each enclosure. # show versions frus Basetypes versions expander-versions fru-versions status See also show inquiry show volume-copies Description Shows information about in-progress copy volume operations. Minimum role monitor Syntax show volume-copies Output Src Volume The name of the source volume.
Minimum role monitor Syntax show volume-groups [volume-groups] Output Volume group information: Group Name The name of the volume group. Serial Number The serial number of the volume group. Type The group type, which is Volume. Number of Members The number of volumes in the volume group. Volume information: Pool The name of the pool that contains the volume. Name The name of the volume. Total Size The total size of the volume.
status See also create volume-group delete volume-groups set volume-group show volume-names Description Shows volume names and serial numbers. Minimum role monitor Syntax show volume-names [volumes] Parameters volumes Optional. A comma-separated list of the names or serial numbers of the volumes 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 volumes Output Name The name of the volume.
Output Properties are described in alphabetical order. Host ID For an FC initiator, its WWPN. For a SAS initiator, its WWPN. For an iSCSI initiator, its node name (typically the IQN). Key The reservation key, shown as a hexadecimal value. Name The name of the volume. PGR Generation The generation of the volume reservation, shown as a hexadecimal value. Ports The controller host-port identifiers. Reservation Type ● Write Exclusive: Write commands are only allowed for a single reservation holder.
show volume-statistics Description Shows live performance statistics for all or specified volumes. For each volume these statistics quantify I/O operations between hosts and the volume. For example, each time a host writes to a volume’s cache, the volume’s statistics are adjusted. For volume performance statistics, the system samples live data every 15 seconds. Statistics shown only in API output are described in API basetype properties.
% RC The percentage of read-cache capacity that is occupied. Reset Time The date and time, in the format year - month - day hour : minutes :seconds, when these statistics were last reset, either by a user or by a controller restart. Examples Show live performance statistics for all volumes. # show volume-statistics Show live performance statistics for volume v0001.
Optional. ● all: Show all volumes. ● base: Show only virtual volumes that are not snapshots of any other volume. ● snapshot: Show only snapshots. ● standard: Show only standard volumes. ● primary-volume: Show only primary volumes. ● secondary-volume: Show only secondary volumes. If this parameter is omitted, all volumes are shown. vdisk vdisks Optional. A comma-separated list of the names or serial numbers of the vdisks containing the volumes to show.
Read Ahead Shown by the details parameter. The read-ahead cache setting: ● Disabled: Read-ahead is disabled. ● 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.
WR Policy Shown by the details parameter. The cache write policy: ● write-back: Write-back caching does not wait for data to be completely written to disk before signaling the host that the write is complete. This is the preferred setting for a fault-tolerant environment because it improves the performance of write operations and throughput.
See also restart mc restart sc show shutdown-status suspend replication-set Description Suspends the replication operations for the specified replication set. This command applies to virtual storage only. You can run this command on the replication set’s primary system. When you run this command, all replications in progress are paused and no new replications are allowed to start. During the suspension period, you can abort paused replications using the abort replication command.
● managedlogswarn: Specify this option to test receipt of the managed-logs notification that logs are nearly full and must be transferred to avoid losing older entries. (Event 401) ● managedlogswrap: Specify this option to test receipt of the managed-logs notification that logs have wrapped and older entries may be lost. (Event 402) ● notification: Specify this option to test receipt of event-notification messages by every interface that is configured to receive them, such as email, SNMP, and SMI-S.
CAUTION: 1. Do not use the trust command when the storage system is unstable. For example, if there are many power or topology-change events. 2. The trust command can be run on a quarantined-offline or offline disk group. In many cases the disk group will be automatically dequarantined. If you cannot resolve the issue that caused the disk to become quarantined such that it is automatically dequarantined, and if the trust operation is applicable to your situation, then proceed to trust.
Syntax Trust [enable|disable] [disk-group disk-group] [unsafe] [vdisk vdisk] Parameters enable|disable Optional. ● enable: Enables the trust command before use. ● disable: Disables the trust command if it is not used after being enabled. If trust is not explicitly disabled, it will be automatically disabled when the user’s CLI session ends. disk-group disk-group Optional. The name or serial number of the disk group to trust. A name that includes a space must be enclosed in double quotes. unsafe Optional.
as a guide to decide which disks to physically remove before doing the trust operation to minimize the amount of corrupt data in the trusted disk group if you want to use the unsafe parameter. Examples Trust a disk group which has enough good disks to complete the trust operation. The disk group may have out-of-sync or partially reconstructed disks but they are not needed to complete the trust operation. The command completes successfully. # trust enable Success: Command completed successfully.
Success: Command completed successfully. (data_1) - Trust operation completed successfully for this disk group. (2013-09-17 09:07:31) Abort an unsafe trust operation when you decide not to risk using bad disks. # trust enable Success: Command completed successfully. - Trust is enabled. (2013-09-17 09:05:37) Location Serial Number Type State Partially Reconstructed Out Of Sync Age 1.2 SN SAS LEFTOVR False True 6 1.4 SN SAS VIRTUAL POOL False False 7 1.
unmap volume Description Deletes explicit mappings or the default mapping for specified volumes. When an explicit mapping between an initiator and a volume is deleted, access by that initiator to the volume is controlled by the volume’s default mapping (described in help for create volume). When a default mapping is deleted, access by initiators to the volume is controlled by any explicit mappings of those initiators to the volume. If neither mapping exists, the volume is unavailable to initiators.
verify disk-groups Description Analyzes redundant disk groups to find and fix inconsistencies between their redundancy data and their user data. This command acts on all disks in a disk group but not dedicated spares or leftover disks. This command will find and optionally fix parity mismatches for RAID 3, 5, 6, and 50, and find mirror mismatches for RAID 1 and 10. This command can be performed only on a disk group whose status is FTOL (fault tolerant and online).
Output Port The port ID. Type ● FC: FC port. ● iSCSI: iSCSI port. ● Unknown: Port type is unknown. Links The IDs of linked ports. Examples Verify all links between controllers A and B. # verify links verify vdisk Description Analyzes redundant vdisks to find and fix inconsistencies between their redundancy data and their user data. This command applies to linear storage only. This command acts on all disks in a vdisk but not dedicated spares or leftover disks.
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.
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 284 eventsLogs 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-
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • sas-port sas-status-controller-a 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 tier
Table 6. adapt-expand-preview properties (continued) Name Type Description pool string The name of the pool that contains the disk group. pool-serial-number string The serial number of the pool that contains the disk group. type string Disk description. ● SAS: Enterprise SAS spinning disk. ● SAS MDL: Midline SAS spinning disk. ● SSD SAS: SAS solid-state disk. type-numeric uint32 Numeric equivalents for type values.
Table 6. adapt-expand-preview properties (continued) Name Type Description ● 8: Read Cache 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 diskdisplay-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 ● 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. ● Disabled: SMART is disabled for all disks in the system and will be disabled for new disks added to the system. smart-numeric uint32 Numeric equivalents for smart values.
Table 7. advanced-settings-table properties (continued) Name Type Description missing-lun-response-numeric uint32 Numeric equivalents for missing-lun-response values. ● 0: Not Ready ● 1: Illegal Request controller-failure string 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.
Table 7. advanced-settings-table properties (continued) Name Type Description partner-notify string Shows whether the partner controller will be notified when a trigger condition occurs. ● Disabled: Notification is disabled. The partner controller will continue using its current caching mode. ● Enabled: Notification is enabled. The partner controller will change to writethrough mode for better data protection. partner-notify-numeric uint32 Numeric equivalents for partner-notify values.
Table 7. advanced-settings-table properties (continued) Name Type Description ● Disabled: Single Controller mode is disabled. single-controller-numeric uint32 Numeric equivalents for single-controller values.
Table 8. cache-parameter properties Name Type Description serial-number string If a volume is specified, its serial number. volume-name string If a volume is specified, its name. write-policy string If a volume is specified, its cache write policy. ● write-back: Write-back caching does not wait for data to be completely written to disk before signaling the host that the write is complete.
cache-settings This basetype is used by show cache-parameters on page 168 to show system cache properties. Table 9. cache-settings properties Name Type Description operation-mode string The operating mode of the system, also called the cache redundancy mode. ● Independent Cache Performance Mode: For a dual-controller system, controller failover is disabled and data in the write-back cache if the controller is not mirrored to the partner controller.
Table 10. certificate-status properties (continued) Name Type Description certificate-time string The date and time, in the format year-month-day hour:minutes:seconds, when the certificate was created. certificate- signature string The first few characters of the certificate file. This property is for diagnostic purposes, and can be used to verify that the proper certificate is in use. certificate-text string The full text of the certificate.
Table 12. cli-parameters properties (continued) Name Type Description output-format-api- numeric uint32 Numeric equivalents for output-format-api values. ● 1: console ● 2: api ● 3: api-brief ● 4: api-embed ● 5: api-embed-brief ● 6: json ● 7: json-full brief-mode string ● Enabled: In XML output, this setting shows a subset of attributes of object properties. The name and type attributes are always shown. ● Disabled: In XML output, this setting shows all attributes of object properties.
Table 12. cli-parameters properties (continued) Name Type Description and storage-size-base is set to 10, the size 0.11709 TB is instead shown as 117.1 GB. storage-size- units-numeric uint32 Numeric equivalents for storage-size-units values. ● 0: Auto ● 1: MB ● 2: GB ● 3: TB temperature-scale string ● Fahrenheit: Temperatures are shown in degrees Fahrenheit. ● Celsius: Temperatures are shown in degrees Celsius. temperature-scale- numeric uint32 Numeric equivalents for temperature-scale values.
Table 13. chap-records properties (continued) Name Type Description ● 0: Disabled ● 1: Enabled cloudiq-last-logssend-status string Specifies the status of the last transmission of storage system configuration data to the support server. cloudiq-last-logssend-time string Specifies the date/time of the last transmission of storage system configuration data to the support server. cloudiq-lastconfig-sendtimenumeric unit32 Unformatted cloudiq-last-config-send-time value.
Table 16. communication-ports properties Name Type Description ssh-port uint16 The port number used for SSH. sftp-port uint16 The port number used for SFTP. compact-flash This basetype is used by show controllers on page 175. Table 17. compact-flash properties Name Type Description durable-id string ● Ctlr A CF: CompactFlash card in controller A. ● Ctlr B CF: CompactFlash card in controller B. controller-id string ● A: Controller A. ● B: Controller B.
Table 18. contact-information properties Name Type Description company-name string The name of the customer. company-country-territory string The country/territory code of the customer. first-name string The first name of the customer contact. last-name string The last name of the customer contact. phone-number string The phone number of the customer contact. alternate-phone-number string The alternate phone number of the customer contact.
Table 19. controller-cache-parameters properties (continued) Name Type Description name string ● Controller A Cache Parameters ● Controller B Cache Parameters write-back-status string Shows the current, system-wide cache policy as determined by auto-writethrough logic. This value is not settable by users. If an auto-write-through trigger condition (such as a CompactFlash failure) is met, the cache policy for all volumes changes to write-through, overriding the volume-specific settings.
Table 20. controllers properties (continued) Name Type Description controller-id string ● A: Controller A. ● B: Controller B. 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 20. 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 failedover property becomes Yes for the other controller.
Table 20. controllers properties (continued) Name Type Description ● 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 20. controllers properties (continued) Name Type Description rotation string Rotation of the controller module in the enclosure. ● 0 Degrees ● 90 Degrees ● 180 Degrees ● 270 Degrees rotation-numeric string Numeric equivalents for position values. ● 0: 0 Degrees ● 1: 90 Degrees ● 2: 180 Degrees ● 3: 270 Degrees phy-isolation string Shows whether the automatic disabling of SAS expander PHYs having high error counts is enabled or disabled for this controller.
Table 20. controllers properties (continued) Name Type Description ip-address Embedded; see network-parameters on page 365. port-details Embedded; see port on page 375. enclosure-id Embedded; see expander-ports on page 343. compact-flash Embedded; see compact-flash on page 298. expander-details Embedded; seeexpanders on page 345. controller-statistics This basetype is used by show controller-statistics on page 177. Table 21.
Table 21. controller-statistics properties (continued) Name Type Description num-forwarded-cmds uint32 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. reset-time string Date and time, in the format year-month-day hour:minutes:seconds, when these statistics were last reset, either by a user or by a controller restart.
Table 23. 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. replicate-last-snapshot string ● False: The primary volume will be replicated. ● True: The most recent snapshot of the primary volume will be replicated. replicate-last-snapshotnumeric uint32 Numeric equivalents for replicate-last-snapshot values.
Table 24. cs-replication-set properties (continued) Name Type Description run-error string A message that says whether the replication succeeded or an error occurred. cs-replication-set This basetype is used by show replication-sets on page 234 for a virtual replication set. Table 25. cs-replication-set-properties Name Type Description name string The replication set name. serial-number string The replication set serial number. group string ● Yes: The replication set is part of a group.
Table 25. cs-replication-set-properties (continued) Name Type Description ● disabled or off: A snapshot history will not be kept. ● secondary: A snapshot history set will be kept on the secondary system for the secondary volume. ● both: A snapshot history will be kept for the primary volume on the primary system and for the secondary volume on the secondary system. snapshot-history-numeric uint32 Numeric equivalents for snapshot-history values.
Table 25. cs-replication-set-properties (continued) Name Type Description 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. The value shows when the primary and secondary volumes were last known to be in sync. last-success-time-numeric uint32 Unformatted last-success-time value. last-success-generation sint32 The number of times a replication has successfully completed.
Table 27. debug-log-parameters properties (continued) Name Type Description ● Off: Disabled. ● On: Enabled. host-dbg-numeric uint32 Numeric equivalents for host values. ● 0: Off ● 1: On disk string Shows whether disk interface debug messages are enabled for inclusion in the Storage Controller debug log. ● Off: Disabled. ● On: Enabled. disk-numeric uint32 Numeric equivalents for disk values.
Table 27. debug-log-parameters properties (continued) Name Type Description ioc string Shows whether upper-layer, verbose debug messages for an I/O interface driver are enabled for inclusion in the Storage Controller debug log. ● Off: Disabled. ● On: Enabled. ioc-numeric uint32 Numeric equivalents for ioc values. ● 0: Off ● 1: On iod string Shows whether lower-layer, verbose debug messages for an I/O interface driver are enabled for inclusion in the Storage Controller debug log. ● Off: Disabled.
Table 27. debug-log-parameters properties (continued) Name Type Description ● 0: Off ● 1: On capi string Shows whether Internal Configuration API debug messages are enabled for inclusion in the Storage Controller debug log. ● Off: Disabled. ● On: Enabled. capi-numeric uint32 Numeric equivalents for capi values. ● 0: Off ● 1: On mui string Shows whether internal service interface debug messages are enabled for inclusion in the Storage Controller debug log. ● Off: Disabled. ● On: Enabled.
Table 27. debug-log-parameters properties (continued) Name Type Description fruid string Shows whether FRU ID debug messages are enabled for inclusion in the Storage Controller debug log. ● Off: Disabled. ● On: Enabled. fruid-numeric uint32 Numeric equivalents for fruid values. ● 0: Off ● 1: On resmgr string Shows whether Reservation Manager debug messages are enabled for inclusion in the Storage Controller debug log. ● Off: Disabled. ● On: Enabled.
Table 27. debug-log-parameters properties (continued) Name Type Description ● 0: Off ● 1: On autotest string Shows whether auto-test debug messages are enabled for inclusion in the Storage Controller debug log. ● Off: Disabled. ● On: Enabled. autotest-numeric uint32 Numeric equivalents for autotest values. ● 0: Off ● 1: On cs string Shows whether Copy Services feature debug messages are enabled for inclusion in the Storage Controller debug log. ● Off: Disabled. ● On: Enabled.
Table 28. disk-groups properties (continued) Name Type Description storage-tier string ● 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 28. disk-groups properties (continued) Name Type Description ● ● ● ● ● ● ● ● 1: RAID1 2: ADAPT 3: RAID3 5: RAID5 6: NRAID 8: RAID50 10: RAID10 11: RAID6 diskcount uint16 Number of disks in the disk group. sparecount uint16 For a linear disk group, the number of spares assigned to the disk group. For a virtual disk group, 0. chunksize string ● For RAID levels except NRAID, RAID 1, and RAID 50, the chunk size for the disk group.
Table 28. disk-groups properties (continued) Name Type Description ● ● ● ● ● ● ● 5: QTOF 6: QTDN 7: STOP 8: MSNG 9: DMGD 250: UP other:UNKN lun uint32 Deprecated. min-drive-size string Minimum disk size that can this disk group can use, formatted to use the current base, precision, and units. min-drive-size-numeric uint64 Numeric equivalents for min-drive-size values. create-date string Date and time, in the format year-month-day hour:minutes:seconds (UTC), when the disk group was created.
Table 28. disk-groups properties (continued) Name Type Description ● ● ● ● 12: 13: 14: 16: VPREP VDRAIN VRECV RBAL current-job-completion string ● 0%–99%: Percent complete of running job. ● (blank): No job is running (job has completed). num-array-partitions uint32 Number of volumes in the disk group. largest-free-partition-space string The largest contiguous space in which a volume can be created. The value is formatted to use the current base, precision, and units.
Table 28. disk-groups properties (continued) Name Type Description blocks-numeric uint64 Unformatted blocks value. disk-dsd-enable-vdisk string ● Disabled: DSD is disabled for the disk group ● 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.
Table 28. disk-groups properties (continued) Name Type Description ● ● ● ● Degraded Fault Unknown N/A health-numeric uint32 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 actions to take to resolve the health issue. unhealthy-component Embedded; see unhealthy-component on page 415.
Table 29. disk-groups-preview properties (continued) Name Type Description ● ● ● ● ● 5 : RAID5 6: NRAID 8: RAID50 10: RAID10 11: RAID6 tier string ● 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 30. disk-group-statistics properties (continued) Name Type Description 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. bytes-per-second string 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.
Table 32. disk-hist-statistics properties (continued) Name Type Description total-data-transferred string Total amount of data read and written since the last sampling time. total-data-transferrednumeric 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. data-written string Amount of data written since the last sampling time.
disk-statistics This basetype is used by show disk-statistics on page 190 when the historical parameter is omitted. Table 33. disk-statistics properties Name Type Description durable-id string Disk ID in the format disk_enclosure-number.disk-number. location string The disk location in the format disk_enclosure-number.disk-number. serial-number string Disk serial number. power-on-hours uint32 The total number of hours that the disk has been powered on since it was manufactured.
Table 33. disk-statistics properties (continued) Name Type Description no-response-count-1 uint32 For port 1, the number of times the disk did not respond. spinup-retry-count-1 uint32 For port 1, the number of attempts by the storage system to spin up the disk. number-of-media-errors-1 uint32 For port 1, the number of media errors generated by the disk, as specified by its manufacturer.
Table 35. drawers properties (continued) Name Type Description drawer-id uint8 Not applicable (255). drawer-wwn string Drawer WWN. part-number string Drawer part number. name string Drawer name. position string The drawer position in the enclosure, as viewed from the front. ● Left ● Right ● Top ● Bottom position-numeric uint32 Numeric equivalents for position values. ● 0: Left ● 1: Right ● 2: Top ● 3: Bottom rows uint8 Number of rows of disk slots.
Table 35. drawers properties (continued) Name Type Description status string Drawer status. ● Unsupported ● OK ● Critical ● Warning ● Unrecoverable ● Not Installed ● Unknown ● Unavailable status-numeric uint32 Numeric equivalents for status values.
Table 36. drive-parameters properties (continued) Name Type Description ● Disabled: SMART is disabled for all disks in the system and will be disabled for new disks added to the system. smart-numeric uint32 Numeric equivalents for smart values. ● 0: Detect-Only ● 1: Enabled ● 2: Disabled drive-write-back-cache string ● Disabled: Disk write-back cache is disabled for all disks in the system and will be enabled for new disks added to the system. This value cannot be changed.
Table 38. drives properties Name Type Description durable-id string Disk ID in the format disk_enclosure-ID.slot-number. enclosure-id uint32 Enclosure ID. drawer-id uint8 ● 0: Top ● 1: Bottom uint8 Not applicable (255). slot uint32 Disk slot number. location string Enclosure ID of the disk and slot number. url string Disk URL. 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.
Table 38. drives properties (continued) Name Type Description NOTE: ME4 Series systems support only dual-ported disks. single-ported-numeric uint32 Numeric equivalents for single-ported values. ● 0: Disabled ● 1: Enabled NOTE: ME4 Series systems support only dual-ported disks. type string Type of disk. ● SAS: Enterprise SAS. ● SAS MDL: Midline SAS. ● sSAS: SAS SSD. type-numeric uint32 Numeric equivalents for type values.
Table 38. drives properties (continued) Name Type Description fc-p1-node-wwn string Port 1 WWNN. fc-p1-port-wwn string Port 1 WWPN. fc-p1-unit-number uint32 Port 1 unit number. fc-p2-channel uint32 Port 2 channel number. fc-p2-device-id uint32 Port 2 device ID. fc-p2-node-wwn string Port 2 WWNN. fc-p2-port-wwn string Port 2 WWPN. fc-p2-unit-number uint32 Port 2 unit number. drive-down-code uint8 Numeric code indicating why the disk is down.
Table 38. drives properties (continued) Name Type Description attributes-numeric uint32 For internal use only. enclosure-wwn string Enclosure WWN. enclosures-url string Enclosure URL. status string Disk status. ● 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. ● Warning: The disk is present but the system is having communication problems with the disk LED processor.
Table 38. drives properties (continued) Name Type Description ● ● ● ● ● 1: 2: 3: 4: 5: Not Secured Secured, Unlocked Secure, Locked FDE Protocol Failure Unknown lock-key-id string Current lock ID, or 00000000 if not set. import-lock-key-id string Import lock ID, or 00000000 if not set. 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.
Table 38.
Table 39. email-parameters properties (continued) Name Type Description ● none: Disables email notification. This parameter does not apply to managed-logs notifications. email-notification-filternumeric uint32 Numeric equivalents for email-notification-filter values. ● 0: info ● 1: resolved ● 2: warn ● 3: error ● 4: crit ● 5: none email-notify-address-1 string Up to three email addresses for recipients of event notifications.
Table 40. enclosure-fru properties (continued) Name Type Description ● POWER_SUPPLY: Power supply module ● MEMORY CARD: CompactFlash card description string FRU long 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.
Table 40. enclosure-fru properties (continued) Name Type Description original-revision string For a power supply module, the original manufacturer hardware revision. Otherwise, N/A. enclosure-id uint32 Enclosure ID. enclosure-list This basetype is used by show configuration on page 173, and by show disks on page 184 when the encl parameter is specified. Table 41. enclosure-list properties Name Type Description status string Disk slot status.
enclosures This basetype is used by show configuration on page 173 and show enclosures on page 196. Table 42. enclosure properties Name Type Description durable-id string Enclosure ID in the format enclosure_number. enclosure-id uint8 Enclosure ID. enclosure-wwn string Enclosure WWN. 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.
Table 42. enclosure properties (continued) Name Type Description ● 0x02: IOM B incompatible midplane-serial-number string Midplane serial number. vendor string Enclosure vendor. model string Enclosure model. fru_tlapn string FRU top-level assembly part number. 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.
Table 42. enclosure properties (continued) Name Type Description emp-a-busid string SCSI channel ID of controller A EMP. emp-a-targetid string SCSI target ID of controller A EMP. emp-b-busid string SCSI channel ID of controller B EMP. emp-b-targetid string SCSI target ID of controller B EMP. 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.
events This basetype is used by show events on page 198. Table 43. 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 ● A: Controller A. ● B: Controller B.
Table 44. eventsLogs properties (continued) 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 string Unformatted time-stamp value. event-code string Event code identifying the type of event to help diagnose problems. severity string Event severity. ● CRITICAL: A failure occurred that may cause a controller to shut down. Correct the problem immediately.
Table 45. expander-ports properties (continued) Name Type Description sas-port-index uint32 The expander port index. For an IOM with two expansion ports, this value differentiates the two egress ports (0–1) and two ingress ports (0–1) for each path A and B. This value is appended to the port’s durable-id value. name string ● Out Port: Egress (expansion) port on controller module or an expansion module. Can be connected to an ingress port in an expansion module.
Table 46. expander-versions properties (continued) Name Type Description drawer-id uint8 ● 0: Top ● 1: Bottom expander-id uint8 Expander ID. controller string ● A: Controller A. ● B: Controller B. controller-numeric uint32 Numeric equivalents for controller values. ● 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 47. expanders properties (continued) Name Type Description ● ● ● ● ● ● Critical Warning Unrecoverable Not Installed Unknown Unavailable status-numeric uint32 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 48. fan properties (continued) Name Type Description ● ● ● ● ● ● ● OK Critical Warning Unrecoverable Not Installed Unknown Unavailable status-ses-numeric uint32 Numeric equivalents for status-ses values. ● 0: Unsupported ● 1: OK ● 2: Critical ● 3: Warning ● 4: Unrecoverable ● 5: Not Installed ● 6: Unknown ● 7: Unavailable extended-status hex32 A numeric value that provides additional information to supplement the standard SES status shown by the status and status-numeric properties.
Table 48. fan properties (continued) Name Type Description ● 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. ● Off ● On locator-led-numeric uint32 Numeric equivalents for locator-led values.
fan-modules This basetype is used by show fan-modules on page 201. Table 50. 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 50. fan-modules properties (continued) Name Type Description 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 415. fan-details Embedded; see fan on page 346. fc-port This basetype is used by show ports on page 225 for a Fibre Channel port. Table 51. fc-port properties Name Type Description configured-topology string Configured topology.
Table 51. fc-port properties (continued) Name Type Description ● 1: Present sfp-vendor string The SFP vendor. 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-speedsnumeric uint32 Numeric equivalents for sfp-supported-speeds values. fde-state This basetype is used by show fde-state on page 203. Table 52.
Table 53. fenced-data properties (continued) Name Type Description virtual-disk-lba string The LBA in the disk group at which fenced data is reported. fru-versions This basetype is used by show versions on page 264 when the frus parameter is specified. Table 54. fru-versions properties Name Type Description enclosure-id uint32 The enclosure ID. midplane-versions Embedded; see midplane-versions on page 365. expander-versions Embedded; see expander-versions on page 344.
host-group-view This basetype is used by show maps on page 214 when the initiator parameter is specified. Table 57. 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.
Table 58. host-port-statistics properties (continued) Name Type Description reset-time-numeric uint32 Unformatted reset-time value. start-sample-time string Date and time, in the format year-month-day hour:minutes:seconds, when sampling started for the iops and bytes-per-second values. start-sample-time-numeric uint32 Unformatted start-sample-time value.
Table 60. initiator properties (continued) Name Type Description ● 0: Standard host-bus-type string ● If the host was discovered and its entry was automatically created, its host interface type: FC, iSCSI, SAS. ● If the host entry was manually created: Undefined. host-bus-type- numeric uint32 Numeric equivalents of host-bus-type values. ● 0: UNKNOWN ● 6: FC ● 8: SAS ● 9: iSCSI id string ● For an FC initiator, its WWPN. ● For a SAS initiator, its WWPN.
Table 62. inquiry properties (continued) Name Type Description serial-number string Controller serial number. mac-address string Controller network port MAC address. 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.
Table 63. io-modules properties (continued) Name Type Description ● ● ● ● Left Right Top Bottom position-numeric uint32 Numeric equivalents for position values. ● 0: Left ● 1: Right ● 2: Top ● 3: Bottom rotation string Rotation of the controller module in the enclosure. ● 0 Degrees ● 90 Degrees ● 180 Degrees ● 270 Degrees rotation-numeric string Numeric equivalents for position values.
Table 63. io-modules properties (continued) Name Type Description ● Unknown health-numeric uint32 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 415.
Table 65. ipv6-network-parameters properties (continued) Name Type Description ● 0: A ● 1: B firewall string ● Enabled ● Disabled firewall-numeric uint32 Numeric equivalents for firewall values. ● 0: Disabled ● 1: Enabled autoconfig string ● Enabled ● Disabled autoconfig-numeric uint32 Numeric equivalents for autoconfig values. ● 0: Disabled ● 1: Enabled gateway string The gateway IP address. link-local-address string The link-local IPv6 address.
Table 66. iscsi-parameters properties (continued) Name Type Description ● 1: Enabled isns string Shows whether support for Internet Storage Name Service (iSNS) is enabled. ● Enabled: iSNS is enabled. ● Disabled: iSNS is disabled. isns-numeric uint32 Numeric equivalents for isns values. ● 0: Disabled ● 1: Enabled isns-ip string Address of the iSNS server. The default address is all zeroes. isns-alt-ip string Address of the alternate iSNS server. The default address is all zeroes.
Table 67. iscsi-port properties (continued) Name Type Description sfp-status-numeric uint32 Numeric equivalents for sfp-status values. ● 0: Not compatible ● 1: Incorrect protocol ● 2: Not present ● 3: OK sfp-present string Shows whether the port contains an SFP. ● Not Present ● Present sfp-present-numeric uint32 Numeric equivalents for sfp-present values. ● 0: Not Present ● 1: Present sfp-vendor string The SFP vendor. sfp-part-number string The SFP part number.
Table 68. license properties (continued) Name Type Description ● 0: Never ● 255: Expired ● days: Number of days remaining virtualization string Shows whether the capability to create and manage virtual pools is enabled or disabled. ● Disabled: The capability is disabled. ● Enabled: The capability is enabled. virtualization-numeric uint32 Numeric equivalents for virtualization values. ● 0: Disabled ● 1: Enabled virtualization-expiry string Shows when the virtualization license will expire.
Table 68. license properties (continued) Name Type Description remote-snapshot-replicationexpiry string Shows when the volume replication feature will expire. ● Never: License is purchasable and doesn't expire. ● days: Number of days remaining for a temporary license. ● Expired: Temporary license has expired and cannot be renewed. remote-snapshot-replicationexpiry-numeric uint32 Numeric equivalents for remote-snapshot-replication values.
Table 68. license properties (continued) Name Type Description dsd-expiry-numeric uint32 Numeric equivalents for dsd-expiry values. ● 0: Never sra string Shows whether Storage Replication Adapter (SRA) support is enabled. ● Disabled: SRA is disabled. ● Enabled: SRA is enabled. sra-numeric uint32 Numeric equivalents for sra values. ● 0: Disabled ● 1: Enabled sra-expiry string Shows when the SRA feature will expire. ● Never: License and doesn't expire.
Table 71. log-header-table properties (continued) Name Type Description log-email string Email address of the contact person, if specified in the PowerVault Manager Save Logs panel. log-phone string Phone number of the contact person, if specified in the PowerVault Manager Save Logs panel. log-comments string Comments describing the problem and specifying the date and time when the problem occurred, if specified in the PowerVault Manager Save Logs panel.
Table 74. network-parameters properties Name Type Description durable-id string Controller network port ID in the format mgmtport_controller-ID active-version uint32 The configured network port IP version. ● 4: IPv4 ● 6: IPv6 ip-address string Controller network port IP address. gateway string Controller network port gateway IP address subnet-mask string Controller network port IP subnet mask mac-address string Controller network port MAC address.
Table 74. network-parameters properties (continued) Name Type Description ping-broadcast string ● Enabled: The system will respond to a broadcast ping. Disabled: The system will not respond to a broadcast ping. ping-broadcast-numeric uint32 Numeric equivalents for ping-broadcast values. ● 0: Disabled ● 1: Enabled ntp-status This basetype is used by show ntp-status on page 217. Table 75.
peer-connections This basetype is used by show peer-connections on page 217. Table 77. peer-connections properties Name Type Description peer-connection-name string The name of the peer connection. serial-number string The serial number of the peer connection. connection-type string The type of ports being used for the peer connection: ● FC ● iSCSI connection-type-numeric uint32 Numeric equivalents for connection-type values.
Table 78. peer-controllers properties (continued) Name Type Description mc-fw string Management Controller firmware version. mc-loader string Management Controller loader firmware version ec-fw string Controller firmware version. pld-rev string Complex Programmable Logic Device (CPLD) firmware version. hw-rev string Controller hardware version. ip-address string Controller network port IP address. host-name string The remote host name.
Table 80. pool-hist-statistics properties Name Type Description number-of-ios uint64 The total number of read and write operations since the last sampling time. number-of-reads uint64 The number of read operations since the last sampling time. number-of-writes uint64 The number of write operations since the last sampling time. total-data-transferred string The total amount of data read and written since the last sampling time.
Table 81. pool-statistics properties (continued) Name Type Description pages-alloc-per-hour uint32 The rate, in pages per hour, 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.
pools This basetype is used by show configuration on page 173 and show pools on page 219. Table 83. pools properties Name Type Description name string The name of the pool. serial-number string The serial number of the pool. url string Pool URL. storage-type string ● Linear: Linear pool. ● Virtual: Virtual pool. storage-type- numeric uint32 Numeric equivalents for storage-type values. ● 0: Linear ● 1: Virtual blocksize uint32 The size of a block, in bytes.
Table 83. pools properties (continued) Name Type Description middle-threshold string The middle threshold for page allocation as a percentage of pool capacity. high-threshold string The high threshold for page allocation as a percentage of pool capacity. The threshold value is automatically calculated based on the available capacity of the pool minus 200 GB of reserved space. utility-running string Job running on the disk, if any. ● (blank): None. ● DRSC: The disk group is being scrubbed.
Table 83. pools properties (continued) Name Type Description migration string For internal use only. migration-numeric uint32 For internal use only. zero-scan string For internal use only. zero-scan-numeric uint32 For internal use only. idle-page-check string For internal use only. idle-page-check-numeric uint32 For internal use only. read-flash-cache string For internal use only. read-flash-cache-numeric uint32 For internal use only.
Table 83. pools properties (continued) Name Type Description ● 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 actions to take to resolve the health issue. disk-groups Embedded; see disk-groups on page 315. tiers Embedded; see tiers on page 413. unhealthy-component Embedded; see unhealthy-component on page 415.
Table 84. port properties (continued) Name Type Description status-numeric uint32 Numeric equivalents for status values. ● 0: Up ● 1: Warning ● 2: Error ● 3: Not Present ● 6: Disconnected actual-speed string Actual link speed in Mbit/s or Gbit/s. ● 10Mb ● 100Mb ● 1Gb ● 4Gb ● 6Gb ● 8Gb ● 12Gb ● 16Gb ● (blank): Port is disconnected. actual-speed-numeric uint32 Numeric equivalents for actual-speed values.
Table 84. port properties (continued) Name Type Description ● 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 actions to take to resolve the health issue. port-details Embedded; see fc-port on page 350, iscsi-port on page 360, sas-port on page 387 power-supplies This basetype is used by show power-supplies on page 227. Table 85.
Table 85. power-supplies properties (continued) Name Type Description mfg-date-numeric uint32 Unformatted mfg-date value. mfg-location string City, state/province, and country where the FRU was manufactured. mfg-vendor-id string JEDEC ID of the FRU manufacturer. configuration-serialnumber string Configuration serial number. dc12v uint32 dc5v uint32 Deprecated; power-supply sensor status is shown by the sensors on page 393 property.
Table 86. product-info properties Name Type Description vendor-name string Vendor name. product-id string Product model identifier. scsi-vendor-id string Vendor name returned by the SCSI INQUIRY command. provisioning This basetype is used by show provisioning on page 229. Table 87. provisioning properties Name Type Description volume string ● Volume name. ● Blank if the disk group or pool does not have a volume. volume-serial string Volume serial number.
proxy-information This basetype is used by show support-assist on page 245. Table 88. proxy-information properties Name Type Description proxy-state string ● Disabled : Use of a proxy host for SupportAssist is disabled. ● Enabled : Use of a proxy host for SupportAssist is enabled. proxy-state-numeric uint32 Numeric equivalents for proxy-state-numeric values. ● 0: Disabled ● 1: Enabled host string The proxy host ID. port string The proxy host port number.
Table 90. readcache-hist-statistics properties (continued) Name Type Description total-data-transferrednumeric uint64 Unformatted total-data-transferred value. data-read string The amount of data read since the last sampling time. data-read-numeric uint64 The amount of data written since the last sampling time. data-written string The amount of data written since the last sampling time. data-written-numeric uint64 The amount of data written since the last sampling time.
Table 91. redundancy properties (continued) Name Type Description redundancy-mode-numeric uint32 Numeric equivalents for redundancy-modevalues. ● 1: Independent Cache Performance Mode ● 2: Active-Active ULP ● 3: Single Controller ● 4: Failed Over ● 5: Down redundancy-status string ● Redundant with independent cache : Both controllers are operational but are not mirroring their cache metadata to each other. ● Redundant : Both controllers are operational.
Table 91. redundancy properties (continued) Name Type Description ● 1496: Unknown refresh-counters This basetype is used by show refresh-counters on page 233 Table 92. 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.
Table 95. remote-system properties (continued) Name Type Description ● Uninitialized Contact : The default value. system-location string ● The location of the remote system. ● Uninitialized Location : The default value. system-information string ● A brief description of the remote system. ● Uninitialized Info : The default value. vendor-name string The vendor name of the remote system. product-id string The product model identifier of the remote system.
Table 95. remote-system properties (continued) Name Type Description ● 0: False ● 1: True isvalid-ip-b string ● False : The IP address is not valid for controller B in the remote system. ● True : The IP address is valid for controller B in the remote system. isvalid-ip-b- numeric uint32 Numeric equivalents for isvalid-ip-b values. ● 0: False ● 1: True replication-snapshot-history This basetype is used by show replication-snapshot-history on page 236. Table 96.
Table 96. replication-snapshot-history properties (continued) Name Type Description current- replicationsnapshots Embedded; see current-replication-snapshots on page 310. reset-snapshot-tasks This basetype is used by show tasks on page 250 for a ResetSnapshot operation. Table 97. reset-snapshot-tasks properties Name Type Description snapshot-name string Name of the snapshot to reset. snapshot-serial string Serial number of the snapshot to reset.
Table 98. resettable-statistics properties (continued) Name Type Description avg-write-rsp-time uint32 The average response time, in microseconds, for write operations since the last sampling time. sas-host-phy-statistics This basetype is used by show host-phy-statistics on page 208. Table 99. sas-host-phy-statistics properties Name Type Description port string The controller ID and port number. phy uint32 The logical location of the PHY within a group, based on the PHY type.
Table 101. sas-status-controller-a properties (continued) Name Type ● 1 : Bottom (5U84 enclosure) drawer-id Description uint8 Not applicable ( 255 ). expander-id uint8 Expander ID. controller string ● A : Controller A. ● B : Controller B. controller-numeric uint32 Numeric equivalents for controller values. ● 0: B ● 1: A wide-port-index uint32 The wide-port index. phy-index uint32 The PHY index. wide-port-role string The wide-port role.
Table 101. sas-status-controller-a properties (continued) Name Type Description ● ● ● ● ● ● ● ● ● ● ● ● Expander-Ingress-1 : Expansion port 1 ingress PHY. Ingress : Expansion port ingress PHY. Inter-Exp : Inter-expander PHY. SC : Storage Controller PHY. SC-0 : Storage Controller primary PHY. SC-1 : Storage Controller alternate PHY. SC-A : Storage Controller alternate PHY. SC-P : Storage Controller primary PHY. SCA- A : Storage Controller A alternate PHY. SCA-P : Storage Controller A primary PHY.
Table 101. sas-status-controller-a properties (continued) Name Type Description ● 0: Enabled ● 1: Disabled elem-reason string More information about the status value. ● Blank if elem-status is OK. ● Error count interrupts : PHY disabled because of error-count interrupts. ● PHY control : PHY disabled by a SES control page as a result of action by a Storage Controller or user. ● Not ready : PHY is enabled but not ready. Appears for SC-1 PHYs when the partner I/O module is not installed.
sas-status-drawer This basetype is used by show expander-status on page 199 and has the same properties as sas-statuscontroller-a on page 387. schedules This basetype is used by show schedules on page 238. Table 102. schedules properties Name Type Description name string Schedule name. schedule-specification string Schedule settings for running the associated task. status string Schedule status. ● Uninitialized : The schedule is not yet ready to run.
Table 103. security-communications-protocols properties (continued) Name Type Description cli-telnet string ● Disabled : The standard CLI is disabled. ● Enabled : The standard CLI is enabled. cli-telnet-numeric uint32 Numeric equivalents for cli-telnet values. ● 0: Disabled ● 1: Enabled cli-ssh string ● Disabled : The secure shell CLI is disabled. ● Enabled : The secure shell CLI is enabled. cli-ssh-numeric uint32 Numeric equivalents for cli-ssh values.
Table 103. security-communications-protocols properties (continued) Name Type Description ● 1: Enabled debug-interface string ● Disabled : The Telnet debug port is disabled. ● Enabled : The Telnet debug port is enabled. debug-interface-numeric uint32 Numeric equivalents for debug-interface values. ● 0: Disabled ● 1: Enabled inband-ses string ● Disabled : The in-band SES interface is disabled. ● Enabled : The in-band SES interface is enabled.
Table 104. sensors properties (continued) Name Type Description ● B : Controller B. ● both : Both controllers. ● N/A controller-id-numeric uint32 Numeric equivalents for controller-id values. ● 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.
Table 104. sensors properties (continued) Name Type Description sensor-type string ● ● ● ● ● sensor-type-numeric uint32 Numeric equivalents for sensor-type values. ● 0: Temperature ● 1: Current ● 2: Voltage ● 3: Charge capacity ● 4: Unknown Type Temperature Voltage Current Charge Capacity Unknown Type service-tag-info This basetype is used by show service-tag-info on page 240. Table 105.
Table 106. sessions properties (continued) Name Type Description ● 11: Chinese-simplified host string For a CLI session, the IP address and port number of the connected system. state uint32 ● Active ● Expired 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.
Table 108. shutdown-status properties (continued) Name Type Description status-numeric uint32 Numeric equivalents for status values. ● 0: up ● 1: down ● 2: not installed sideplanes This basetype is used by show enclosures on page 196. Table 109. sideplanes properties Name Type Description durable-id string Sideplane ID. enclosure-id uint32 Enclosure ID. drawer-id uint8 ● 0 : Top ● 1 : Bottom uint8 Not applicable ( 255 ).
Table 109. sideplanes properties (continued) Name Type Description ● ● ● ● ● ● 2: 3: 4: 5: 6: 7: Critical Warning Unrecoverable Not Installed Unknown 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. ● 0x01: Not powered ● 0x02: Cable fault ● 0x03: Other fault health string ● ● ● ● ● health-numeric uint32 Numeric equivalents for health values.
Table 110. snap-space properties (continued) Name Type Description 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. limit-policy string The limit policy for when the percentage of the pool designated for snapshots is reached. ● notify-only : When the snapshot space is reached an event is generated and logged.
Table 111. snapshots properties (continued) Name Type Description ● ● ● ● ● 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. volume-parent string The name of the volume of which the snapshot was taken. base-volume string The root of the snapshot tree, if any.
Table 111. snapshots properties (continued) Name Type Description snapshot-type-numeric uint64 Numeric equivalents for snapshot-type values. ● 0x00004000: Standard snapshot ● 0x00000000: N/A storage-type string ● Linear : Linear pool. ● Virtual : Virtual pool. storage-type-numeric uint64 Numeric equivalents for storage-type values. ● 0: Linear ● 1: Virtual total-size string The total size of the snapshot. total-size-numeric uint64 Unformatted total-size value in blocks.
Table 114. snmp-parameters properties Name Type Description snmp-enabled string Shows whether the Simple Network Management Protocol (SNMP) interface is enabled or disabled. ● Disabled—SNMP is disabled. ● Enabled—SNMP is enabled. snmp-enabled- numeric uint32 Numeric equivalents for snmp-enabled values. ● 0: Disabled ● 1: Enabled snmp-filter string Minimum level of events to include for SNMP traps ● crit—Sends notifications for Critical events only.
Table 115. spares-preview properties (continued) Name Type Description ● 11: SAS MDL tier string ● 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.
status This basetype is used by all commands except exit on page 79, help on page 84, and meta on page 86. 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 116. status properties Name Type Description response-type string ● ● ● ● Success: The command succeeded. Error: The command failed. Info: The command returned an informational message. Warning: The command returned a warning message.
support-assist This basetype is used by show support-assist. Table 118. support-assist properties Name Type Description support-assist-state string The current state of SupportAssist: ● Disabled ● Running ● Paused support-assist-state-numeric uint32 Numeric equivalents for support-assist-state values: ● 0: Disabled ● 1: Running ● 2: Paused support-assist-operationmode string The SupportAssist operation mode. ● Normal: The service is operating normally.
Table 119. syslog-parameters properties (continued) Name Type Description ● 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. syslog-notification-levelnumeric uint32 Numeric equivalents for syslog-notification-level values.
Table 120. system properties (continued) Name Type Description other-MC-status string The operational status of the Management Controller in the partner controller. This is not factored into system health. ● Operational ● Not Operational ● Not Communicating ● Unknown other-MC-status- numeric uint32 Numeric equivalents for other-mc-status values.
Table 121. system-parameters-table properties (continued) Name Type Description Unit Access (ALUA) extensions, in SPC-3, to negotiate paths with aware host systems. Unaware host systems see all paths as being equal. profiles-enabled string Shows whether host profiles are enabled. ● true: Host profiles are enabled. ● false: Host profiles are disabled. max-ports uint32 Number of host-interface ports in the controller enclosure. max-drives uint32 Number of disks that the system supports.
Table 121. system-parameters-table properties (continued) Name Type Description ● 0: B ● 1: A serial-number string Last six digits of the midplane serial number. external-targetid-control string Not used. external-targetid-controlnumeric uint32 Not used. lan-heartbeat string Not used. lan-heartbeat-numeric uint32 Not used. ip-address-mode string ● CAPI_TWO_IP_ADDRESSES_MODE: Dual controller system has a unique IP address for each controller.
Table 121. system-parameters-table properties (continued) Name Type Description ● 0: False ● 1: True max-adapt-drives-per-diskgroup uint32 The maximum number of disks that an ADAPT disk group can contain. min-adapt-drives-per-diskgroup uint32 The minimum number of disks that an ADAPT disk group can contain. max-adapt-disk-groups-persystem uint32 The maximum number of ADAPT disk groups that the system supports.
Table 122. tasks properties (continued) Name Type Description ○ RenameSnap ● For a ResetSnapshot task: ○ Start ○ VerifySnap ○ UnmapSnap ○ ResetSnap ● For a Replicate task: ○ Idle ○ Replicate ○ VerifyRunning error-message string ● If an error occurred while processing the task, the error message. ● Blank if no error has occurred. associated-vdisk-serial string Not applicable.
Table 123. tier-hist-statistics properties (continued) Name Type Description 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. number-of-page-moves-in uint64 The number of pages moved into this tier from a different tier. number-of-page-moves-out uint64 The number of pages moved out of this tier to other tiers.
Table 124. tier-statistics properties (continued) Name Type Description pages-reclaimed uint32 The number of 4 MB pages that have been automatically reclaimed and deallocated because they are empty (they contain only zeroes for data). num-pages-unmap-perminute uint32 The number of 4 MB pages that host systems have unmapped per minute, through use of the SCSI UNMAP command, to free storage space as a result of deleting files or formatting volumes on the host.
Table 126. tiers properties (continued) Name Type Description tier-numeric uint32 Numeric equivalents for tier values. ● 0: N/A ● 1: Performance ● 2: Standard ● 4: Archive ● 8: Read Cache pool-percentage uint8 The percentage of pool capacity that the tier occupies. diskcount uint8 The number of disks in the tier. raw-size string The raw capacity of the disks in the tier, irrespective of space reserved for RAID overhead and so forth, formatted to use the current base, precision, and units.
unhealthy-component This basetype is used by all commands that show component health. Table 128. unhealthy-component properties Name Type Description component-type string Component type.
Table 128. unhealthy-component properties (continued) Name Type Description ● 21: host ● 25: volume map ● 26: 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. ● OK ● Degraded ● Fault ● Unknown ● N/A health-numeric uint32 Numeric equivalents for health values.
Table 129. unused-disks-preview properties (continued) Name Type Description ● ● ● ● ● 0: 1: 2: 4: 8: N/A Permance Standard Archive Read Cache size string Disk group capacity, formatted to use the current base, precision, and units. size-numeric uint64 Unformatted size value in blocks. rpm uint32 The speed of a spinning disk, in thousands of revolutions per minute, as specified by the disk vendor. For an SSD, 0 is shown. sector-format string The disk sector format.
users This basetype is used by show users. Table 131. users properties Name Type Description username string User name. roles string ● monitor: User can view but not change system settings. ● manage: User can view and change system settings. ● diagnostic: User can view and change system settings. user-type string The experience level of the user: Novice , Standard , Advanced , or Diagnostic . This parameter does not affect access to commands.
Table 131. users properties (continued) Name Type Description ● MB: Megabytes. ● GB: Gigabytes. ● TB: Terabytes. Based on the precision setting, if the selected unit is too large to meaningfully display a size, the system uses a smaller unit for that size. For example, if units is set to TB, precision is set to 1, and base is set to 10, the size 0.11709 TB is instead shown as 117.1 GB. temperature-scale string ● Celsius: Use the Celsius scale to display temperature values.
Table 132. vdisk-hist-statistics properties (continued) Name Type Description data-written string Amount of data written since the last sampling time. data-written-numeric uint64 Unformatted data-written value. total-bytes-per-sec string Data transfer rate, in bytes per second, since the last sampling time. This is the sum of read-bytes-per-second and write-bytes-per-second. total-bytes-per-sec-numeric uint64 Unformatted total-bytes-per-second value.
Table 133. vdisk-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.
Table 134. versions properties (continued) Name Type Description him-rev string Host interface module revision. him-model string Host interface module model. backplane-type uint8 Backplane type. host-channel_revision uint8 Host interface hardware (chip) version. disk-channel_revision uint8 Disk interface hardware (chip) version. mrc-version string Memory Reference Code (MRC) version for Storage Controller boot Flash.
Table 136. virtual-disks properties (continued) Name Type Description ● B: Controller B. preferred-owner- numeric uint32 Numeric equivalents for preferred-owner values. ● 0: B ● 1: A raidtype string The disk-group RAID level. ● NRAID ● RAID0 ● RAID1 ● RAID3 ● RAID5 ● RAID6 ● RAID10 ● RAID50 ● ADAPT raidtype-numeric uint32 Numeric equivalents for raidtype values.
Table 136. virtual-disks properties (continued) Name Type Description ● OFFL: Offline. Either the disk group is using offline initialization, or its disks are down and data may be lost. ● QTCR: Quarantined critical. The disk group is critical with at least one inaccessible disk. For example, two disks are inaccessible in a RAID-6 disk group or one disk is inaccessible for other fault-tolerant RAID levels.
Table 136. virtual-disks properties (continued) Name Type Description current-job string Job running on the disk group, if any. ● (blank): No job is running. ● 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 disk group is being reconstructed. ● VDRAIN: The virtual disk group is being removed and its data is being drained to another disk group.
Table 136. virtual-disks properties (continued) Name Type Description ● 2: Partial spin-down ● 3: Full spin-down disk-dsd-delay-vdisk uint32 For spinning disks, the period of inactivity after which the disks and dedicated spares in a disk group will automatically spin down, from 1 to 360 minutes. The value 0 means spin down is disabled. pool-sector-format string The sector format of disks in the disk group. ● 512n: All disks use 512-byte native sector size.
Table 137. volume-groups (continued) Name Type Description member-count uint32 The number of volumes in the volume group. replication-set- serial string The serial number of the replication set. volumes Embedded; see volumes on page 429. volume-group-view This basetype is used by show maps if volume groups exist. Table 138. volume-group-view properties Name Type Description durable-id string Volume group ID. serial-number string The serial number of the volume group.
Table 139. volume-group-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. 0: Standard lun-view Embedded; see volume-view-mappings on page 435.
Table 141. volume-reservations (continued) Name Type Description ● Write Exclusive: Write commands are only allowed for a single reservation holder. ● Exclusive Access: Certain access (read, write) commands are only allowed for a single reservation holder. ● Write Exclusive - Registrants Only: Write commands are only allowed for registered hosts. There is a single reservation holder. ● Exclusive Access - Registrants Only: Certain access (read, write) commands are only allowed for registered hosts.
Table 142. volumes properties (continued) Name Type Description storage-type-numeric uint32 Numeric equivalents for storage-type values. ● 0: Linear ● 1: Virtual preferred-owner string Controller that owns the volume during normal operation. ● A: Controller A. ● B: Controller B. preferred-owner-numeric uint32 Numeric equivalents for preferred-owner values.
Table 142. volumes properties (continued) Name Type Description read-ahead-size-numeric uint32 Numeric equivalents for read-ahead-size values. ● -2: Stripe ● -1: Adaptive ● 0: Disabled ● 524288: 512 KB ● 1048576: 1 MB ● 2097152: 2 MB ● 4194304: 4 MB ● 8388608: 8 MB ● 16777216: 16 MB ● 33554432: 32 MB ● 2147483648: Maximum volume-type string ● base: Base volume ● standard: Standard volume. ● snapshot: Snapshot volume. volume-type-numeric uint32 Numeric equivalents for volume-type values.
Table 142. volumes properties (continued) Name Type Description ● 1: high ● 2: medium ● 3: low volume-qualifier string ● N/A: Not applicable. raidtype string The RAID level of the disk group. ● NRAID ● RAID0 ● RAID1 ● RAID3 ● RAID5 ● RAID6 ● RAID10 ● RAID50 ● ADAPT raidtype-numeric uint32 Numeric equivalents for raidtype values.
Table 142. volumes properties (continued) Name Type Description ● On: The volume is the secondary volume in a replication set. cs-secondary-numeric uint32 Numeric equivalents for cs-secondary values. ● 0: Off ● 1: On health string Numeric equivalents for health values. ● OK ● Degraded ● Fault ● Unknown ● N/A health-numeric uint32 Numeric equivalents for health values.
Table 143. volume-statistics properties (continued) Name Type Description data-written string The amount of data written since these statistics were last reset or since the controller was restarted. data-written-numeric uint64 Unformatted data-written value. allocated-pages uint32 The number of pages allocated to the volume. percent-tier-ssd uint16 The percentage of volume capacity occupied by data in the Performance tier.
volume-view This basetype is used by show maps. Table 144. 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 145. volume-view-mappings properties (continued) Name Type Description 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 146.
Table 146.
Table 146.