HP MSA 2040 CLI Reference Guide Abstract This guide provides information about managing an HP MSA 2040 storage system by using its command-line interface (CLI).
© Copyright 2014 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 Using the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Accessing the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLI output formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using CLI interactively . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
create volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . create volume-set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . delete all-master-volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . delete all-snapshots. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
scrub volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . set advanced-settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . set auto-write-through-trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . set awt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
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 show show show 6 controller-date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . controllers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
show volumecopy-status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . show volume-maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . show volume-names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . show volume-reservations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . show volumes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
log-header-table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . master-volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . network-parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ntp-status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5 Support and other resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517 Contacting HP . . . . . . . . . . . . . . . . . . . . Subscription service . . . . . . . . . . . . . . Product advisories . . . . . . . . . . . . . . . Related information. . . . . . . . . . . . . . . . . Typographic conventions . . . . . . . . . . . . . .. .. .. .. .. .. .. .. .. .. . . . . . .. .. .. .. .. .. .. .. .. .. . . . . . .. .. .. .. .. . . . . . .. .. .. .. .. .. .. ..
Contents
Tables 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 Default usernames and passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 XML API elements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Keyboard shortcuts for command completion, editing, and history . . . . .
56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 12 refresh-counters properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . remote-addresses properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . remote-links properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1 Using the CLI This chapter introduces the HP MSA 2040 command-line interface (CLI). Accessing the CLI The CLI software embedded in the controller modules enables you to manage and monitor storage-system operation. You can access the CLI in two ways: • By using HTTP, HTTPS, Telnet, an SSH application, or a terminal emulator on a management host that is remotely connected through a LAN to a controller module’s network port.
Using CLI interactively By default the CLI is an interactive application. When you are logged into the CLI, the CLI waits for a command to be entered and then responds to it. The following example shows interactively starting a Telnet session, logging into the CLI, executing a command to show free (available) disks, and exiting the CLI: $: telnet IP-address IP-address System Version: version MC Version: version Serial Number: SN 172.22.5.
} $ipAddr = $ARGV[0]; $username = $ARGV[1]; $password = $ARGV[2]; $telnet = new Net::Telnet ( Timeout=>10, Errmode=>'die', Prompt => '/\# $/i'); if ( !cLogin($ipAddr, $username, $password) == 1 ) { print("Error: $username user failed to log in. Exiting.\n"); $telnet->close; exit(0); } For scripting support, the following command can be used to access the XML API and to disable the paging mode that pauses for each full screen of command output.
my $sessionKey; foreach my $prop ( @props ) { my $name = $prop->getAttribute('name'); print "Property = " . $name . "\n"; if( $name eq 'response' ) { $sessionKey = $prop->textContent; } } print "Session Key = $sessionKey\n"; # Run a sample command to obtain the disks in the system. $url = 'http://10.0.0.2/api/show/disks'; $req = HTTP::Request->new(GET => $url); $req->header('sessionKey' => $sessionKey ); $req->header('dataType' => 'ipa' ); $res = $ua->request($req); $url2 = 'http://10.0.0.
Table 2 Element XML API elements Description and attributes RESPONSE The RESPONSE element is the top-level element, which contains all data output for the CLI command that was issued. The response includes: • • A number of OBJECT elements, which varies by command. A status object that provides a message and return code. A return code of 0 indicates that the command succeeded. Any other return code is an error code. There is only one RESPONSE element per issued command.
The following example shows the XML API status object:
XML API optimization The following are two ways to optimize XML API 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. The name and type attributes are always returned.
Command syntax General rules for specifying commands Command names and parameter names are not case sensitive. Parameters enclosed in square brackets ([]) are optional. Do not type the bracket characters. Parameter values separated by ’|’ characters are options. Enter only one of the values. Unless specified otherwise, enumerated values are not case sensitive. Parameter values in italics are variables. Substitute text that is appropriate for the task you want to perform.
User password rules A user password is case sensitive and must contain 8–32 characters. A password cannot contain the following characters: angle brackets, backslash, comma, double quote, single quote, or space. If the password contains only printable ASCII characters then it must contain at least one uppercase character, one lowercase character, and one non-alphabetic character. This rule does not apply if the password contains UTF-8 characters that are outside the range of printable ASCII characters.
Size representations Parameters such as names of users and volumes have a maximum length in bytes. ASCII characters are 1 byte; most Latin (Western European) characters with diacritics are 2 bytes; most Asian characters are 3 bytes. Operating systems usually show volume size in base 2. Disk drives usually show size in base 10. Memory (RAM and ROM) size is always shown in base 2.
2 Categorical list of commands Current commands by category The following table helps you find a command within a category of functionally related commands. A command might appear in more than one category.
Table 6 Commands by category (continued) Category Commands Snapshots convert master-to-std expand snap-pool convert std-to-master reset snapshot create master-volume rollback master-volume create snap-pool set priorities create snapshots set snap-pool-policy delete all-master-volumes set snap-pool-threshold delete all-snapshots show master-volumes delete master-volume show priorities delete snap-pool show snap-pools delete snapshot show snapshots delete snapshot-write-data Volume co
Table 6 Commands by category (continued) Category Commands System clear cache configuration create certificate and utilities create chap-record Service utilities show cache-parameters show certificate show chap-records create temp-license show configuration delete chap-records show controller-date ping show controllers reset host-link show disk-parameters restart show enclosures set advanced-settings show expander-status set auto-write-through-trigger show fans set awt show frus set c
Table 6 Commands by category (continued) Category Commands Remote replication abort replication resume replication add replication-volume set replication-primary-volume create replication-set set replication-volume-parameters delete replication-set show replication-images detach replication-volume show replication-sets export snapshot show replication-volumes reattach replication-volume start vdisk remove replication-volume stop vdisk replicate snapshot suspend replication replicate v
Deprecated commands The following table lists commands that are deprecated and specifies other commands to use instead, if any. Deprecated commands remain usable in this release but may be removed in a future release. If you have scripts that use deprecated commands, update the scripts to use the replacement commands instead.
Table 8 Removed commands (continued) Removed command Replacement command set snap-pool policy set snap-pool-policy set snap-pool threshold set snap-pool-threshold show host-port-interconnects None – not applicable to MSA 2040 28 show iscsi-hosts show hosts show lun-maps show volume-maps Categorical list of commands
3 Alphabetical list of commands This chapter is organized to help you find a command by name.
abort replication Description Aborts the current replication operation for the specified secondary volume. The current replication may be running or suspended. This command must be issued on the system that owns the secondary volume. Syntax abort replication [set replication-set] replication-volume Parameters set replication-set Optional. The name or serial number of the replication set. replication-volume The name or serial number of the secondary volume.
abort scrub Description Aborts a scrub vdisk operation for specified vdisks or a scrub volume operation for specified volumes. Syntax abort scrub vdisk vdisks volume volumes Parameters vdisk vdisks A comma-separated list of the names or serial numbers of the vdisks to stop scrubbing. For vdisk syntax, see "Command syntax" (page 20). volume volumes A comma-separated list of the names or serial numbers of the volumes to stop scrubbing. For volume syntax, see "Command syntax" (page 20).
abort verify Description Aborts the verify vdisk operation for specified vdisks. Syntax abort verify vdisk vdisks Parameters vdisk vdisks A comma-separated list of the names or serial numbers of the vdisks to stop verifying. For vdisk syntax, see "Command syntax" (page 20). Example Abort verifying vdisk vd1: # abort verify vdisk vd1 Info: The verify was aborted on vdisk vd1. (vd1) (2012-01-20 15:40:31) Success: Command completed successfully.
abort volumecopy Description Aborts copying a volume. When the abort is complete, the destination volume is deleted. Syntax abort volumecopy volume Parameters volume The name or serial number of the source volume, the destination volume, or if a snapshot is being copied, its associated master volume. For volume syntax, see "Command syntax" (page 20). Example Abort creating destination volume vd1_copy: # abort volumecopy v1_copy Success: Command completed successfully.
add replication-volume Description Adds an existing secondary volume to a replication set. The volume can be in the same system as the primary volume or in a remote system. A secondary volume is a master volume created specifically for use as the destination for a replication by using the create master-volume command's prepare-replication-volume parameter. Secondary volumes serve as the destination for replicated data from the primary volume.
Example Add secondary volume MV2 to the replication set whose primary volume is MV1; set the replication priority to high; and allow a maximum of 2 queued images to be considered for replication: # add replication-volume link-type FC secondary-address wwpn=207000c0ffd52c31,217000c0ff52c31 primary-volume MV1 priority high max-queue 2 MV2 Info: Started adding the secondary volume to the replication set. (MV2) Info: Verifying that the secondary volume was added to the replication set.
clear cache Description Clears unwritable cache data from both controllers. This data cannot be 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. Unwritable cache is also called orphan data. NOTE: Only use this command when all vdisks are online.
clear disk-metadata Description Clears metadata from leftover disks. CAUTION: • Only use this command when all vdisks are online and leftover disks exist. Improper use of this command may result in data loss. • Do not use this command when a vdisk is offline and one or more leftover disks exist. If you are uncertain whether to use this command, contact technical support for further assistance.
Try to clear metadata from a disk that is not leftover: # clear disk-metadata 1.2 Error: The specified disk is not a leftover disk. (1.2) - Metadata was not cleared for one or more disks.
clear events Description Clears the event log in controller A, B, or both. For use by or with direction from technical support. Syntax clear events [a|b|both] Parameters a|b|both Optional. The controller event log to clear. If this parameter is omitted, both event logs are cleared. Example Clear the event log for controller A: # clear events a Success: Command completed successfully. - The event log was successfully cleared.
clear expander-status Description Clears the counters and status for SAS expander lanes. For use by or with direction from technical support. Counters and status can be reset to a good state for all enclosures, or for a specific enclosure whose status is Error as shown by the show expander-status command. 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.
clear fde-keys Description Removes the lock keys used with Full Disk Encryption. This command clears the lock key ID and import lock ID. The disks in the system will remain in the Secured, Unlocked state until the disk or enclosure is powered off. To regain access to the encrypted disk information, you must restore the lock key ID using the original passphrase. To restore the lock key ID, use the set fde-lock-key command.
convert master-to-std Description Converts a specified master volume into a standard volume. This disables snapshot functionality for the volume. If the specified volume has associated snapshots, you must delete the snapshots before converting the volume. Syntax convert master-to-std master-volume Parameters master-volume The name or serial number of the master volume to convert. For volume syntax, see "Command syntax" (page 20).
convert std-to-master Description Converts a standard volume to a master volume. This enables snapshot functionality for the volume and associates it with an existing snap pool. The standard volume and the snap pool must be owned by the same controller, though they can be in different vdisks. Syntax convert std-to-master snap-pool snap-pool standard-volume Parameters snap-pool snap-pool The name or serial number of the snap pool to associate with the new master volume.
create certificate Description Creates or removes a custom security certificate. The storage system supports use of unique certificates for secure data communications, to authenticate that the expected storage systems are being managed. Use of authentication certificates applies to the HTTPS protocol, which is used by the web server in each controller module. After using this command you must restart the system's Management Controllers to have the change take effect.
Restore the original certificate that existed before the custom one was generated: # create certificate restore To make the certificate change take effect you must restart both Management Controllers by entering "restart mc both". Press Enter to acknowledge this message. Success: Command completed successfully. - Security certificate restored.
create chap-record Description For iSCSI, creates a CHAP record to authenticate login requests. When CHAP is enabled, the record enables authentication between the originator (initiator) and recipient (target) of a login request. This command is permitted whether or not CHAP is enabled. The CHAP record can specify one name-secret pair to authenticate the originator only (one-way CHAP) or two pairs to authenticate both the originator and the recipient (mutual CHAP).
create host Description Creates a host entry with an associated nickname. Use this to create an entry for a host that is not automatically discovered or to create a nickname for an automatically discovered host. When mapping volumes to hosts the nickname can make a host easy to recognize. Syntax create host id ID nickname [profile standard|hp-ux] Parameters id ID For FC and SAS, the host node's 16-hex-digit WWPN. The value can include a colon between each byte but the colons will be discarded.
create master-volume Description Creates a volume that is enabled for snapshots. The master volume is created in a specified vdisk and is associated with a specified snap pool. You can either associate the master volume with an existing snap pool owned by the same controller, or optionally specify the size of a new snap pool to automatically create. The vdisk and snap pool must be owned by the same controller. Volume sizes are aligned to 4-MB boundaries.
Example Create the 20-GB master volume MV1 on vdisk VD1, and associate it with snap pool SP1: # create master-volume vdisk VD1 size 20GB snap-pool SP1 lun 3 MV1 Info: The volume was created. (MV1) Info: The volume was mapped. (MV1) (2012-01-18 12:30:22) Success: Command completed successfully.
create remote-system Description Creates a persistent association with a remote storage system. This allows a local system to track remote systems by their network-port IP addresses and cache their login credentials. The IP address you specify is used to connect to the remote system and obtain information such as the system name and both controllers' IP addresses. You can then use the system name or an IP address in commands that need to interact with the remote system.
create replication-set Description Creates a replication set from a specified standard or master volume. If you specify a standard volume, it is converted to a master volume using default policies for snap-pool creation. You can optionally use the reserve parameter to set the snap-pool size. The specified volume becomes the replication set's primary volume. You can specify a remote volume to be the replication set's secondary volume, or one will be created.
IMPORTANT: To replicate between an HP P2000 G3 MSA system and an HP MSA 2040 SAN system, the secondary volume must be exactly the same size as the primary volume. This can be complicated because the P2000 G3 MSA creates volumes that are 64-KB aligned while the MSA 2040 SAN creates volumes that are 4-MB aligned. When the volume is created or expanded the size will be decreased to the nearest alignment boundary.
max-queue # Optional. The number of replication images to consider when determining the next image to replicate: 1–64. Used only if the on-collision parameter is set to oldest. noprompt Optional in console format; required for XML API format. Suppresses the prompt to revert the transaction if the command fails, which requires a yes or no response. If this parameter is specified and the command fails, the transaction is automatically reverted. nowait Optional.
set name Optional. A name for the new replication set. The name is case sensitive; cannot include a comma, double quote, left angle bracket, or backslash; and can have a maximum of 32 bytes. A name that includes a space must be enclosed in double quotes. If this parameter is omitted, the set is named rsprimary-volume. snapshot snapshot Optional. A name for the replication snapshot that will be created during the replication process.
See also • add replication-volume • delete replication-set • remove replication-volume • replicate snapshot • show remote-systems • show replication-images • show replication-sets • show replication-volumes create replication-set 55
create schedule Description Schedules a task to run automatically. When scheduling ReplicateVolume tasks, a best practice is to schedule no more than three volumes to start replicating at the same time, and for those replications to recur no less than 60 minutes apart. If you schedule more replications to start at the same time, or schedule replications to start more frequently, some scheduled replications may not have time to complete.
Example Create schedule Sched1 that runs Task1 for the first time on March 1, 2012; runs daily between midnight and 1:00 AM; and runs for the last time in the morning of January 1, 2013: # create schedule schedule-specification "start 2012-03-01 00:01, every 1 days, between 12:00 AM and 1:00 AM, expires 2013-01-01 1:00 AM" task-name Task1 Sched1 Success: Command completed successfully. (Sched1) - The schedule was created.
create snap-pool Description Creates a snap pool to use for snapshot data. A snap pool is an internal volume and cannot be mapped. Syntax create snap-pool vdisk vdisk size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] name Parameters vdisk vdisk The name or serial number of the vdisk to create the snap pool in. For vdisk syntax, see "Command syntax" (page 20). size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] Sets the snap-pool size using the current base, as shown by the show cli-parameters command.
create snapshots Description Creates a snapshot of each specified source volume. The source volume can be a standard volume or a master volume. The first time a snapshot is created of a standard volume, the volume is converted to a master volume and a snap pool is created. The snap pool's size is either 20% of the volume size or 5.37 GB, whichever is larger. The recommended minimum size for a snap pool is 50 GB.
create task Description Creates a task that can be scheduled. You can create a task to enable or disable drive spin down; to take a snapshot of a standard or master volume; to reset a snapshot; to copy a standard, master, or snapshot volume to a new standard volume; or to replicate a replication set's primary volume to a remote system. The first time a snapshot or volume copy is created of a standard volume, the volume is converted to a master volume and a snap pool is created in the volume's vdisk.
Parameters type TakeSnapshot|ResetSnapshot|VolumeCopy|ReplicateVolume|EnableDSD| DisableDSD The task type: • TakeSnapshot: Takes a snapshot of a standard or master volume. • ResetSnapshot: Deletes the data in the snapshot and resets it to the current data in the associated master volume. The snapshot's name and other volume characteristics are not changed. • VolumeCopy: Copies a standard, master, or snapshot volume to a new standard volume.
replication-mode new-snapshot|last-snapshot Optional. Specifies whether to replicate a new snapshot of the volume to the remote system, or to replicate the last (most recent existing) snapshot of the volume to the remote system. • new-snapshot: Replicate a new snapshot. • last-snapshot: Replicate the most recent existing snapshot. If this parameter is omitted, a new snapshot is replicated. name A name for the new task.
create temp-license Description Creates and installs a temporary license to try licensed features of the storage system. You can create a temporary license one time. A temporary license will expire 60 days from the time it is created. If you do not install a permanent license before the temporary license expires, you cannot create new items using these features.
create user Description Creates a user account. The system supports 12 user accounts. You can create a general user that can access the WBI, CLI, or FTP interface, or an SNMPv3 user that can access the MIB or receive trap notifications. SNMPv3 user accounts support SNMPv3 security features such as authentication and encryption.
level monitor|manage|admin Optional. • monitor: User can view but not change system settings. This is the default. • manage: User can view and change system settings. • admin: User can view and change system settings. You cannot specify both this parameter and the roles parameter. locale English|en|Spanish|es|French|fr|German|de|Italian|it|Japanese|ja |Korean|ko|Dutch|nl|Chinese-simplified|zh-s|Chinese-traditional|zh-t Optional. The display language. The default is English.
temperature-scale celsius|c|fahrenheit|f Optional. Sets the scale for display of temperature values: • fahrenheit or f: Temperatures are shown in degrees Fahrenheit. • celsius or c: Temperatures are shown in degrees Celsius. This is the default. timeout # Optional. Sets the timeout value in seconds for the login session. Valid values are 120–43200 seconds (2–720 minutes). The default is 1800 seconds (30 minutes). trap-host IP-address Optional.
create vdisk Description Creates a vdisk using the specified RAID level, disks, and spares. When you create a vdisk, all its disks must be the same type: either SAS SSD, enterprise SAS, or midline SAS. For each RAID level, the minimum and maximum numbers of disks supported are: • NRAID: 1 • RAID 5: 3–16 • RAID 0: 2–16 • RAID 6: 4–16 • RAID 1: 2 • RAID 10: 4–16 • RAID 3: 3–16 • RAID 50: 6–32 For best practices for creating vdisks, see the SMU Reference Guide.
name A name for the new vdisk. The name is case sensitive; cannot include a comma, double quote, left angle bracket, or backslash; and can have a maximum of 32 bytes. A name that includes a space must be enclosed in double quotes. Example Create the RAID-1 vdisk VD1 using two disks in the first enclosure: # create vdisk level raid1 disks 1.1,1.3 VD1 Success: Command completed successfully.
create volume Description Creates a volume in a vdisk. 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. By default, this command will not map the created volume. CAUTION: Using a default mapping for a volume will allow multiple hosts to access the volume.
ports ports Optional. The ports through which the host can access the volume. All specified ports must be the same type (e.g., FC). For port syntax, see "Command syntax" (page 20). If this parameter is omitted, all ports are selected. snap-pool snap-pool Optional. Name or serial number of the snap pool to associate with the new volume. For volume syntax, see "Command syntax" (page 20). reserve size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] Optional. Size of the snap pool to create in the vdisk.
create volume-set Description Creates a specified number of volumes in a vdisk. You must specify a base name and a size for the volumes. You can create the volumes unmapped or set their 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 mappings by using the map volume and unmap volume commands. By default, this command will not map the created volumes.
access read-write|rw|read-only|ro|no-access Optional. Access privilege that hosts have to these volumes: read-write (rw), read-only (ro), or no-access. If no-access is specified, the volume is not mapped. The default is read-write. ports ports Optional. The controller ports through which hosts can access the volumes using LUNs specified by the baselun parameter. For port syntax, see "Command syntax" (page 20). If not all ports are specified, the unspecified ports are not mapped.
Create ten 20-GB volumes with the base name vd1_v in vdisk vd1, mapped starting with LUN 5 with read-only access through port A1, and show the results: # create volume-set count 10 size 20GB vdisk vd1 basename vd1_v baselun 5 access ro ports a1 Info: The volume was created. (vd1_v0000) ... Info: The volume was created. (vd1_v0009) Info: The volume was mapped. (vd1_v0000) ... Info: The volume was mapped. (vd1_v0009) Success: Command completed successfully.
delete all-master-volumes Description Deletes all master volumes associated with a specified snap pool. The volumes' schedules and tasks are also deleted. NOTE: You must delete all snapshots that exist for the master volumes before you can delete the master volumes. Syntax delete all-master-volumes snap-pool volume Parameters snap-pool volume The name or serial number of the snap pool whose master volumes should be deleted. For volume syntax, see "Command syntax" (page 20).
delete all-snapshots Description Deletes all snapshots associated with a specified volume. All data associated with the snapshots is deleted and their space in the snap pool is freed for use. The specified volume can be a master volume or a snap pool. The snapshots' schedules are also deleted. Syntax delete all-snapshots volume volume [delete-type all-standard-snapshots|all-replication-snapshots |all-snapshot-types] Parameters volume volume The name or serial number of the master volume or snap pool.
delete chap-records Description For iSCSI, deletes a specified CHAP record or all CHAP records. This command is permitted whether or not CHAP is enabled. Syntax To delete the CHAP record for a specific originator: delete chap-records name originator-name To delete all CHAP records: delete chap-records all Parameters name originator-name The originator name, typically in IQN format. all Delete all CHAP records in the database.
delete global-spare Description Deletes specified global spare disks. Syntax delete global-spare disks disks Parameters disks disks IDs of the global spares to delete. For disk syntax, see "Command syntax" (page 20). Example Delete two global spares: # delete global-spare disks 1.1,1.5 Info: Global spare disk 1.1 was deleted. (1.1) Info: Global spare disk 1.5 was deleted. (1.5) Success: Command completed successfully.
delete host Description Deletes a manually created host or the nickname of a discovered host. If the host is not mapped or has only default mappings, you can delete the host. If the host has explicit mappings, you must delete the mappings before you can delete the host. If you delete the nickname of a discovered host, commands will show the host by its ID. Syntax delete host host Parameters host The ID or nickname of the host.
delete master-volume Description Deletes a master volume. The volume's schedules and tasks are also deleted. NOTE: You must delete all snapshots that exist for the master volume before you can delete it. Syntax delete master-volume volume Parameters volume The name or serial number of the master volume to delete. For volume syntax, see "Command syntax" (page 20). Example Delete master volume MV1: # delete master-volume MV1 Success: Command completed successfully. (MV1) - The master volume was deleted.
delete remote-system Description Deletes the persistent association with a remote system. After establishing replication to a remote system, if you choose to delete the remote system you can safely do so without affecting replications. However, because the remote system's name and IP address will no longer appear in user interfaces, record this information before deleting the remote system so that you can access it at a later time, such as to delete old replication images or for disaster recovery.
delete replication-set Description Deletes a replication set. The replication volumes associated with the replication set are converted to master volumes and any replication snapshots associated with the replication volumes are converted to standard snapshots. Snapshots are converted regardless of the number of snapshots allowed by the system's license. This command must be run on the primary system.
delete schedule Description Deletes a task schedule. If you no longer want a scheduled task to occur, you can delete the schedule. When a volume or snapshot is deleted, its schedules and tasks are also deleted. Syntax delete schedule schedule Parameters schedule The name of the schedule to delete. Example Delete schedule Sched1: # delete schedule Sched1 Success: Command completed successfully. (Sched1) - The schedule was deleted.
delete snap-pool Description Deletes a snap pool. NOTE: You must disassociate all master volumes from the snap pool before you can delete it. Syntax delete snap-pool snap-pool Parameters snap-pool The name or serial number of the snap pool to delete. For volume syntax, see "Command syntax" (page 20). Example Delete snap pool SP1: # delete snap-pool SP1 Success: Command completed successfully. (SP1) - The snap-pool was deleted.
delete snapshot Description Deletes specified snapshots. All data uniquely associated with the snapshot is deleted and associated space in the snap pool is freed for use. The snapshot's schedules are also deleted. Syntax delete snapshot [cleanup] [delete-priority standard-snapshot|volume-copy-snapshot|replication-snapshot |replicating-snapshot|common-sync-point-snapshot|only-sync-point-snapshot |queued-snapshot] [force] snapshots Parameters cleanup Optional.
delete snapshot-write-data Description Deletes data written to a standard snapshot after it was created. Deleting this modified data reverts the snapshot to the state when it was first taken. This command is not allowed for a replication snapshot. Syntax delete snapshot-write-data snapshot Parameters snapshot The name or serial number of the snapshot from which to delete modified data. For volume syntax, see "Command syntax" (page 20).
delete task Description Deletes a task. If the task is scheduled, a confirmation prompt will ask whether you want to delete the task and its schedules. Reply yes to delete both, or no to cancel the command. Syntax delete task task Parameters task The name of the task to delete. Example Delete unscheduled task Task1: # delete task Task1 Success: Command completed successfully. (Task1) - The task was deleted.
delete user Description Deletes a user account. You can delete any user, including the default users. 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. Syntax delete user [noprompt] name Parameters noprompt Optional in console format; required for XML API format. Suppresses the confirmation prompt, which requires a yes or no response.
delete vdisks Description Deletes specified vdisks. Unmaps and deletes all volumes and snapshots in the vdisks and frees all disks from the vdisks. CAUTION: Deleting a vdisk will delete all data on that vdisk. NOTE: You cannot delete a vdisk if it contains a snap pool that is associated with a master volume on another vdisk. NOTE: If you delete a quarantined vdisk and its missing disks are later found, the vdisk reappears as quarantined or offline and you must delete it again (to clear those disks).
delete vdisk-spare Description Deletes specified spares that are assigned to a vdisk. Syntax delete vdisk-spare disks disks vdisk Parameters disks disks IDs of the spares to delete. For disk syntax, see "Command syntax" (page 20). vdisk The name or serial number of the vdisk to delete the spares from. For disk syntax, see "Command syntax" (page 20). Example Delete spare disk 1.5 from vdisk VD1: # delete vdisk-spare disks 1.5 VD1 Info: Vdisk spare disk 1.5 was deleted. (1.
delete volumes Description Deletes specified volumes. CAUTION: Deleting a volume will delete all data in that volume and its schedules. Syntax delete volumes volumes Parameters volumes A comma-separated list of the names or serial numbers of the volumes to delete. For volume syntax, see "Command syntax" (page 20). Example Delete volumes V1 and V2: # delete volumes V1,V2 Info: Volume V1 was deleted. (V1) (2012-01-18 12:18:50) Info: Volume V2 was deleted.
dequarantine Description Removes a vdisk from quarantine. CAUTION: Carefully read this topic to determine whether to use the dequarantine command to manually remove a vdisk from quarantine. The dequarantine command should only be used as part of the emergency procedure to attempt to recover data and is normally followed by use of the CLI trust command.
When a vdisk is quarantined, its disks become write-locked, its volumes become inaccessible, and it is not available to hosts until it is dequarantined. If there are interdependencies between the quarantined vdisk’s volumes and volumes in other vdisks, quarantine may temporarily impact operation of those other volumes.
Example After determining that vdisk VD1 is quarantined, remove it from quarantine and re-check its status: # show vdisks Name ... Status ... ------------------VD1 ... QTDN ... (RAID 6 quarantined with a down disk) ------------------# dequarantine vdisk VD1 Info: Vdisk VD1 was dequarantined. (VD1) Success: Command completed successfully. (2013-08-01 14:06:09) # show vdisks Name ... Status ... ------------------VD1 ... FTDN ...
detach replication-volume Description Prepares a secondary volume to be physically removed from a system. When using the replication feature, if you chose to create a replication set's primary and secondary volumes in the primary system, you can perform the initial replication and then physically move the secondary volume's vdisk into the secondary system. The process to move a secondary volume is: 1. In the system where the secondary volume resides: a. Detach the secondary volume. b.
See also • reattach replication-volume • show replication-sets • show replication-volumes • start vdisk • stop vdisk detach replication-volume 95
down disk Description Simulates vdisk degradation due to loss of a disk. This command only applies to disks that are part of fault-tolerant vdisks. CAUTION: Do not use this command in a production system. Use only for testing. This command will interfere with the operation of any volumes in the vdisk, potentially causing data loss. When using this command, you should: 1.
exit Description Log off and exit the CLI session.
expand snap-pool Description Expands a snap pool. Expansion is restricted to the space available on the vdisk containing the snap pool. If insufficient space is available for expansion on the vdisk, first expand the vdisk by using expand vdisk.
expand vdisk Description Adds disks to a vdisk to expand its storage capacity. The new disks must be the same type as disks already in the vdisk and should also have the same capacity. NOTE: If you upgraded from an earlier release that did not distinguish between enterprise and midline SAS disks, you might have vdisks that contain both types of disks. For those vdisks, you can designate either or both types of disks for expansion.
Example Expand vdisk VD1 to include disk 1.11: # expand vdisk disks 1.11 VD1 Depending on several factors, vdisk expansion can take a significant amount of time to complete. The size of the physical disks in the original vdisk, the amount of capacity being added, and the level of I/O activity during expansion will influence the time of completion. It is strongly recommended to review the Best Practices white paper before starting a vdisk expansion. See the online help to access this white paper.
expand volume Description Expands a standard volume. Expansion is restricted to the space available in the vdisk containing the volume. Volume sizes are aligned to 4-MB boundaries. When a volume is created or expanded, if the resulting size would be less than 4 MB it will be increased to 4 MB; if the resulting size would be greater than 4 MB it will be decreased to the nearest 4-MB boundary. If insufficient space is available for expansion on the vdisk, first expand the vdisk by using expand vdisk.
export snapshot Description Exports a replication snapshot in the local system to a new standard snapshot. The standard snapshot will reside in the same snap pool, take a snapshot license, and be independent of the replication snapshot. The standard snapshot can used like any other standard snapshot, and changes to it will not affect the replication snapshot. The standard snapshot is subject to the snap pool's deletion policies.
fail Description Forces the partner controller module to crash for a non-maskable interrupt. The command causes the crash by issuing an internal kill command to the Storage Controller in the partner controller module. This might be helpful to gather debug information that is only available via a crash dump. CAUTION: Do not use this command in a production system. Use only for testing.
map volume Description Maps specified volumes using settings that override the volumes’ default mapping. When a volume is created, if no mapping settings are specified the volume is not mapped; otherwise, those settings become its default mapping, which specifies the controller host ports and access level that all connected hosts have to the volume, and the LUN presented to all hosts to identify the volume. The default mapping’s LUN is known as the volume’s default LUN.
ports ports Optional. The ports to use for the mapping; any unspecified ports become unmapped. All specified ports must be the same type (e.g., FC). If the ports parameter is specified, the lun parameter must also be specified. The ports parameter is ignored if access is set to no-access. If the ports parameter is omitted, all ports are mapped. Do not use the ports parameter with the mapping parameter. host hosts Optional. For FC and SAS, the nickname or 16-hex-digit WWPN of each host to map the volumes to.
# show volume-maps Volume View [Serial Number (SN) Name (v1) ] Mapping: Ports LUN Access Host-Port-Identifier Nickname Profile ----------------------------------------------------------------A1,B1 6 read-write 207000c0ff001121 Host1 Standard A1,B1 6 read-write 207000c0ff001122 Host2 Standard not-mapped all other hosts Standard Volume View [Serial Number (SN) Name (v2) ] Mapping: Ports LUN Access Host-Port-Identifier Nickname Profile ----------------------------------------------------------------A1,B1 7 rea
meta Description In XML API format only, shows all property metadata for objects. This includes data not shown in brief mode. Syntax meta basetypes Parameters basetypes A basetype or a list of basetypes separated by commas (with no spaces) to specify the objects for which to show metadata. For names and descriptions of supported basetypes, see "XML API basetype properties" (page 367).
ping Description Tests communication with a remote host. The remote host is specified by IP address. Ping sends ICMP echo response packets and waits for replies. Syntax ping host-address [count] Parameters host-address The remote host’s IP address in dotted decimal form. count 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. Example Send two packets to the remote computer at 10.134.50.6: # ping 10.134.
reattach replication-volume Description Reattaches a secondary volume to its replication set. Reattaching a secondary volume is the last part of the process for moving a secondary volume from a primary system into a secondary system. The process to move a secondary volume is: 1. In the system where the secondary volume resides: a. Detach the secondary volume. b. If the secondary volume’s vdisk contains other secondary volumes, detach those volumes. c. Stop the secondary volume’s vdisk. d.
See also • detach replication-volume • show replication-sets • show replication-volumes • start vdisk • stop vdisk 110
release volume Description Clears host registrations and releases persistent reservations for all or specified volumes. Normally, reservations placed on volumes by hosts accessing those volumes can be released by host software. This command should be used only when the system is in an abnormal state, perhaps due to a configuration problem, and you need to remove all reservations for specified volumes and return them to a “clean” state.
remote Description Runs a command on a remote system that is associated with the local system. If the command cannot connect to remote controller A, it tries to connect to remote controller B; if unsuccessful, the remote command is not run. Output is displayed in console or XML API format depending on the local system’s setting. Syntax remote system command Parameters system The name or network-port IP address of the remote system.
remove replication-volume Description Removes a secondary volume from a replication set. The secondary volume is converted to a master volume. Any replication snapshots associated with that volume are converted to standard snapshots, regardless of the number of snapshots allowed by the system’s license. You must run this command on the primary system. You cannot remove the primary volume.
replicate snapshot Description Initiates a replication operation using an existing snapshot as the data source. This command replicates the specified external standard snapshot. If the specified snapshot has not already been replicated on the replication volume, each replication volume in the replication set is requested to replicate the snapshot data. Only snapshot preserved data is replicated; snapshot modified data is not replicated.
replicate volume Description Creates a replication snapshot of the specified volume and initiates a replication operation. This command can follow a create replication-set command that did not specify to initiate replication. If the snapshot you want to replicate already exists, use the replicate snapshot command instead.
rescan Description This command forces rediscovery of disks and enclosures in the storage system. If both Storage Controllers are online and able to communicate with both expansion modules in each connected enclosure, this command rebuilds the internal SAS layout information, reassigns enclosure IDs based on controller A’s enclosure cabling order, and ensures that the enclosures are displayed in the proper order. A manual rescan temporarily pauses all I/O processes, then resumes normal operation.
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 quarter hour. Syntax reset all-statistics [historical] [prompt yes|no] Parameters historical Optional. Specifies to reset historical statistics instead of live statistics.
reset controller-statistics Description Resets performance statistics for controllers. This command resets all controller statistics except Power On Time. To reset this, restart or power cycle a controller. 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.
reset disk-error-statistics Description Resets error statistics for all or specified disks.
reset disk-statistics Description Resets performance statistics for disks. This command resets basic disk statistics but not disk error statistics. To reset these, use the reset disk-error-statistics command. Syntax reset disk-statistics Example Reset statistics for all disks: # reset disk-statistics Success: Command completed successfully.
reset host-link Description Resets specified controller host ports (channels). For FC, you can reset a single port. For an FC host port configured to use FC-AL (loop) topology, a reset issues a loop initialization primitive (LIP). For iSCSI, you can reset a port pair (either the first and second ports or the third and fourth ports). For SAS, you can reset a port pair (either the first and second ports or the third and fourth ports).
reset host-port-statistics Description Resets performance statistics for controller host ports. Syntax reset host-port-statistics [ports ports] Parameters ports ports Optional. The controller ID and port number of ports for which to reset statistics. For port syntax, see "Command syntax" (page 20). If this parameter is omitted, statistics are reset for all controller host ports. Example Reset statistics for all controller host ports: # reset host-port-statistics Success: Command completed successfully.
reset smis-configuration Description Resets the SMI-S configuration files. For use by or with direction from a service technician. This command will reset the configuration of the SMI-S service to default settings. After running this command, any hosts registered via SMI-S will need to be registered again. Messages are displayed when the SMI-S configuration is reset and SMI-S is restarted. Syntax reset smis-configuration [a|b|both] [prompt yes|no] [noprompt] Parameters a|b|both Optional.
See also • restore defaults 124
reset snapshot Description Deletes the data in a standard snapshot and resets it to the current data in the associated master volume. The snapshot’s volume characteristics are not changed. The command prompts you to unmount/unpresent/unmap the snapshot from hosts before performing the reset; leaving it mounted can cause data corruption. This command is not allowed for a replication snapshot. CAUTION: All data represented by the snapshot as it exists prior to issuing this command is lost.
reset vdisk-statistics Description Resets performance statistics for all or specified vdisks. Syntax reset vdisk-statistics [vdisks] Parameters vdisks Optional. A comma-separated list of the names or serial numbers of the vdisks for which to reset statistics. For vdisk syntax, see "Command syntax" (page 20). If this parameter is omitted, statistics are reset for all vdisks. Example Reset statistics for vdisks VD1 and MyVdisk: # reset vdisk-statistics VD1,MyVdisk Success: Command completed successfully.
reset volume-statistics Description Resets performance statistics for all or specified volumes. 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. For volume syntax, see "Command syntax" (page 20). If this parameter is omitted, statistics are reset for all volumes. Example Reset statistics for volume vd1_v0001: # reset volume-statistics vd1_v0001 Success: Command completed successfully.
restart Description Restarts the Storage Controller or Management Controller in a controller module. If you restart a Storage Controller, it attempts to shut down with a proper failover sequence, which includes stopping all I/O operations and flushing the write cache to disk, and then the Storage Controller restarts. Restarting a Storage Controller restarts the corresponding Management Controller. If you restart a Management Controller, communication with it is lost until it successfully restarts.
Restart both Storage Controllers: # restart sc both While the specified Storage Controllers restart, communication will temporarily be lost with the corresponding Management Controllers. Restarting both controllers can cause a temporary loss of data availability. Do you want to continue? (y/n) yes Connection closed by foreign host.
restore defaults Description Restores the default configuration to the controllers. For use by or with direction from a service technician. For details about which settings are restored see "Settings changed by restore defaults" (page 521). If the system contains only one controller module when the command is issued, the system’s redundancy mode will be set to Single Controller mode.
resume replication Description Resumes a suspended replication operation for the specified secondary volume. This command must be issued on the system that owns the secondary volume. Syntax resume replication [set replication-set] replication-volume Parameters set replication-set Optional. The name or serial number of the replication set. replication-volume The name or serial number of the secondary volume. If the name is not unique across replication sets, specify the set parameter.
rollback master-volume Description Rolls back (reverts) the data on a master volume to the data that exists in a specified snapshot. You can choose whether to include modified write data from the snapshot in the rollback. You must unmount/unpresent/unmap the master volume from hosts before using this command. The command will prompt you to ensure the master volume is unmounted/unpresented/unmapped before proceeding. CAUTION: All data that differs between the master volume and the snapshot is lost.
scrub vdisk Description Analyzes specified vdisks to find and fix disk errors. This command acts on disks in a vdisk but not dedicated spares or leftover disks. This command will fix parity mismatches for RAID 3, 5, 6, and 50; mirror mismatches for RAID 1 and 10; and media errors for all RAID levels. Vdisk scrub can last over an hour, depending on vdisk size, utility priority, and amount of I/O activity.
scrub volume Description Analyzes specified volumes to find and fix disk errors. This command acts on the disk portions spanned by each volume, but it does not act on dedicated spares or leftover disks. This command will fix parity mismatches for RAID 3, 5, 6, and 50; mirror mismatches for RAID 1 and 10; and media errors for all RAID levels. Volume scrub can last over an hour, depending on volume size, utility priority, and amount of I/O activity. You can use a volume while it is being scrubbed.
set advanced-settings Description Sets advanced system configuration parameters.
compact-flash-failure enabled|disabled|on|off Optional. Sets whether the cache policy will change from write-back to write-through when CompactFlash memory is not detected during POST (Power-On Self-Test), fails during POST, or fails during controller operation. • disabled or off: The CompactFlash failure trigger is disabled. • enabled or on: The CompactFlash failure trigger is enabled. This is the default. controller-failure enabled|disabled|on|off Optional.
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. This is the default. partner-notify enabled|disabled|on|off Optional. Sets whether to notify the partner controller that a trigger condition occurred.
utility-priority low|medium|high Optional. Sets the priority at which data-redundancy utilities, such as vdisk verify and reconstruct, run with respect to I/O operations competing for the system's processors. (This does not affect vdisk 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.
Enable auto-stall recovery: # set advanced-settings auto-stall-recovery enabled Success: Command completed successfully. - The settings were changed successfully.
set auto-write-through-trigger Description Sets the trigger conditions that cause the controller to change the cache policy from write-back to write-through. You can set multiple triggers. By default super-cap-failure and auto-write-back are enabled. Alias: set awt. When the cache mode is changed, an event is logged.
partner-notify enabled|disabled|on|off Optional. Sets whether to notify the partner controller that a trigger condition occurred. Enable this option to have the partner also change to write-through mode for better data protection. Disable this option to allow the partner to continue using its current caching mode for better performance. • disabled or off: Notification is disabled. This is the default. • enabled or on: Notification is enabled. auto-write-back enabled|disabled|on|off Optional.
set cache-parameters Description Sets a volume’s cache options. Settings you can change include: NOTE: Only change the read-ahead cache settings if you fully understand how the host operating system, application, and adapter move data so that you can adjust the settings accordingly. Be prepared to monitor system performance and adjust read-ahead size until you find the optimal size for your application.
volume The name or serial number of the volume to change. For volume syntax, see "Command syntax" (page 20). Example Set the cache policy, optimization mode, and read-ahead size for volume V1: # set cache-parameters write-policy wb optimization standard read-ahead-size stripe V1 Success: Command completed successfully. - Cache parameters were changed.
set chap-record Description For iSCSI, changes an 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. Syntax set chap-record name originator-name [secret originator-secret] [mutual-name recipient-name mutual-secret recipient-secret] Parameters name originator-name The originator name, typically in IQN format. secret originator-secret The secret that the recipient uses to authenticate the originator.
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.
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 XML API format, which is intended for scripting, disable paging. precision # Optional. Sets the number of decimal places (1–10) for display of storage-space sizes. The default is 1. storage-size-base 2|10 Optional. Alias for base. storage-size-precision # Optional. Alias for precision.
set controller-date Description Sets the date and time parameters for the system. You can set the date and time manually or configure the system to communicate with a Network Time Protocol (NTP) server. Alternatively, you can configure NTP by using the set ntp-parameters command. NOTE: If you specify valid NTP parameters and manual date/time parameters in the same command, the NTP parameters will take precedence.
timestamp timestamp The date and time represented as the number of seconds (not counting leap seconds) that have elapsed since 1970-01-01 00:00:00 UTC. The resulting time will be in UTC, unless you also specify the timezone parameter. Example Manually set the system time and date to 1:45 PM on September 22, 2011: # set controller-date sep 22 13:45:0 2011 Success: Command completed successfully. - Date/Time successfully set.
set debug-log-parameters Description Sets the types of debug messages to include in the Storage Controller debug log. For use by or with direction from technical support. 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: • awt: Auto-write-through cache triggers debug messages. Disabled by default. • bkcfg: Internal configuration debug messages. Enabled by default.
set disk Description Performs a secure erase on a specified disk. This is called repurposing the disk, and only applies to a disk that is capable of Full Disk Encryption. This command can only be run on disks whose status is either AVAIL or UNUSABLE. AVAIL disks have had all vdisk information removed from them. Secure erasing such disks is an extra step to make all data on the disk irretrievable. UNUSABLE disks have a foreign lock key. UNUSABLE disks can be imported by using the set fde-import-key command.
set disk-parameters Description Sets parameters that affect disk operation. Two features controlled by these parameters are disk Self-Monitoring Analysis and Reporting Technology (SMART) and drive spin down. • 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.
set email-parameters Description Sets SMTP notification parameters for events and managed logs. Syntax set email-parameters domain domain email-list email-addresses [include-logs enabled|disabled|on|off] notification-level crit|error|warn|info|none sender sender server server Parameters domain domain The domain name that is joined with an @ symbol to the sender name to form the “from” address for remote notification. The domain name can have a maximum of 255 bytes.
Example Set the system to send an email from RAIDsystem@mydomain.com to both sysadmin@mydomain.com and JSmith@domain2.com when a non-Informational event occurs, and to send an email with attached logs to logcollector@mydomain.com when logs need to be transferred: # set email-parameters server 10.1.1.10 sender RAIDsystem domain mydomain.com notification-level warn include-logs enabled email-list sysadmin@mydomain.com,JSmith@domain2.com,,logcollector@mydomain.
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. These values are used when user interfaces show enclosure-related data; for example, in output of the show enclosures command and in event-log entries related to enclosures.
set expander-fault-isolation Description Temporarily disables PHY fault isolation for a specific Expander Controller. For use by or with direction from technical support. 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.
set expander-phy Description Disables or enables a specific PHY. For use by or with direction from technical support. Syntax set expander-phy [encl enclosure-ID] [wwn enclosure-WWN] controller a|b|both type drive|sc-0|sc-1|ingress|egress phy phy-ID enabled|disabled|on|off Parameters encl enclosure-ID Optional. The enclosure ID of the enclosure containing the PHY. Specify either this parameter or the wwn parameter. encl enclosure-WWN Optional. The WWN of the enclosure containing the PHY.
Enable the PHY for disk 5 in controller B, and check the resulting status: # set expander-phy encl 1 controller b type drive phy 5 enabled Success: Command completed successfully. - Enabled PHY 5 on controller b in enclosure 1. (PHY type: drive) (2012-01-21 12:07:50) # show expander-status Encl Ctlr Phy Type Status Elem Status Disabled Reason ----------------------------------------------------------------------------...
set fde-import-key Description Sets or changes the import lock key for the use of Full Disk Encryption. The import lock key is derived from the passphrase and is used to unlock secured disks that are inserted into the system from a different secure system. Syntax set fde-import-key passphrase value [noprompt] Parameters passphrase value A customer-supplied password associated with securing the system.
set fde-lock-key Description Sets or changes the lock key for the use of Full Disk Encryption. The lock key is derived from the passphrase and stored within the system. You must retain the value of the passphrase and the lock key ID that the command returns. If you lose the passphrase, you could be locked out of your data. Syntax set fde-lock-key passphrase value [current-passphrase value] [noprompt] Parameters passphrase value A customer-supplied password associated with securing the system.
set fde-state Description Changes the overall state of the system for the use of Full Disk Encryption. The system can be secured, where each disk becomes secured and not accessible outside the system. Alternatively, the system can be repurposed, where each disk is secure erased. Syntax set fde-state [repurpose] [secure passphrase value] [noprompt] Either the repurpose parameter or the secure parameter must be specified.
set global-spare Description Designates spare disks for use by fault-tolerant (RAID 1, 3, 5, 6, 10, 50) vdisks. A global spare is available to any fault-tolerant vdisk with the same disk type. The system can have 16 global spares. Each must have enough capacity to replace the smallest disk in any existing vdisk. CAUTION: When setting global spares, the existing set of global spares is completely replaced by the newly specified set of disks.
set host-name Description Changes the nickname, if any, and optionally the profile of a host entry. This command can also be used to remove a manually created host. If the host is unmapped, it is immediately removed; if the host is mapped, it will be removed after you unmap it. Syntax set host-name id host [profile standard|hp-ux] [new-nickname] Parameters id host The ID or nickname of the host. profile standard|hp-ux Optional. Changes the profile of a host that has a nickname. • standard: Default profile.
set host-parameters Description Sets controller host-port parameters for communication with attached hosts. FC and iSCSI ports can be configured. There are no parameters for SAS ports. MSA 2040 SAN host ports can be configured as FC or iSCSI ports. FC ports support use of qualified 8-Gbit/s or 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 1-Gbit/s or 10-Gbit/s SFPs. iSCSI port speeds are auto-negotiated.
fibre-loop-id values Optional. For FC, specifies comma-separated loop ID values to request for host ports when controllers arbitrate during a LIP. Use this option if you want ports to have specific addresses, if your system checks addresses in reverse order (lowest address first), or if an application requires 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.
speed 4g|8g|16g|auto Optional. For FC, sets a forced link speed in Gbit/s or lets the speed be auto-negotiated (auto). Because a speed mismatch prevents communication between the port and host, set a speed only if you need to force the port to use a known speed for testing, or you need to specify a mutually supported speed for more than two FC devices connected in an arbitrated loop. Loop mode cannot be used with 16-Gbit/s link speed.
set host-port-mode Description Changes host-interface characteristics for host ports in an MSA 2040 SAN controller module. For both controller modules, all ports can be set to FC, all ports can be set to iSCSI, or the first two ports in each controller module can be set to FC and the second two ports can be set to iSCSI. This command will immediately restart the controllers and log event 236. After the controllers have restarted, you can use the set host-parameters command to configure the individual ports.
set iscsi-parameters Description For iSCSI, changes system-wide iSCSI parameters. Syntax set iscsi-parameters [chap enabled|disabled|on|off] [jumbo-frame enabled|disabled|on|off] [speed auto|1gbps] [isns enabled|disabled|on|off] [isns-ip iSNS-IP] [isns-alt-ip iSNS-IP] [iscsi-ip-version ipv4|ipv6] Parameters chap enabled|disabled|on|off Enables or disables use of Challenge Handshake Authentication Protocol. Disabled by default.
set job-parameters (Deprecated) Use set advanced-settings. set led Description Changes the state of the identification LED on a specified device. LEDs are described in the User Guide. Syntax To set a disk LED: set led disk ID enable|disable|on|off To set an enclosure LED: set led enclosure ID [controller a|b] enable|disable|on|off Parameters disk ID Specifies the disk to locate. For disk syntax, see "Command syntax" (page 20). This affects the Fault/UID LED.
set network-parameters Description Sets parameters for controller module network ports. You can manually set static IP values for each controller, or you can specify that IP values should be set automatically for both controllers through communication with a Dynamic Host Configuration Protocol (DHCP) server. Each controller has the following factory-default IP settings: • DHCP: enabled • Controller A IP address: 10.0.0.2 • Controller B IP address: 10.0.0.3 • IP subnet mask: 255.255.255.
ipv 4|6 Optional. Specifies whether to use IP version 4 (IPv4) or 6 (IPv6) for addressing the network ports. • 4: Lets you specify addresses in dot-decimal format, where the four octets of the address use decimal values and the octets are separated by a period; for example, 10.132.2.205. The first octet may not be zero, with the exception that 0.0.0.0 can be used to disable the interface (stop I/O). This option is the default.
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. Syntax set ntp-parameters [ntp enabled|disabled|on|off] [ntpaddress IP-address] [timezone +|-hh[:mm]] Parameters ntp enabled|disabled|on|off Optional. Enables or disables use of NTP.
set password Description Sets a user’s password for system interfaces (such as the CLI). A password can be entered as part of the command, or the command prompts you to enter and re-enter the new password. Syntax set password [password password] [user] Parameters password password Optional. Sets a new password for the user. The value is case sensitive and must contain 8–32 characters. A password cannot contain the following characters: angle brackets, backslash, comma, double quote, single quote, or space.
set priorities Description Sets snapshot-retention priorities for a specified snap pool. Snap-pool priorities, in conjunction with snapshot priorities, determine which snapshots are retained if system resource limitations require some snapshots to be automatically deleted. Lower-priority snapshots will be deleted before higher-priority snapshots. Priority values are 0x0001–0xffff (1–65535). You can enter either decimal or hexadecimal values. To use a default priority, specify the value 0.
set prompt Description Sets the prompt for the current CLI session. This setting does not persist beyond the current session. Syntax set prompt prompt Parameters prompt The new prompt, which can include any printable UTF-8 characters except left angle bracket, backslash, and double quote, and can have a maximum of 16 bytes. A prompt that includes a space must be enclosed in double quotes.
set protocols Description Enables or disables management services and protocols. Syntax set protocols [debug enabled|disabled|on|off] [ftp enabled|disabled|on|off] [http enabled|disabled|on|off] [https enabled|disabled|on|off] [ses enabled|disabled|on|off] [smis enabled|disabled|on|off] [snmp enabled|disabled|on|off] [ssh enabled|disabled|on|off] [telnet enabled|disabled|on|off] [usmis enabled|disabled|on|off] [activity enabled|disabled|on|off] Parameters debug enabled|disabled|on|off Optional.
activity enabled|disabled|on|off Optional. Enables or disables access to the activity progress interface via HTTP port 8081. This mechanism reports whether a firmware update or partner firmware update operation is active and shows the progress through each step of the operation. In addition, when the update operation completes, status is presented indicating either the successful completion, or an error indication if the operation failed. This is disabled by default.
set remote-system Description Changes remote-system credentials stored in the local system. Do this when the user name or password to access a remote system has been changed in that system. Syntax set remote-system [password password] [username username] system Parameters password password Optional. The new password to access the remote system. The value is displayed in clear text. username username Optional. The new user name to access the remote system.
set replication-primary-volume Description Changes the primary volume for a replication set. You must issue this command to each volume in the replication set. If the volumes in a replication set have different primary-volume settings — for example, if the primary volume was changed while one volume was offline — this results in a primary-volume conflict. Change the primary volume on the secondary system, then, if possible, change the primary volume on the primary system.
On System2, set secondary volume rData to be the primary volume: # set replication-primary-volume volume rData primary-volume rData Info: Started setting the primary volume of the replication set. (RS) Info: Setting the primary volume of the replication set. This may take a couple of minutes... (RS) Info: Successfully set primary volume: (rData) Info: The primary volume of the replication set was changed. (RS) Success: Command completed successfully.
See also • show replication-sets • show replication-volumes • show snapshots • unmap volume 180
set replication-volume-parameters Description Sets parameters for a specified replication volume. This command must be run separately on each system where the volume resides; changes to these parameters are not automatically synchronized across systems.
remote-address ip=IPs|wwnn=WWNNs|wwpn=WWPNs Optional. The host port addresses associated with a replication volume. For the secondary system on which the command is run, you can specify host ports by IP address, World Wide Node Name, or World Wide Port Name. An IP address value can include a port number; for example, 10.134.11.10:3260. Multiple values must be separated by commas and no spaces; for example: ip=10.134.2.1,10.134.2.2. set replication-set Optional.
set schedule Description Changes parameters for a specified schedule. If you want to change the schedule name, create a new schedule to replace the existing one. You must specify at least one of the optional parameters for the command to succeed. When scheduling ReplicateVolume tasks, a best practice is to schedule no more than three volumes to start replicating at the same time, and for those replications to recur no less than 60 minutes apart.
Example Change parameters, including the associated task, for schedule Sched1: # set schedule schedule-specification "start 2011-01-01 00:01 every 1 days expires 2011-12-31 00:01" task-name Task1 Sched1 Success: Command completed successfully. (Sched1) - The schedule was modified.
set snap-pool-policy Description Sets the recovery policy that determines the action taken when a specified snap pool’s error and critical threshold levels are reached. The policy for the warning threshold is preset to notifyonly. A snap pool’s default error policy is autoexpand and default critical policy is deletesnapshots. NOTE: The policies deleteoldestsnapshot and deletesnapshots do not apply business logic to the delete decision and may delete snapshots that are mounted/presented/mapped or modified.
Example Set snap pool SP1 to automatically expand by 10 GB when its error threshold is reached: # set snap-pool-policy error autoexpand autoexpansionsize 10GB SP1 Success: Command completed successfully.
set snap-pool-threshold Description Sets the percentages of snap-pool space used that trigger the warning and error threshold policies. Three thresholds are defined: • Warning: The snap pool is moderately full. When this threshold is reached, an event is generated to alert the administrator. • Error: The snap pool is nearly full and unless corrective action is taken, snapshot data loss is probable.
set snmp-parameters Description Sets SNMP parameters for event notification. To enable or disable SNMP requests to the MIB use the set protocols command. Syntax set snmp-parameters [enable crit|error|warn|info|none] [add-trap-host address] [del-trap-host address] [trap-host-list trap-host-list] [read-community string] [write-community string] Parameters enable crit|error|warn|info|none Optional. Sets the level of trap notification: • crit: Sends notifications for Critical events only.
set spares Description Creates or deletes spare disks for fault-tolerant (RAID 1, 3, 5, 6, 10, 50) vdisks. A global spare is available to any fault-tolerant vdisk with the same disk type. The system can have 16 global spares. Each must have enough capacity to replace the smallest disk in any existing vdisk. A dedicated spare is assigned to a fault-tolerant vdisk with the same disk type. A vdisk can have four dedicated spares. Each must have enough capacity to replace the smallest disk in that vdisk.
set syslog-parameters Description Sets remote syslog notification parameters for events and managed logs. This allows events to be logged by the syslog of a specified host computer. Syslog is a protocol for sending event messages across an IP network to a logging server.
set system Description Sets the system’s name, contact person, location, and description. Each value can include a maximum of 79 bytes, using printable UTF-8 characters except angle brackets, backslash, or double quote. A value that contains a space must be enclosed in double quotes. The name, location, and contact are included in event notifications. All four values are included in system debug logs for reference by service personnel.
set task Description Changes parameters for a TakeSnapshot, ReplicateVolume, 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.
name The name of the task to change. Example Change parameters for a TakeSnapshot-type task named Snap: # set task snapshot-prefix VD1v1 retention-count 2 Snap Success: Command completed successfully. (Snap) - The task was modified.(2012-01-21 12:37:49) Change parameters for a VolumeCopy-type task named Copy: # set task dest-vdisk VD3 dest-prefix VD1v1 modified-snapshot no Copy Success: Command completed successfully. (Copy) - The task was modified.
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. NOTE: User changes take effect when the user next 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 a default. • wbi: Web-browser interface (the SMU). This is a default. • ftp: FTP 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.
roles roles Optional. Specifies the user’s roles as one or more of the following values: • monitor: User can view but not change system settings. This is the default. • manage: User can view and change system settings. • diagnostic: User can view and change system settings. Multiple values must be separated with a comma (with no spaces). If multiple values are specified, the user’s access to commands will be determined by the highest-level role specified.
Change the password for user JDoe: # set user JDoe password Abcd%123 Success: Command completed successfully. - The settings were changed successfully. (2013-11-14 12:04:31) Change the authentication type for SNMPv3 user Traps: # set user Traps authentication-type MD5 password Snmp%Trap Success: Command completed successfully. - The settings were changed successfully.
set vdisk Description Changes parameters for a specified vdisk. Syntax set vdisk [name new-name] [owner a|b] [spin-down-delay delay] vdisk Parameters name new-name Optional. A new name for the vdisk. For vdisk syntax, see "Command syntax" (page 20). owner a|b Optional. The new owner: controller A or B. CAUTION: Before changing the owning controller for a vdisk, you must stop host I/O to the vdisk’s volumes. Volume mappings are not affected. spin-down-delay delay Optional.
set vdisk-spare Description Designates spare disks for use by a fault-tolerant (RAID1, 3, 5, 6, 10, 50) vdisk. A dedicated spare is assigned to a fault-tolerant vdisk with the same disk type. A vdisk can have four spares. Each must have enough capacity to replace the smallest disk in that vdisk. CAUTION: When setting dedicated spares, the existing set of dedicated spares for the specified vdisk is completely replaced by the newly specified set of disks.
set volume Description Changes a volume’s name and identifying information. Syntax set volume [access read-write|rw|read-only|ro] [identifying-information description] [name new-name] volume Parameters access read-write|rw|read-only|ro Deprecated; to change mapping settings, use the "map volume" (page 104). identifying-information description Optional. A description of the volume to help a host-side user identify it.
show advanced-settings Description Shows the settings for advanced system-configuration parameters. Syntax show advanced-settings Output Vdisk Background Scrub Shows whether disks in vdisks are automatically checked for disk defects to ensure system health. The interval between background vdisk scrub finishing and starting again is specified by the Vdisk Background Scrub Interval field. • Disabled: Background vdisk scrub is disabled. • Enabled: Background vdisk scrub is enabled. This is the default.
Sync Cache Mode Shows how the SCSI SYNCHRONIZE CACHE command is handled: • Immediate: Good status is returned immediately and cache content is unchanged. • Flush To Disk: Good status is returned only after all write-back data for the specified volume is flushed to disk. Independent Cache Performance Mode Not supported. Missing LUN Response Shows whether host drivers may probe for LUNs until the host drivers reach the LUN to which they have access.
Partner Notify 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. This is the default. • Enabled: Notification is enabled; the partner controller will change to write-through mode for better data protection. Auto Write Back Shows whether the cache mode will change from write-through to write-back when the trigger condition is cleared.
Example Show advanced system-configuration settings: # show advanced-settings Vdisk Background Scrub: Enabled Vdisk Background Scrub Interval: 24 Partner Firmware Upgrade: Disabled Utility Priority: High SMART: Enabled Dynamic Spare Configuration: Disabled Enclosure Polling Rate: 5 Host Control of Caching: Enabled Sync Cache Mode: Immediate Independent Cache Performance Mode: Disabled Missing LUN Response: Not Ready Controller Failure: Disabled Supercap Failure: Enabled CompactFlash Failure: Enabled Power S
show auto-write-through-trigger Description Shows the system’s write-through trigger settings. When a trigger condition occurs and the trigger is enabled, the RAID controller cache mode changes from write-back to write-through. Syntax show auto-write-through-trigger Output Controller Failure Shows whether the cache policy will change from write-back to write-through when a controller fails. • Disabled: The controller failure trigger is disabled. This is the default.
Example Show the system’s auto-write-through trigger settings: # show auto-write-through-trigger Auto Write-Through Triggers --------------------------Controller Failure: Disabled Supercap Failure: Enabled CompactFlash Failure: Enabled Power Supply Failure: Disabled Fan Failure: Disabled Temperature Exceeded: Disabled Partner Notify: Disabled Auto Write Back: Enabled Success: Command completed successfully.
show cache-parameters Description Shows cache settings and status for the system and optionally for a volume. Syntax show cache-parameters [volume] Parameters volume Optional. Name or serial number of the volume for which to show settings. For volume syntax, see "Command syntax" (page 20). If this parameter is not specified, only system-wide settings are shown.
Volume cache parameters: Serial Number If a volume is specified, its serial number. Name If a volume is specified, its name. Cache Write Policy 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. This is the preferred setting for a fault-tolerant environment because it improves the performance of write operations and throughput. This is the default.
Example Show the cache parameters for the system and for volume V1: # show cache-parameters V1 System Cache Parameters ----------------------Operation Mode: Active-Active ULP Controller A Cache Parameters ----------------------------Write Back Status: Enabled CompactFlash Status: Installed CompactFlash Health: OK Cache Flush: Enabled Controller B Cache Parameters ----------------------------Write Back Status: Enabled CompactFlash Status: Installed CompactFlash Health: OK Cache Flush: Enabled Volume Cache Pa
show certificate Description Shows the status of the system’s security certificate. Syntax show certificate Output Certificate Status • Default: No customer-supplied or alternate certificate has been installed. • Customer-supplied: A custom or alternate certificate has been installed. Time Created Date and time in the format year-month-day hour:minutes:seconds when the custom certificate was created.
show chap-records Description For iSCSI, shows all CHAP records or the record for a specific originator. This command is permitted whether or not CHAP is enabled. 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-secrets Optional. Minimum role: manage. Shows Initiator Secret and Mutual CHAP Secret values in command output.
show cli-parameters Description Shows the current CLI session preferences. Syntax show cli-parameters Output Timeout Time in seconds that the session can be idle before it automatically ends. Valid values are 120–43200 seconds (2–720 minutes). The default is 1800 seconds (30 minutes). Output Format • Console: Supports interactive use of the CLI by displaying command output in easily readable format.
Temperature Scale • Fahrenheit: Temperatures are shown in degrees Fahrenheit. • Celsius: Temperatures are shown in degrees Celsius. This is the default. Example Show current CLI settings: # show cli-parameters CLI Parameters -------------Timeout: 1800 Output Format: Console Brief Mode: Disabled Base: 10 Pager: Enabled Locale: English Precision: 1 Units: Auto Temperature Scale: Celsius Success: Command completed successfully.
show configuration Description Shows system configuration information. NOTE: Output for this command is lengthy. To control whether the output halts after each full screen to wait for keyboard input, enable or disable the pager parameter of the set cli-parameters command.
show controller-date Description Shows the system’s current date and time. Syntax show controller-date Output Controller Date Date and time in the format year-month-day hour:minutes:seconds. Time-Zone Offset The system’s time zone as an offset in hours and minutes from Coordinated Universal Time (UTC). This is shown only if NTP is enabled.
show controllers Description Shows information about each controller module in the storage system. Syntax show controllers Output Controller ID • A: Controller A. • B: Controller B. Serial Number • Serial number of the controller module. • Not Available: The controller module is down or not installed. Hardware Version Controller module hardware version. CPLD Version Complex Programmable Logic Device firmware version. MAC Address Controller network port MAC address.
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. There will be a delay between the time that the value of Status becomes Down for one controller and the time that the value of Failed Over to This Controller becomes Yes for the other controller.
Example Show controller information: # show controllers Controllers ----------Controller ID: A Serial Number: SN Hardware Version: value CPLD Version: value MAC Address: value WWNN: WWNN IP Address: 10.134.63.2 IP Subnet Mask: 255.255.0.0 IP Gateway: 10.134.0.
show controller-statistics Description Shows live performance statistics for controller A, B, or both. Statistics shown only in XML API output are described in "XML API basetype properties" (page 367). Syntax show controller-statistics [a|b|both] Parameters a|b|both Optional. Specifies whether to show information for controller A, B, or both. If this parameter is omitted, information is shown for both controllers. Output Durable ID Controller ID in the form controller_ID.
Example Show statistics for controller A: # show controller-statistics a Durable ID CPU Load Power On Time (Secs) Bytes per second IOPS Number of Reads Number of Writes Data Read Data Written Num Forwarded Cmds Reset Time Total Power On Hours ----------------------------------------------------------------------------controller_A 1 535763 5596.6KB 406 235196190 331183103 6922.3GB 7999.1GB 0 2013-02-07 08:49:00 1356.
show debug-log-parameters Description Shows which debug message types are enabled (On) or disabled (Off) for inclusion in the Storage Controller debug log. For use by or with direction from technical support. Syntax show debug-log-parameters Output • host: Host interface debug messages. Enabled by default. • disk: Disk interface debug messages. Enabled by default. • mem: Internal memory debug messages. Disabled by default. • fo: Failover and recovery debug messages. Enabled by default.
show disk-parameters Description Shows disk settings. Syntax show disk-parameters Output SMART 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. • Enabled: SMART is enabled for all disks in the system and will be enabled for new disks added to the system. This is the default.
show disks Description Shows information about all disks or disk slots in the storage system. If no parameter is specified, the command shows information for all installed disks. NOTE: In console format, to aid reading, disks are sorted to display in order by enclosure and disk number. In API formats, output is not sorted because it is expected to be manipulated by a host application.
How Used • AVAIL: Available • FAILED: The disk is unusable and must be replaced. Reasons for this status include: excessive media errors; SMART error; disk hardware failure; unsupported disk. • GLOBAL SP: Global spare • LEFTOVR: Leftover • VDISK: Used in a vdisk • VDISK SP: Spare assigned to a vdisk Any jobs running on the disk or its vdisk follow the How Used value: • DRSC: The disk is being scrubbed. • EXPD: The vdisk is being expanded. • INIT: The vdisk is being initialized.
Life Remaining% • 100%–0%: For an SSD, this field shows the percentage of disk life remaining. When the value decreases to 20%, event 502 is logged with Informational severity. Event 502 is logged again with Warning severity when the value decreases to 5%, 2%, and 0%. • N/A: The disk is not an SSD. Total I/Os If the perf parameter is specified, this field shows the total number of I/O operations (reads and writes).
How Used • AVAIL: Available • FAILED: The disk is unusable and must be replaced. Reasons for this status include: excessive media errors; SMART error; disk hardware failure; unsupported disk. • GLOBAL SP: Global spare • LEFTOVR: Leftover • UNUSABLE: The disk cannot be used in a vdisk because the system is secured and the disk is not FDE-capable or because the disk is locked to data access.
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. With the temp parameter: Location Disk’s enclosure ID and slot number Temp Temperature of the disk. Temperature Status • OK: The disk sensor is present and detects no error condition. • Warning: The disk sensor detected a non-critical error condition.
Example Show information for all installed disks: # show disks Location Serial Number Vendor Rev How Used Type Job% Speed (kr/min) Size Rate*(Gbit/s) SP Recon State Copyback State Life Remaining% Health Health Reason Health Recommendation ----------------------------------------------------------------------------1.1 SN vendor A360 VDISK SAS 10 600.1GB 6.0 N/A N/A N/A OK ... ----------------------------------------------------------------------------Info: * Rates may vary. This is normal behavior.
Show temperature information for all installed disks: # show disks temp Location Temperature Temperature Status ----------------------------------------------------------------------------1.1 33 C OK ... ----------------------------------------------------------------------------Info: * Rates may vary. This is normal behavior. (2013-11-20 14:59:11) Success: Command completed successfully.
show disk-statistics Description Shows live or historical performance statistics for disks. You can view live statistics for all or specified disks, or historical statistics for a specified disk. The system samples disk-performance statistics every quarter hour and retains performance data for 6 months. The historical option allows you to specify a time range or a number (count) of data samples to include.
Output Durable ID (Live) Disk ID in the form disk_enclosure-number.disk-number. Serial Number Disk serial number. Bytes per second Data transfer rate 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. IOPS Input/output operations per second, calculated over the interval since these statistics were last requested or reset.
Read B/s Shown by the all parameter. Data transfer rate, in bytes per second, for read operations since the last sampling time. Write B/s Shown by the all parameter. Data transfer rate, in bytes per second, for write operations since the last sampling time. Queue Depth Shown by the all parameter. Average number of pending read and write operations being serviced since the last sampling time. This value represents periods of activity only and excludes periods of inactivity.
Show historical statistics from a specified date and time range for disk 1.5: # show disk-statistics 1.5 historical time-range "start 2011-12-05 4:40 PM 2011-12-05 5:00 PM" Durable ID Serial Number ------------------------------------------disk_1.5 SN end Total I/Os Data Transferred Total IOPS Total B/s I/O Resp Time Sample Time -------------------------------------------------------------------------183018 11.9GB 203 13.3MB 222 2013-02-12 17:00:00 1961773 128.5GB 2179 142.
show email-parameters Description Shows email (SMTP) notification parameters for events and managed logs. Syntax show email-parameters Output Email Notification • Disabled: Email notification is disabled. This is the default. • Enabled: Email notification is enabled. Email Notify Filter Shows the minimum severity for which the system should send event notifications: • crit: Sends notifications for Critical events only. • error: Sends notifications for Error and Critical events.
See also • set email-parameters show email-parameters 235
show enclosures Description Shows information about the enclosures in the storage system. Full detail available in XML API output only.
Example Show information for a system containing one 2U24 enclosure: # show enclosures Encl Encl WWN Name Location Rack Pos Vendor Model EMP A CH:ID Rev EMP B CH:ID Rev Midplane Type Health Health Reason Health Recommendation ----------------------------------------------------------------------------1 WWN Controller Lab 0 4 vendor model 01:031 1115 00:031 1115 2U24-3G OK ----------------------------------------------------------------------------Success: Command completed successfully.
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.
a|b|both|error Optional. Specifies to filter the event listing: • a: Shows events from controller A only. Do not use this parameter with the from-event parameter or the to-event parameter. • b: Shows events from controller B only. Do not use this parameter with the from-event parameter or the to-event parameter. • both: Shows events from both controllers. Do not use this parameter with the from-event parameter or the to-event parameter. • error: Shows Warning, Error, and Critical events.
show expander-status Description Shows diagnostic information relating to SAS Expander Controller physical channels, known as PHY lanes. For use by or with direction from technical support. For each enclosure, this command shows status information for PHYs in I/O module A and then I/O module B. Syntax show expander-status Output Encl Enclosure that contains the SAS expander. Ctlr I/O module that contains the SAS expander. Phy Identifies a PHY’s logical location within a group based on the PHY type.
Disabled • Enabled: PHY is enabled. • Disabled: PHY is disabled. Reason • 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. Appears for Drive, SC-1, or Ingress PHYs when a connection problem exists such as a broken connector.
show fans Description Shows information about each fan in the storage system. Syntax show fans Output Name Fan name in the form Fan loc:position-PSU power-supply-ID for a controller enclosure or MSA 2040 drive enclosure; Fan fan-unit-ID for a D2700 enclosure. The position is as viewed from the back of the enclosure. Location Fan location in the form Enclosure enclosure-ID - position. The position is as viewed from the back of the enclosure.
Example Show fan information for a single-enclosure system: # show fans Name Location Status Speed Position Serial Number Firmware Version Hardware Version Health Health Reason Health Recommendation ----------------------------------------------------------------------------Fan Loc:left-PSU 0 Enclosure 0 - Left Up 4959 Left OK Fan Loc:right-PSU 1 Enclosure 0 - Right Up 4959 OK Right ----------------------------------------------------------------------------Success: Command completed successfully.
show fde-state Description Shows Full Disk Encryption information for the storage system. Syntax show fde-state Output FDE Security Status • Unsecured. The system has not been secured with a passphrase. • Secured. The system has been secured with a passphrase. • Secured, Lock Ready. The system has been secured and lock keys are clear. The system will become locked after the next power cycle. • Secured, Locked. The system is secured and the disks are locked to data access, preventing their use.
show frus Description Shows SKU and FRU (field-replaceable unit) information for the storage system. Some information is for use by service technicians.
Configuration SN Configuration serial number FRU Status • Absent: Component is not present • Fault: One or more subcomponents has a fault • OK: All subcomponents are operating normally • Not Available: Status is not available Enclosure ID Enclosure number. Original SN For a power supply module, the original manufacturer serial number; otherwise, N/A. Original PN For a power supply module, the original manufacturer part number; otherwise, N/A.
show host-maps Description Shows mapping information for volumes that are mapped to all hosts or to a specified host. Syntax show host-maps [host] Parameters host Optional. Specifies the host’s nickname or ID. If this parameter is omitted, mapping information for all hosts is shown. Output Host information: ID • For FC and SAS: Host WWPN. • For iSCSI: iSCSI host initiator’s node name (typically the IQN). Name Host port nickname. Mapping information: Profile • Standard: Default profile.
Basetypes • host-view • status See also • show hosts • show volume-maps • show volumes 248
show host-parameters Description Shows information about host ports in both controllers. This command shows the same information as the show ports command. Syntax show host-parameters [detail] Parameters detail Optional. This parameter shows additional detail about the port status, including SFP information.
Active Lanes SAS only. If the detail parameter is specified, this field shows the number of active lanes in the SAS port. If the port is connected and fewer lanes are active than are expected, the port status will change to Warning, the health will change to Degraded, and event 354 will be logged. PID FC only. If the detail parameter is specified, this field is shown. If the port is using loop topology and the port status is Up, this field shows the primary loop ID.
Example Show port information for a system with FC ports: # show host-parameters Ports Media Target ID Status Speed(A) Speed(C) Health Health Reason Health Recommendation ----------------------------------------------------------------------------ID FC(P) WWPN Up 8Gb Auto OK Topo(C) ------PTP ID FC(-) WWPN Disconnected Auto N/A There is no host connection to this host port. - If this host port is intentionally unused, no action is required.
Show detailed port information for a system with SAS ports: # show host-parameters detail Ports Media Target ID Status Speed(A) Health Health Reason Health Recommendation ----------------------------------------------------------------------------ID SAS WWPN Up Auto OK Topo(C) Lanes Expected Active Lanes -------------------------------------Direct 4 4 ... ----------------------------------------------------------------------------Success: Command completed successfully.
Show detailed port information for a system with iSCSI ports using IPv6: # show host-parameters detail Ports Media Target ID Status Speed(A) Speed(C) Health Health Reason Health Recommendation ----------------------------------------------------------------------------ID iSCSI IQN Up 1Gb Auto OK Port Details -----------IP Version: IPv6 IP Address: fe80::a:b Default Router: fe80::1 Link-Local Address: fe80::2c0:ffff:feff:f645 MAC: 00:C0:FF:FF:F6:45 SFP Status: OK Part Number: ABCU-5700RZ 10G Compliance: No
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. Statistics shown only in XML API output are described in "XML API basetype properties" (page 367). Syntax show host-port-statistics [ports ports] Parameters ports ports Optional.
Example Show host-port statistics: # show host-port-statistics Durable ID Bytes per second IOPS Number of Reads Number of Writes Data Read Data Written Queue Depth I/O Resp Time Read Resp Time Write Resp Time Reset Time ----------------------------------------------------------------------------hostport_A1 72.0MB 549 45372779 5020328 5947.1GB 657.8GB 0 1517248 1106826 5226569 2013-02-07 21:01:20 ...
show hosts Description Shows information about all host entries in the storage system. Host entries are created in two ways: • Host entries are automatically created for hosts that have been discovered; that is, hosts that have sent an inquiry command or a report luns command to the system. Hosts typically do this when they boot up or scan for devices.
show inquiry Description Shows inquiry data for each controller module.
show iscsi-parameters Description For iSCSI, shows system-wide iSCSI parameters. 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. This is the default. Jumbo Frames Shows whether support for jumbo frames is enabled or disabled. • Enabled: Jumbo-frame support is enabled. • Disabled: Jumbo-frame support is disabled. This is the default.
Show system-wide iSCSI parameters for a system using iSNS and IPv6 addressing: # show iscsi-parameters iSCSI Parameters ---------------CHAP: Disabled Jumbo Frames: Disabled iSNS: Enabled iSNS IP: 4038:A4B5:34E0:5CB2:B87D:1D00:1C0D:0000 iSNS Alt IP: 0000:0000:0000:0000:0000:0000:0000:0003 iSCSI Speed: auto iSCSI IP Version: 6 Success: Command completed successfully.
show license Description Shows the status of licensed features in the storage system. Syntax show license Output License Key • The license key, if a license is installed and valid. • not installed, if a license is invalid or is not installed. Maximum Licensable Snapshots Number of snapshots that the highest-level license allows. Base Maximum Snapshots Number of snapshots allowed without an installed license. Licensed Snapshots Number of snapshots allowed by the installed license.
Example Show information about the installed license: # show license License Key: 0004b56810eb357d0f75d65c13c6e846 Maximum Licensable Snapshots: value Base Maximum Snapshots: value Licensed Snapshots: value In-Use Snapshots: value Snapshots Expire: 2 days remaining Volume Copy: Enabled Volume Copy Expires: Never Replication: Enabled Replication Expires: 2 days remaining VDS: Enabled VDS Expires: Never VSS: Enabled VSS Expires: Never SRA: Enabled SRA Expires: Never Success: Command completed successfully.
show master-volumes Description Shows information about all master volumes, or ones associated with a specified controller or snap pool. Syntax show master-volumes [controller a|b|both] [snap-pool volume] Parameters controller a|b|both Optional. Shows master volumes owned by controller A only, by controller B only, or by either controller (both). If this parameter is omitted, master volumes owned by either controller are shown. snap-pool volume Optional.
Example Show information about all master volumes: # show master-volumes Vdisk Serial Number Name Size Status Status-Reason Snap-pool Name Snapshots Snap Data Rollback ----------------------------------------------------------------------------VD1 SN MV1 19.9GB Available --SP1 1 1090.5MB --VD1 SN MV2 9999.9MB Unavailable SP Not Accessible SP2 0 0B 0% ----------------------------------------------------------------------------Success: Command completed successfully.
show network-parameters Description Shows the settings and health of each controller module’s network port. Syntax show network-parameters Output IP Address Network port IP address Gateway Network port gateway IP address Subnet Mask Network port IP subnet mask MAC Address Controller’s unique Media Access Control address Addressing Mode • Manual: Network settings set manually (statically) • DHCP: DHCP used to set network parameters Health The health of the network connection.
Show network parameters for a storage system using manual addressing: # show network-parameters Network Parameters Controller A ------------------------------IP Address: 172.22.1.200 Gateway: 172.22.1.1 Subnet Mask: 255.255.255.0 MAC Address: value Addressing Mode: Manual ... Network Parameters Controller B ------------------------------IP Address: 172.22.1.201 Gateway: 172.22.1.1 Subnet Mask: 255.255.255.0 MAC Address: value Addressing Mode: Manual ...
show ntp-status Description Shows the status of the use of Network Time Protocol (NTP) in the system. Syntax show ntp-status Output NTP Status • activated: NTP is enabled • deactivated: NTP is disabled NTP Server Address • The current NTP server IP address if NTP is enabled. • The last-set NTP server IP address if NTP was enabled and has been disabled. • 0.0.0.0 if the NTP server IP address has not been set.
show ports Description Shows information about host ports in both controllers. This command shows the same information as the show host-parameters command. Syntax show ports [detail] Parameters detail Optional. This parameter shows additional detail about the port status, including SFP information.
Active Lanes SAS only. If the detail parameter is specified, this field shows the number of active lanes in the SAS port. If the port is connected and fewer lanes are active than are expected, the port status will change to Warning, the health will change to Degraded, and event 354 will be logged. PID FC only. If the detail parameter is specified, this field is shown. If the port is using loop topology and the port status is Up, this field shows the primary loop ID.
Example Show port information for a system with FC ports: # show ports Ports Media Target ID Status Speed(A) Speed(C) Health Health Reason Health Recommendation ----------------------------------------------------------------------------ID FC(P) WWPN Up 8Gb Auto OK Topo(C) ------PTP ID FC(-) WWPN Disconnected Auto N/A There is no host connection to this host port. - If this host port is intentionally unused, no action is required.
Show detailed port information for a system with SAS ports: # show ports Ports Media Target ID Status Speed(A) Health Health Reason Health Recommendation ----------------------------------------------------------------------------ID SAS WWPN Up Auto OK Topo(C) Lanes Expected Active Lanes -------------------------------------Direct 4 4 ... ----------------------------------------------------------------------------Success: Command completed successfully.
Show detailed port information for a system with iSCSI ports using IPv6: # show ports detail Ports Media Target ID Status Speed(A) Speed(C) Health Health Reason Health Recommendation ----------------------------------------------------------------------------ID iSCSI IQN Up 1Gb Auto OK Port Details -----------IP Version: IPv6 IP Address: fe80::a:b Default Router: fe80::1 Link-Local Address: fe80::2c0:ffff:feff:f645 MAC: 00:C0:FF:FF:F6:45 SFP Status: OK Part Number: ABCU-5700RZ 10G Compliance: No Support Et
show power-supplies Description Shows information about each power supply in the storage system. Syntax show power-supplies Output Encl Enclosure ID Serial Number Power supply serial number Name • Power supply identifier and location • Voltage Regulator (D2700 only) Health • OK • Degraded • Fault • 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.
show priorities Description Shows snapshot-retention priorities for a specified snap pool. Snap-pool priorities, in conjunction with snapshot priorities, determine which snapshots are retained if system resource limitations require some snapshots to be automatically deleted. Lower-priority snapshots will be deleted before higher-priority snapshots. Priority values are 0–65535.
show protocols Description Shows which management services and protocols are enabled or disabled. Syntax show protocols Output Web Browser Interface (HTTP) Shows whether the standard WBI web server is enabled or disabled. The default is Enabled. Secure Web Browser Interface (HTTPS) Shows whether the secure WBI web server is enabled or disabled. The default is Enabled. Command Line Interface (Telnet) Shows whether the standard CLI is enabled or disabled. The default is Enabled.
Example Show the status of service and security protocols: # show protocols Service and Security Protocols -----------------------------Web Browser Interface (HTTP): Enabled Secure Web Browser Interface (HTTPS): Enabled Command Line Interface (Telnet): Enabled Secure Command Line Interface (SSH): Enabled Storage Management Initiative Specification (SMI-S): Enabled Unsecure Storage Management Initiative Specification (SMI-S 5988): Disabled File Transfer Protocol (FTP): Disabled Simple Network Management Prot
show provisioning Description Shows information about the relationships between disks, vdisks, volumes, ports, and LUNs. This command is useful for the following purposes: • You want a quick overview of how the system is provisioned. • You know of a disk-related issue (perhaps from the event log) and want to understand what components it may be impacting. You can use this command to see which volume WWNs are affected, which you can use on the host to determine which device node might be seeing errors.
Disks Shorthand list of the disks within a vdisk. Vdisk Vdisk name. Health Health of the associated vdisk: • OK • Degraded • Fault • 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.
Example Show provisioning for a specified vdisk: # show provisioning vdisks myR1 Volume WWN Ctlr Disks Vdisk Health Mapped ----------------------------------------------------------------------------myVol1 WWN B 1.3-4 myR1 OK Yes Ports LUN Access Host-Port-Identifier Nickname -------------------------------------------------------------------------A1,B1 9 read-write iqn.1991-05.com.microsoft:myhost.domain Host3 A1,B1 1 read-write iqn.1991-05.com.google:myhost.
show redundancy-mode Description Shows the redundancy status of the system. Syntax show redundancy-mode Output Controller Redundancy Mode Shows the system’s operating mode, also called the cache redundancy mode: • 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.
From either controller, show the redundancy status of a dual-controller system where controller B is down: # show redundancy-mode System Redundancy ----------------Controller Redundancy Mode: Failed Over Controller Redundancy Status: Operational but not redundant Controller A Status: Operational Controller A Serial Number: SN Controller B Status: Down Controller B Serial Number: SN Other MC Status: Not Operational Success: Command completed successfully.
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.
show remote-systems Description Shows information about remote systems associated with the local system. Syntax show remote-systems [system] Parameters system Optional. The name or network-port IP address of the remote system about which to show information. Output System Name The name of the remote system. System Contact The name of the person who administers the remote system. System Location The location of the remote system. System Information A brief description of the remote system.
Example Show information about remote system System2: # show remote-systems System2 Remote System ------------System Name: System2 System Contact: J. Smith System Location: Denver lab System Information: Uninitialized Info Vendor Name: vendor Product ID: product Product Brand: brand IP Address Controller A: 10.122.1.21 IP Address Controller B: 10.122.1.22 Username: manage Status: Connected Last Connected: 2012-01-18 12:58:15 Success: Command completed successfully.
show replication-images Description Shows information about replication images for a specified replication volume. Syntax show replication-images [set replication-set] [replication-volume] Parameters set replication-set Optional. Name or serial number of the replication set. replication-volume Optional. Name or serial number of the replication volume. If the name is not unique within the replication set, the local volume is assumed.
Start Date/Time Date and time when replication started on the replication volume. Last Update Date and time when the image was last updated (either due to an ongoing replication operation or the replication being completed). Suspended Date and time when the image was suspended or resumed. Est Complete Estimated time when replication is expected to complete. Time [HH:MM:SS] Total time of replication (in hours, minutes, and seconds) including any suspension time.
See also • show replication-sets • show replication-volumes 286
show replication-sets Description Shows information about replication sets in the local system. You can view information about all replication sets or a specific replication set. Syntax show replication-sets [replication-set] Parameters replication-set Optional. The name or serial number of a replication set or volume for which to display replication-set-level information. If this parameter is omitted, information is shown for all replication sets.
Primary-Volume-Serial Primary volume serial number. If the replication set has a primary-volume conflict, all associated primary volumes are displayed. Primary-Volume-Status Primary volume status: Online, Offline, Conflict, or N/A. MaxQueue Number of replication images to consider when determining the next image to replicate. Used only if the On Collision parameter is set to Oldest.
Example Show information about all replication sets: # show replication-sets Replication Set [Name (rsvd01_v001) Serial Number (SN) ] Primary Volume: Name Serial Number Status Status-Reason Monitor Location Primary-Volume Primary-Volume-Serial Primary-Volume-Status MaxQueue MaxRetryTime On Error Link Type On Collision Monitor Interval Priority Connection Status Connection Time ----------------------------------------------------------------------------vd01_v001 SN Online N/A OK Remote vd01_v001 SN Online 32
Replication Set [Name (rsData) Serial Number (SN) ] Primary Volume: Name Serial Number Status Status-Reason Monitor Location Primary-Volume Primary-Volume-Serial Primary-Volume-Status MaxQueue MaxRetryTime On Error Link Type On Collision Monitor Interval Priority Connection Status Connection Time ----------------------------------------------------------------------------rData SN Online N/A OK Remote Data SN Online 32 1800 Retry FC Oldest 300 Medium Online 2012-01-18 10:33:38 Connected Ports Remote Address
show replication-volumes Description Shows information about volumes in replication sets. You can view information about all replication volumes, volumes in a specified replication set, or a specified replication volume. Syntax show replication-volumes [set replication-set] [replication-volume] Parameters set replication-set Optional. The name or serial number of the replication set. replication-volume Optional. The name or serial number of the replication volume.
Primary-Volume-Status Primary volume status: Online, Offline, Conflict, or N/A. MaxQueue Maximum number of replication images to consider when determining the next image to replicate. Used only if the On Collision parameter is set to Oldest. The default is 32. MaxRetryTime Maximum amount of time in seconds that the replication volume should retry a replication operation on any specific image when errors occur. Used only if the On Error parameter is set to Retry. The default is 1800.
Remote link information: Connected Ports • For a remote primary or secondary volume, this field shows the IDs of up to two hosts ports in the local system that are connected to the remote system. If two ports are connected but only one is shown, this indicates that a problem is preventing half the available bandwidth from being used. • For a local primary or secondary volume, this field shows N/A. Remote Address The address of each host port in the remote system through which the volume is accessible.
show sas-link-health Description Shows the condition of SAS expansion-port connections. NOTE: SAS link health is not supported for D2700 enclosures. Syntax show sas-link-health Output Encl Enclosure ID Ctlr ID of the controller module or expansion module Name • Out Port: Egress (expansion) port in a controller module or an expansion module. Can be connected to an ingress port in an expansion module. • In Port: Ingress port in an expansion module.
Example Show the condition of SAS port connections in a two-enclosure system: # show sas-link-health Encl Ctlr Name Status Health Health Reason Health Recommendation ----------------------------------------------------------------------------1 A Out Port Up OK 1 B Out Port Up OK ----------------------------------------------------------------------------Encl Ctlr Name Status Health Health Reason Health Recommendation ----------------------------------------------------------------------------2 A Out Port Di
show schedule-details Description Shows information about a specified task schedule. Syntax show schedule-details schedule Parameters schedule Schedule name.
show schedules Description Shows information about all task schedules. Syntax show schedules Output Schedule Name The schedule name. Schedule Specification The schedule settings for running the associated task. Status • Uninitialized: The task is not yet ready to run. • Ready: The task is ready to run at the next scheduled time. • Suspended: The task had an error and is holding in its current state. • Expired: The task exceeded a constraint and will not run again. • Invalid: The task is invalid.
Schedule Details ---------------Schedule Name: V1_sched2 Schedule Specification: Start 2012-01-19 17:06:00, Every 1 Hours Status: Ready Next Time: 2012-01-19 18:06:00 Task To Run: V1_task002 Error Message: Tasks ----Task Name: V1_task002 Task Type: TakeSnapshot Status: Ready Task State: Start Error Message: Task Details -----------Source Volume: V1 Source Volume Serial: SN Prefix: V1 Count: 1 Last Created: V1_S0001 Snapshot Name Snapshot Serial -----------------------------------------------------V1_S0001 S
show sensor-status Description Shows the status of each environmental sensor in each enclosure. Information shown only for a controller enclosure: on-board temperature, disk controller temperature, memory controller temperature, supercapacitor voltage and charge, overall unit (enclosure) status. Information shown for all enclosures except D2700: temperature, voltage, and current for each IOM (controller module or expansion module); temperature, voltage, and current for each PSU (power supply).
1 Capacitor Pack Voltage-Ctlr A 8.22 Ok 1 Capacitor Pack Voltage-Ctlr B 8.26 Ok 1 Capacitor Cell 1 Voltage-Ctlr A 2.04 Ok 1 Capacitor Cell 1 Voltage-Ctlr B 2.06 Ok 1 Capacitor Cell 2 Voltage-Ctlr A 2.04 Ok 1 Capacitor Cell 2 Voltage-Ctlr B 2.06 Ok 1 Capacitor Cell 3 Voltage-Ctlr A 2.08 Ok 1 Capacitor Cell 3 Voltage-Ctlr B 2.06 Ok 1 Capacitor Cell 4 Voltage-Ctlr A 2.05 Ok 1 Capacitor Cell 4 Voltage-Ctlr B 2.
show shutdown-status Description Shows whether each Storage Controller is active or shut down. Syntax show shutdown-status Output Controller A • up (active) • down (shut down or killed) • not installed Controller B • up (active) • down (shut down or killed) • not installed Other MC Status The operational status of the Management Controller in the partner controller. This is not factored into system health.
show snap-pools Description Shows information about snap pools owned by a specified controller or both controllers. NOTE: The process of freeing space associated with deleted snapshots occurs more slowly when the system is operating write-through cache mode than in write-back cache mode. Therefore, there will be a delay between deleting the snapshots and when their used space is shown as free space by the show snap-pools command.
Policy Recovery policy to invoke when threshold value is reached: • autoexpand: Try to expand the snap pool by the SizeToExpand value. If the snap pool's space usage reaches the percentage specified by its error threshold, the system will log Warning event 230 and will try to expand the snap pool by the snap pool's SizeToExpand value (below). • If the snap pool is successfully expanded, the system will log Informational event 444.
show snapshots Description Shows information about snapshots for a specified controller, master volume, or snap pool. If no parameters are specified, information about all snapshots is shown. Syntax show snapshots [controller a|b|both] [master-volume volume] [snap-pool volume] [type standard|replication|all] Parameters controller a|b|both Optional. Shows snapshots owned by controller A only, by controller B only, or by either controller (both).
Snap Data Total amount of preserved and write data associated with the snapshot Unique Data Amount of preserved and write data that is unique to the snapshot Shared Data Amount of preserved and write data that is shared between this snapshot and other snapshots Priority Retention priority for the snapshot, based on the snapshot attributes and the user-defined retention priority for the snapshot type User Priority User-defined retention priority for the snapshot type Type • Standard snapshot: Snapshot of a m
Example Show information about snapshots associated with snap pool spvd03_v001: # show snapshots snap-pool spvd03_v001 Vdisk Serial Number Name Creation Date/Time Status Status-Reason Source Volume Snap-pool Name Snap Data Unique Data Shared Data Priority User Priority Type ----------------------------------------------------------------------------vd01 SN vd01_v003_i02 2012-01-19 12:51:18 Available N/A vd01_v003 spvd01_v003 1075.1MB 1075.
show snmp-parameters Description Shows SNMP settings for event notification. Syntax show snmp-parameters Output SNMP Trap Notification Level • crit: Only Critical events are sent as traps • error: Error and Critical events are sent as traps • warn: Warning, Error, and Critical events are sent as traps • info: All events are sent as traps • none: No events are sent as traps and traps are disabled SNMP Trap Host IP# IP address of each trap host SNMP read community The community string for read-only access.
show syslog-parameters Description Shows syslog notification parameters for events and managed logs. Syntax show syslog-parameters Output Syslog Host IP The IP address of the remote syslog server to use 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.
show system Description Shows information about the storage system. If the system’s health is not OK, each unhealthy component is listed with information to help you resolve the health problem. Syntax show system [detail] Parameters detail Optional. Shows the SCSI Vendor ID and SCSI Product ID fields on a system where they are hidden by default. Output System Name The name of the system. The default is Uninitialized Name. System Contact The name of the person who administers the system.
PFU Status Shows whether partner firmware update is running on the system, or is idle. Supported Locales Supported display languages: English, Spanish, French, German, Italian, Japanese, Dutch, Chinese-Simplified, Chinese-Traditional, Korean. Example Show information for a system whose health is OK: # show system System Information -----------------System Name: Storage-1 System Contact: J.
Show information for a system whose health is degraded because of a problem with a vdisk: # show system System Information -----------------System Name: Storage-2 System Contact: J. Smith System Location: Main lab System Information: Used for testing Midplane Serial Number: SN Vendor Name: vendor Product ID: product Product Brand: brand SCSI Vendor ID: vendor-ID SCSI Product ID: product-ID Enclosure Count: 1 Health: Degraded Health Reason: See the information about unhealthy components for guidance.
show system-parameters Description Shows certain storage-system settings and configuration limits. For a summary of the physical and logical limits of the storage system, see the system configuration limits topic in the SMU help. Syntax show system-parameters Output ULP Enabled 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.
show task-details Description Shows information about a specified task. Syntax show task-details task Parameters task Task name.
Snapshot Name Name of each snapshot taken, or blank Snapshot Serial Serial number of each snapshot taken, or blank For a ResetSnapshot task: Task Name Task name Task Type ResetSnapshot Status • Uninitialized: Task is not yet ready to run • Ready: Task is ready to run • Active: Task is running • Error: Task has an error • Invalid: Task is invalid Task State Current step of the task: • Start • VerifySnap • UnmapSnap • ResetSnap Error Message Message if an error occurred while processing the task, or blank Sna
Task State Current step of the task: • Start • VerifyVolume • CreateName • ObtainMap • UnmapVolume • CreateVolume • RemapVolume • VerifyCreatedVolume Error Message Message if an error occurred while processing the task, or blank Source Volume Name of the volume to be copied Source Volume Serial Serial number of the volume to be copied Destination Vdisk Name of the destination vdisk Destination Vdisk Serial Serial number of the destination vdisk Prefix Label that identifies copies created by this task.
Task State Current step of the task: • Start • VerifyVolume • CreateName • RepVolume • VerifySnap Error Message Message if an error occurred while processing the task, or blank Primary Volume Name Name of the volume to replicate Primary Volume Serial Number Serial number of the volume to replicate Prefix Label that identifies copies created by this task. Volume names have the format prefix_s#, where # starts at 001. Mode • new-snapshot: Replicate a new snapshot of the primary volume.
For a DisableDSD task: Task Name Task name Task Type DisableDSD Status • Uninitialized: Task is not yet ready to run • Ready: Task is ready to run • Active: Task is running • Error: Task has an error • Invalid: Task is invalid Task State Current step of the task; always Start Error Message Message if an error occurred while processing the task, or blank Example Show information about task Snap: # show task-details Snap Tasks ----Task Name: Snap Task Type: TakeSnapshot Status: Ready Task State: Start Error M
show tasks Description Shows information about all tasks.
For a ResetSnapshot task: Task Name Task name Task Type ResetSnapshot Status • Uninitialized: Task is not yet ready to run • Ready: Task is ready to run • Active: Task is running • Error: Task has an error • Invalid: Task is invalid Task State Current step of the task: • Start • VerifySnap • UnmapSnap • ResetSnap Error Message Message if an error occurred while processing the task, or blank Snapshot Name Name of the snapshot to reset Snapshot Serial Number Serial number of the snapshot to reset For a Volume
Error Message Message if an error occurred while processing the task, or blank Source Volume Name of the volume to be copied Source Volume Serial Serial number of the volume to be copied Destination Vdisk Name of the destination vdisk Destination Vdisk Serial Serial number of the destination vdisk Prefix Label that identifies copies created by this task. Volume names have the format prefix_c#, where # starts at 001. Modified Data • modified: The copy includes modified snapshot data.
Mode • new-snapshot: Replicate a new snapshot of the primary volume. • last-snapshot: Replicate the most recent existing snapshot of the primary volume.
Example Show information about all tasks: # show tasks Tasks ----Task Name: Snap Task Type: TakeSnapshot Status: Ready Task State: Start Error Message: Task Details -----------Source Volume: MV Source Volume Serial: SN Prefix: MV Count: 1 Last Created: MV_S0001 Snapshot Name Snapshot Serial -----------------------------------------------------MV_S0001 SN Task Name: Reset Task Type: ResetSnapshot Status: Ready Task State: Start Error Message: Task Details -----------Snapshot Name: VD1_V1_S0001 Snapshot Seri
Task Name: Replicate Task Type: ReplicateVolume Status: Ready Task State: Start Error Message: Task Details -----------Primary Volume Name: VD1_V2 Primary Volume Serial Number: SN Prefix: VD1_V2 Mode: new-snapshot Count: 1 Last Created: MV_S0001 Last Used Snapshot: N/A Snapshot Name Snapshot Serial -----------------------------------------------------MV_S0001 SN Task Name: taskDSDresume Task Type: EnableDSD Status: Ready Task State: Start Error Message: Task Name: taskDSDsuspend Task Type: DisableDSD Stat
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.
show users Description Shows configured user accounts. Syntax show users [user] [show-snmp-password] Parameters user Optional. User name to show settings for. show-snmp-password Optional. Minimum role: manage. For SNMPv3 users, this parameter shows Password and Privacy Password values in clear text for reference when configuring users in the corresponding management application. If this parameter is omitted, password values are displayed obscured for security reasons. Output Username User name.
Privacy Type • DES: Data Encryption Standard. • AES: Advanced Encryption Standard. • none: No encryption. This is the default. Password User password. For a standard user the password is represented by eight asterisks. For an SNMPv3 user this is the authentication password. Privacy Password Encryption password for an SNMPv3 user whose privacy type is set to DES or AES. Trap Host SNMP trap destination for an SNMPv3 user that can receive trap notifications.
Basetypes • users • status See also • create user • delete user • set user show users 327
show vdisks Description Shows information for all or specified vdisks. Syntax show vdisks [vdisks] Parameters vdisks Optional. A comma-separated list of the names or serial numbers of the vdisks to show information about. For vdisk syntax, see "Command syntax" (page 20).
Status • CRIT: Critical. The vdisk is online but isn't fault tolerant because some of its disks are down. • FTDN: Fault tolerant with a down disk. The vdisk is online and fault tolerant, but some of its disks are down. • FTOL: Fault tolerant and online. • OFFL: Offline. Either the vdisk is using offline initialization, or its disks are down and data may be lost. • QTCR: Quarantined critical. The vdisk is critical with at least one inaccessible disk.
Health • OK • Degraded • Fault • 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.
show vdisk-statistics Description Shows live or historical performance statistics for vdisks. You can view live statistics for all or specified vdisks, or historical statistics for a specified vdisk. The system samples disk-performance statistics every quarter hour and retains performance data for 6 months. The historical option allows you to specify a time range or a number (count) of data samples to include.
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. The system will return the oldest sample taken after the start time and the latest sample taken before the end time.
Data Transferred Total amount of data read and written since the last sampling time. Total B/s Data transfer rate, in bytes per second, for read and write operations since the last sampling time. Sample Time Date and time, in the format year-month-day hour:minutes:seconds, when the data sample was taken. Output Name (Historical, Vdisk name. All) Serial Number Vdisk serial number. Data Transferred Total amount of data read and written since the last sampling time. Data Read Shown by the all parameter.
Show historical statistics from a specified date and time range for vdisk VD2: # show vdisk-statistics VD2 historical time-range "start 2013-01-18 4:40 PM end 2013-01-18 5:00 PM" Name Serial Number ------------------------------------------VD2 SN Data Transferred Total B/s Sample Time ------------------------------------------------30.5GB 33.9MB 2012-01-18 17:00:00 31.5GB 35.0MB 2012-01-18 16:45:00 ------------------------------------------Success: Command completed successfully.
show volumecopy-status Description Shows information about in-progress volume copy operations. While a volume copy is in progress, the destination volume cannot be accessed. Syntax show volumecopy-status [controller a|b|both] Parameters controller a|b|both Optional. Shows volume copy operations for volumes owned by controller A only, by controller B only, or by either controller (both). If this parameter is omitted, all volume copy operations are shown.
show volume-maps Description Shows mapping information for a specified volume or for all volumes. Syntax show volume-maps [volume] Parameters volume Optional. The name or serial number of the volume for which to show mappings. For volume syntax, see "Command syntax" (page 20). If this parameter is omitted, information for all volumes is shown. Output Volume information: Serial Number Volume serial number Name Volume name Mapping information: Ports • Controller host ports that the mapping applies to.
Basetypes • volume-view • status See also • show host-maps • show hosts • show volumes show volume-maps 337
show volume-names Description Shows volume names and serial numbers. This reduced form of the show volumes command is optimized for seeking basic volume information from a remote system. 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. For volume syntax, see "Command syntax" (page 20). If this parameter is omitted, information is shown for all volumes. Output Name The name of the volume.
show volume-reservations Description Shows persistent reservations for all or specified volumes. The persistent group reservations (PGR) mechanism enables application clients on multiple hosts to control access to a storage volume, and limits access by other hosts. Each host must be registered with the storage system in order to establish a persistent reservation for a volume, thereby becoming a reservation holder.
Example Show reservations for all volumes: # show volume-reservations all Name Serial Number Volume Reserved Host ID Port Reservation Type ----------------------------------------------------------------------------vd04_v001 SN Free Undefined Reserved vd04_v002 SN iqn.1991-05.com.microsoft:andiamo A3 Exclusive Access ----------------------------------------------------------------------------Success: Command completed successfully.
show volumes Description Shows volume information for all or specified vdisks. Syntax show volumes [vdisk vdisks] [class standard|ptsnap] [type snap-pool|mastervolume|snapshot|standard|primary-volume| secondary-volume|replication-volume] [volumes] Parameters vdisk vdisks Optional. A comma-separated list of the names or serial numbers of the vdisks containing the volumes to show. For vdisk syntax, see "Command syntax" (page 20). class standard|ptsnap Optional. Specifies the class of volumes to show.
Read Ahead Size 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 non-RAID and RAID-1 vdisks internally as if they have a stripe size of 512 KB, even though they are not striped. • 512 KB, 1 MB, 2 MB, 4 MB, 8 MB, 16 MB, or 32 MB: Size selected by a user.
Health Recommendation If Health is not OK, this field shows recommended actions to take to resolve the health issue. Example Show volume information for standard volumes only: # show volumes type standard Vdisk Name Size Serial Number WR Policy Cache Opt Read Ahead Size Type Class Qualifier Volume Description WWN Health Health Reason Health Recommendation ----------------------------------------------------------------------------VD1 V1 444.
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. Statistics shown only in XML API output are described in "XML API basetype properties" (page 367). Syntax show volume-statistics [volumes] Parameters volumes Optional.
See also • reset all-statistics • reset volume-statistics • show controller-statistics • show disk-statistics • show host-port-statistics • show vdisk-statistics • show volumes show volume-statistics 345
shutdown Description Shuts down the Storage Controller in a controller module. This ensures that a proper failover sequence is used, which includes stopping all I/O operations and writing any data in write cache to disk. If the Storage Controller in each controller module is shut down, hosts cannot access the system’s data. Perform a shut down before removing a controller module or powering down the system. Syntax shutdown [a|b|both] Parameters a|b|both Optional.
start vdisk Description Restarts a vdisk that was stopped in order to move its disks into this system. For a replication set, starting a vdisk is part of the process for moving a secondary volume from a primary system into a secondary system. The process to move a secondary volume is: 1. In the system where the secondary volume resides: a. Detach the secondary volume. b. If the secondary volume’s vdisk contains other secondary volumes, detach those volumes. c. Stop the secondary volume’s vdisk. d.
stop vdisk Description Stops a vdisk to prepare its disks for removal. For a replication set, stopping a vdisk is part of the process for moving a secondary volume from a primary system into a secondary system. The process to move a secondary volume is: 1. In the system where the secondary volume resides: a. Detach the secondary volume. b. If the secondary volume’s vdisk contains other secondary volumes, detach those volumes. c. Stop the secondary volume’s vdisk. d.
stty (Deprecated) This command has no effect. suspend replication Description Suspends the current replication operation on the specified secondary volume. This command must be issued on the system that owns the secondary volume. Once suspended, the replication must be resumed or aborted to allow the volume to resume normal operation. Syntax suspend replication [set replication-set] replication-volume Parameters set replication-set Optional.
test Description Sends a test message to configured destinations for event notification and managed logs. After issuing this command, verify that the test message reached its destinations.
trust Description Enables an offline vdisk to be brought online for emergency data recovery. This command must be enabled before each use. If used improperly this command can cause unstable operation and data loss; before use, carefully read the cautions and procedures below. The trust command provides an opportunity to recover data from a vdisk that has gone offline due to disk failure.
5. Unseat the spare disks associated with the vdisk to prevent reconstruction. CAUTION: It is recommended to avoid reconstruction after using the trust command. Reconstruction causes heavy usage of disks that were already reporting errors. This usage could cause the disks to fail during reconstruction, which can cause data to be unrecoverable. 6. Enable the trust command. 7. Run the trust command on the vdisk. 8. If the trust command determines that it would be unsafe to proceed, it will fail.
State • AVAIL: Available • FAILED: The disk is unusable. Reasons for this status include: excessive media errors; SMART error; disk hardware failure; unsupported disk. • GLOBAL SP: Global spare • LEFTOVR: Leftover • VDISK: Used in a vdisk • VDISK SP: Spare assigned to a vdisk Partially Recon Target • True: The disk contains partially reconstructed data. • False: The disk does not contain partially reconstructed data. Out Of Sync • True: The disk data is out of sync with other disks in the vdisk.
Continuing the previous example, you decide to re-enable trust and proceed by specifying the unsafe parameter. # trust enable Success: Command completed successfully. - Trust is enabled. (2013-09-17 09:06:48) # trust vdisk VD1 unsafe Location Serial Number Type State Partially Reconstructed Out Of Sync Age ----------------------------------------------------------------------------1.2 SN SAS LEFTOVR False True 6 1.4 SN SAS VDISK False False 7 1.
See also • show vdisks • verify vdisk trust 355
unfail controller Description Allows the partner controller module to recover from a simulated failure performed with the fail command (which requires the manage role). If you attempt to unfail a controller that is operating, the command will have no effect. Syntax unfail controller Example From controller A, unfail the partner controller (B): # unfail controller b Success: Command completed successfully. - Successfully unfailed (unkilled) Storage Controller B.
unmap volume Description Deletes explicit mappings or the default mapping for specified volumes. When an explicit mapping is deleted, access by that host 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 hosts to the volume is controlled by any explicit mappings of those hosts to the volume. If neither mapping exists, the volume is unavailable to hosts.
verify links Description Verifies host-port links. If a remote system is specified, all link paths between the local system and the remote system are tested; otherwise, link paths between controller A and controller B in the local system are tested. The remote system must already have been added by using the create remote-system command. For replication purposes, this tests the links to be used for replication from one system to another system.
Verify all links between the local system and remote system System2: # verify links remote-system System2 Port Type Links --------------------------------------A1 FC A2 FC A3 FC A3,A4,B3,B4 A4 FC A3,A4,B3,B4 B1 FC B2 FC B3 FC A3,A4,B3,B4 B4 FC A3,A4,B3,B4 --------------------------------------------Success: Command completed successfully.
verify remote-link Description Verifies host-port links between the local system and a specified remote system. All link paths, or only paths having a specified link type, between the two systems are tested. The remote system must already have been added by using the create remote-system command. For replication purposes, this tests the links to be used for replication from one system to another system.
Verify only iSCSI links between two systems having FC and iSCSI ports: # verify remote-link remote-system System2 link-type iSCSI Port Type Links --------------------------------------A3 iSCSI A3,A4,B3,B4 A4 iSCSI A3,A4,B3,B4 B3 iSCSI A3,A4,B3,B4 B4 iSCSI A3,A4,B3,B4 --------------------------------------Success: Command completed successfully.
verify vdisk Description Analyzes redundant vdisks to find and fix inconsistencies between their redundancy data and their user data. This command acts on disks that are associated with a vdisk and are neither dedicated spares nor leftovers. This command will fix parity mismatches for RAID 3, 5, 6, and 50, and mirror mismatches for RAID 1 and 10. This command can be performed only on a vdisk whose status is FTOL (fault tolerant and online); it cannot be performed for NRAID or RAID 0.
versions Description Shows firmware and hardware version information for each controller module. Alias: show versions. Syntax versions [detail] Parameters detail Optional. Shows information about the versions of firmware and hardware in each controller module.
volumecopy Description Copies a standard, master, or snapshot volume to a new standard volume. The destination volume you specify must be in a vdisk owned by the same controller as the source volume. If the source volume is a snapshot, you can choose whether to include its modified data (data written to the snapshot since it was created). The destination volume is completely independent of the source volume.
modified-snapshot yes|no Optional. Specifies whether to include or exclude modified write data from the snapshot in the copy. This parameter applies only when the source volume is a snapshot. • yes: Include modified snapshot data. • no: Exclude modified snapshot data. If this parameter is omitted for a snapshot, modified snapshot data is excluded. prompt yes|no|expert Optional.
4 XML 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 XML 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.
advanced-settings-table This basetype is used by show advanced-settings. Table 9 advanced-settings-table properties Name Type Description backgroundscrub string Shows whether disks in vdisks are automatically checked for disk defects to ensure system health. The interval between background vdisk scrub finishing and starting again is specified by the background-scrub-interval parameter. • • Disabled: Background vdisk scrub is disabled. Enabled: Background vdisk scrub is enabled. This is the default.
Table 9 advanced-settings-table properties (continued) Name Type Description dynamic-spares string Shows whether the storage system will automatically use a compatible disk as a spare to replace a failed disk in a vdisk if no compatible spare is available. • • Disabled: The dynamic spares feature is disabled. This is the default. Enabled: The dynamic spares feature is enabled.
Table 9 advanced-settings-table properties (continued) Name Type Description super-capfailure string 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. • • super-capfailure-numeric uint32 compact-flashfailure string Numeric equivalents for super-cap-failure values.
Table 9 advanced-settings-table properties (continued) Name Type Description auto-write-back string Shows whether the cache policy will change from write-through to write-back when the trigger condition is cleared. • • auto-writeback-numeric uint32 disk-dsd-enable string Disabled: Auto-write-back is disabled. Enabled: Auto-write-back is enabled. This is the default. Numeric equivalents for auto-write-back values.
Table 9 advanced-settings-table properties (continued) Name Type Description diskprotection-info string Not supported. diskprotectioninfo-numeric uint32 Not supported. auto-stallrecovery string Shows whether the auto-stall recovery feature is enabled, which 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.
attribute-priorities This basetype is used by show priorities. Table 10 attribute-priorities properties Name Type Description attribute-name string Snapshot retention attribute. • • • • • • • • priority-value string Standard Snapshot Volume Copy Snapshot: A snapshot that is being used to copy data from a source volume to a destination volume. This attribute is temporary for the duration of the volume-copy process.
auto-write-through-trigger This basetype is used by show auto-write-through-trigger. Table 11 auto-write-through-trigger properties Name Type Description controllerfailure string Shows whether the cache policy will change from write-back to write-through when a controller fails. • • super-capfailure string 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.
cache-parameter This basetype is used by show cache-parameters, when a volume is specified, to show volume cache properties. Table 12 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-policynumeric uint32 cacheoptimization string Numeric equivalents for write-policy values.
Table 12 cache-parameter properties (continued) Name Type Description read-aheadsize-numeric uint32 Numeric equivalents for read-ahead-size values.
cache-settings This basetype is used by show cache-parameters to show system cache properties. Table 13 cache-settings properties Name Type Description operation-mode string The system’s operating mode, also called the cache redundancy mode. • • • • 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.
certificate-status This basetype is used by show certificate. Table 14 certificate-status properties Name Type Description certificatestatus string • • certificatestatus-numeric uint32 Numeric equivalents for certificate-status values. certificatetime string Date and time, in the format year-month-day hour:minutes:seconds, when the custom certificate was created. certificatesignature string The first few characters of the certificate file.
chap-records This basetype is used by show chap-records. Table 15 chap-records properties Name Type Description initiator-name string The originator name. initiatorsecret string The secret that the recipient uses to authenticate the originator. oname string For mutual CHAP, the recipient name. osecret string For mutual CHAP, the secret that the originator uses to authenticate the recipient.
cli-parameters This basetype is used by show cli-parameters. Table 16 cli-parameters properties Name Type Description timeout uint32 Time in seconds that the session can be idle before it automatically ends. Valid values are 120–43200 seconds (2–720 minutes). The default is 1800 seconds (30 minutes). output-format string • • • console: Supports interactive use of the CLI by displaying command output in easily readable format.
Table 16 cli-parameters properties (continued) Name Type Description locale string Display language. • • • • • • • • • • locale-numeric uint32 Numeric equivalents for locale values.
Table 16 cli-parameters properties (continued) Name Type Description temperaturescale-numeric uint32 Numeric equivalents for temperature-scale values. user-type string • • The logged-in user's experience level. • • • • user-typenumeric uint32 username string 382 XML API basetype properties 0: Fahrenheit 1: Celsius Novice Standard (the default) Advanced Diagnostic Numeric equivalents for user-type values. • • • • 1: 2: 3: 4: Novice Standard Advanced Diagnostic The logged-in user name.
compact-flash This basetype is used by show controllers. 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. controller-idnumeric uint32 Numeric equivalents for controller-id values.
controller-cache-parameters This basetype is used by show cache-parameters to show controller cache properties. Table 18 controller-cache-parameters properties Name Type Description durable-id string • • cache-params-a: Cache parameters for controller A. cache-params-b: Cache parameters for controller B. controller-id string • • A: Controller A. B: Controller B. controller-idnumeric uint32 Numeric equivalents for controller-id values.
controllers This basetype is used by show controllers. Table 19 controllers properties Name Type Description durable-id string • • controller a controller b controller-id string • • A: Controller A. B: Controller B. controller-idnumeric uint32 • • 0: B 1: A serial-number string • • Serial number of the controller module. Not Available: The controller module is down or not installed. hardwareversion string Controller module hardware version.
Table 19 controllers properties (continued) Name Type Description failed-over string 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.
Table 19 controllers properties (continued) Name Type Description 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 controller's PCBA was programmed. mfg-datenumeric 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.
Table 19 controllers properties (continued) Name Type Description redundancystatus string • • • • Redundant: Both controllers are operational. Operational but not redundant: In active-active mode, one controller is operational and the other is offline. In single-controller mode, the controller is operational. Down: This controller is not operational. Unknown: Status information is not available. Numeric equivalents for redundancy-status values.
controller-statistics This basetype is used by show controller-statistics. Table 20 controller-statistics properties Name Type Description durable-id string • • cpu-load uint32 Percentage of time the CPU is busy, from 0–100. power-on-time uint32 Number of seconds since the controller was restarted. write-cacheused uint32 Percentage of write cache in use, from 0–100. bytes-persecond string Data transfer rate calculated over the interval since these statistics were last requested or reset.
Table 20 controller-statistics properties (continued) Name Type Description start-sampletime 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-sampletime-numeric uint32 Unformatted start-sample-time value. stop-sampletime string Date and time, in the format year-month-day hour:minutes:seconds, when sampling stopped for the iops and bytes-per-second values.
debug-log-parameters This basetype is used by show debug-log-parameters. Table 21 debug-log-parameters properties Name Type Description host-dbg string Shows whether host interface debug messages are enabled for inclusion in the Storage Controller debug log. • • host-dbgnumeric uint32 disk string Numeric equivalents for host values.
Table 21 debug-log-parameters properties (continued) Name Type Description iob string Shows whether resource-count debug messages for an I/O interface driver are enabled for inclusion in the Storage Controller debug log. • • iob-numeric uint32 Numeric equivalents for iob values. • • ioc string uint32 string uint32 string uint32 string uint32 string uint32 Off: Disabled. On: Enabled. This is the default. Numeric equivalents for raid values.
Table 21 debug-log-parameters properties (continued) Name Type Description cache string Shows whether cache debug messages are enabled for inclusion in the Storage Controller debug log. • • cache-numeric uint32 Numeric equivalents for cache values. • • emp string uint32 string uint32 string uint32 string uint32 string uint32 0: Off 1: On Shows whether debug messages for auto-write-through cache triggers are enabled for inclusion in the Storage Controller debug log.
Table 21 debug-log-parameters properties (continued) Name Type Description res2 string Shows whether internal debug messages are enabled for inclusion in the Storage Controller debug log. • • res2-numeric uint32 Numeric equivalents for res2 values. • • capi2 string uint32 string uint32 string uint32 string uint32 0: Off 1: On Shows whether Reservation Manager debug messages are enabled for inclusion in the Storage Controller debug log. • • resmgr-numeric Off: Disabled. On: Enabled.
disk-hist-statistics This basetype is used by show disk-statistics when the historical parameter is specified. Table 22 disk-hist-statistics properties Name Type Description number-of-ios uint64 Total number of read and write operations since the last sampling time. number-of-reads uint64 Number of read operations since the last sampling time. number-ofwrites uint64 Number of write operations since the last sampling time.
Table 22 disk-hist-statistics properties (continued) Name Type Description avg-io-sizenumeric uint32 Unformatted avg-io-size value. avg-read-iosize string Average data size of read operations since the last sampling time. avg-read-iosize-numeric uint32 Unformatted avg-read-io-size value. avg-write-iosize string Average data size of write operations since the last sampling time. avg-write-iosize-numeric uint32 Unformatted avg-write-io-size value.
disk-statistics This basetype is used by show disk-statistics when the historical parameter is omitted. Table 23 disk-statistics properties Name Type Description durable-id string Disk ID in the form disk_enclosure-number.disk-number. serial-number string Disk serial number. bytes-persecond string Data transfer rate 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 23 disk-statistics properties (continued) Name Type Description number-ofmedia-errors-1 uint32 For port 1, the number of media errors generated by the disk, as specified by its manufacturer. number-ofnonmediaerrors-1 uint32 For port 1, the number of other errors generated by the storage system, or generated by the disk and not categorized as media errors. number-ofblockreassigns-1 uint32 For port 1, the number of times blocks were reassigned to alternate locations.
drive-parameters This basetype is used by show disk-parameters. Table 24 drive-parameters properties Name Type Description smart string Shows whether SMART (Self-Monitoring Analysis and Reporting Technology) is enabled or disabled for disks. • • • smart-numeric uint32 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.
drive-summary This basetype is used by show disk-statistics when the historical parameter is specified. Table 25 drive-summary properties Name Type Description durable-id string Disk ID in the form disk_enclosure-number.disk-number. serial-number string Disk serial number. disk-histstatistics Embedded; see disk-hist-statistics.
drives This basetype is used by show disks. Table 26 drives properties Name Type Description durable-id string Disk ID in the form disk_enclosure-ID.slot-number. enclosure-id uint32 Enclosure ID. drawer-id unint8 Not applicable. slot uint32 Disk slot number. location string Disk's enclosure ID and slot number. port uint32 For internal use only. scsi-id uint32 SCSI ID assigned to this disk for the primary channel. blocks uint64 Unformatted size value in 512-byte blocks.
Table 26 drives properties (continued) Name Type Description job-runningnumeric string Numeric equivalents for job-running values. current-jobcompletion • • • • • • • 0: None 2: INIT 3: RCON 4: VRFY 5: EXPD 6: VRSC 7: DRSC string • • 0%–99%: Percent complete of running job. (blank): No job is running (job has completed). blink uint32 Deprecated; locator LED status now shown by locator-led property. locator-led uint32 • • speed uint32 Not used.
Table 26 drives properties (continued) Name Type Description index uint32 For internal use only. rpm uint32 The speed of a spinning disk, in thousands of revolutions per minute, as specified by the disk vendor. For an SSD, 0 is shown. size string Disk capacity, formatted to use the current base, precision, and units. size-numeric string Unformatted size value in 512-byte blocks. transfer-rate string Disk data transfer rate in Gbit/s. It is normal behavior for the rate to vary. • • • 1.
Table 26 drives properties (continued) Name Type Description usage-numeric string Numeric equivalents for usage values. • • • • • • • recon-state string 0: 1: 2: 3: 5: 7: 8: AVAIL VDISK VDISK SP GLOBAL SP LEFTOVR FAILED UNUSABLE The state of the disk (source or destination) if it is involved in a reconstruct operation. • • • From: This disk is being used as the source of a reconstruct operation. To: This disk is being used as the target of a reconstruct operation.
Table 26 drives properties (continued) Name Type Description disk-dsd-count uint32 Number of times the DSD feature has spun down this disk. spun-down uint32 Shows whether the disk is spun down by the DSD feature. • • 0: Not spun down. 1: Spun down. number-of-ios uint64 Total number of I/O operations (reads and writes). total-datatransferred bytes Total bytes transferred. total-datatransferrednumeric uint64 Unformatted total-data-transferred value.
Table 26 drives properties (continued) Name Type Description pi-formatted string Not supported. pi-formattednumeric uint32 Not supported. health string Disk health. • • • • • health-numeric uint32 OK Degraded Fault Unknown N/A Numeric equivalents for health values. • • • • • 0: 1: 2: 3: 4: OK Degraded Fault Unknown N/A health-reason string If Health is not OK, the reason for the health state.
email-parameters This basetype is used by show email-parameters. Table 27 email-parameters properties Name Type Description emailnotification string Shows whether email (SMTP) notification of events is enabled. emailnotificationnumeric uint32 emailnotificationfilter string • • Disabled: Email notification is disabled. This is the default. Enabled: Email notification is enabled. Numeric equivalents for email-notification values.
enclosure-fru This basetype is used by show frus. Table 28 enclosure-fru properties Name Type Description name string FRU name. • • • • CHASSIS_MIDPLANE: 2U chassis and midplane circuit board RAID_IOM: Controller module BOD_IOM: Expansion module POWER_SUPPLY: Power supply module 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.
enclosure-list This basetype is used by show disks when the encl parameter is specified. Table 29 enclosure-list properties Name Type Description status string Disk slot status. • • • • • • status-numeric uint32 Up: The disk is present and is properly communicating with the expander. Spun Down: The disk is present and has been spun down by the drive spin down feature. Warning: The disk is present but the system is having communication problems with the disk LED processor.
enclosures This basetype is used by show enclosures. Table 30 enclosures properties Name Type Description durable-id string Enclosure ID in the form enclosure_number. enclosure-id uint8 Enclosure ID. enclosure-wwn string Enclosure WWN. name string Enclosure name. location string Enclosure location; blank if not set. rack-number uint8 Number of the rack containing the enclosure. rack-position uint8 Position of the enclosure in the rack.
Table 30 enclosures properties (continued) Name Type Description part-number string FRU part number. mfg-date string Date and time, in the format year-month-day hour:minutes:seconds (UTC), when a PCBA was programmed or a power supply module was manufactured. mfg-datenumeric string Unformatted mfg-date value. mfg-location string City, state/province, and country where the FRU was manufactured. description string FRU long description. revision string Hardware revision level for the FRU.
Table 30 enclosures properties (continued) Name Type Description midplane-type string Enclosure midplane type.
enclosure-sku This basetype is used by show frus. Table 31 enclosure-sku properties Name Type Description sku-partnumber string System part number. sku_serialnumber string System serial number. sku-revision System revision level.
events This basetype is used by show events. Table 32 events 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-stampnumeric uint32 Unformatted time-stamp value. event-code string Event code. For event-code descriptions, see the Event Descriptions Reference Guide. event-id string Event ID. model string Controller model. serial-number string Controller serial number.
expander-ports This basetype is used by show sas-link-health. Table 33 expander-ports properties Name Type Description durable-id string Expander port ID. enclosure-id uint32 Enclosure ID. controller string • • controllernumeric uint32 Numeric equivalents for controller values. name string A: Controller A. B: Controller B. • • 0: B 1: A • Out Port: Egress (expansion) port on controller module or an expansion module. Can be connected to an ingress port in an expansion module.
fan This basetype is used by show fans. Table 34 fan properties Name Type Description durable-id string Fan unit ID in the form fan_enclosure-ID.fan-number. name string Fan unit name in the form Fan loc:position-PSU power-supply-ID for a controller enclosure or MSA 2040 drive enclosure; Fan fan-unit-ID for a D2700 enclosure. The position is as viewed from the back of the enclosure. location string Fan location in the form Enclosure enclosure-ID - position.
Table 34 fan properties (continued) Name Type Description health-reason string If Health is not OK, the reason for the health state. healthrecommendation string If Health is not OK, the recommended actions to take to resolve the health issue.
fc-port This basetype is used by show ports and show host-parameters for a Fibre Channel port. Table 35 fc-port properties Name Type Description configuredtopology string Configured topology. primary-loop-id string If the port is using loop topology and the port status is Up, this field shows the primary loop ID. If the port is not using loop topology or the port status is not Up, this field shows N/A.
fde-state This basetype is used by show fde-state. Table 36 fde-state properties Name Type Description fde-securitystatus string Shows whether the system is secured or unsecured: • • • • fde-securitystatus-numeric uint32 lock-key-id string Unsecured: The system has not been secured with a passphrase. Secured: The system has been secured with a passphrase. Secured, Lock Ready: The system has been secured and lock keys are clear. The system will become locked after the next power cycle.
host-port-statistics This basetype is used by show host-port-statistics. Table 37 host-port-statistics properties Name Type Description durable-id string Host port ID in the form hostport_controller-ID-and-port-number. bytes-persecond string Data transfer rate 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. bytes-persecond-numeric uint32 Unformatted bytes-per-second value.
hosts This basetype is used by show hosts. Table 38 hosts properties Name Type Description host-id string FC or SAS host port WWN, or iSCSI host initiator node name (typically the IQN). host-name string User-defined name of the host port, or blank. host-discovered string • • Yes: The host was discovered and its entry was automatically created. No: The host entry was manually created. host-mapped string • • Yes: At least one volume is explicitly mapped to the host.
host-view This basetype is used by show host-maps. Table 39 host-view properties Name Type Description id string FC or SAS host port WWN, or iSCSI host initiator node name (typically the IQN). hba-nickname string User-defined name of the host port, or blank. host-profile string • • host-viewmapping Embedded; see host-view-mappings. 422 XML API basetype properties Standard: Default profile. HP-UX: The host uses Flat Space Addressing.
host-view-mappings This basetype is used by show host-maps. Table 40 host-view-mappings properties Name Type Description volume-name string Volume name. volume-serial string Volume serial number. lun string LUN assigned to the mapping. access string Type of access assigned to the mapping. • • • ports string read-write: Host has read and write access to the volume. read-only: Host has read access to the volume. no-access: Host is denied access to the volume.
inquiry This basetype is used by show inquiry. Table 41 inquiry properties Name Type Description mc-fw string Management Controller firmware version. mc-loader string Management Controller loader firmware version. sc-fw string Storage Controller firmware version. sc-loader string Storage Controller loader firmware version. serial-number string Controller serial number. mac-address string Controller network port MAC address. ip-address string Controller network port IP address.
io-modules This basetype is used by show enclosures. Table 42 io-modules properties Name Type Description durable-id string I/O module ID. controller-id string • • controller-idnumeric uint32 Numeric equivalents for controller-id values. name string FRU name. 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.
Table 42 io-modules properties (continued) Name Type Description status string • • • • status-numeric uint32 Numeric equivalents for status values. Operational Down Not installed Unknown • • • • 0: 1: 2: 3: OK Degraded Fault N/A Operational Down Not installed Unknown health string • • • • health-numeric uint32 Numeric equivalents for health values. • • • • 0: 1: 2: 4: OK Degraded Fault N/A health-reason string If Health is not OK, the reason for the health state.
iscsi-parameters This basetype is shown by show iscsi-parameters. Table 43 iscsi-parameters properties Name Type Description chap string Shows whether Challenge-Handshake Authentication Protocol (CHAP) is enabled. • • chap-numeric uint32 Numeric equivalents for chap values. • • jumbo-frames string uint32 isns string • • uint32 Enabled: Jumbo-frame support is enabled. Disabled: Jumbo-frame support is disabled. This is the default. Numeric equivalents for jumbo-frames values.
iscsi-port This basetype is used by show ports and show host-parametersfor an iSCSI host port. Table 44 iscsi-port properties Name Type Description ip-version string iSCSI IP version. • • IPv4: iSCSI host port addresses use IPv4 format. This is the default. IPv6: iSCSI host port addresses use IPv6 format. ip-address string Assigned port IP address. gateway string For IPv4, gateway IP address for assigned IP address. netmask string For IPv4, subnet mask for assigned IP address.
license This basetype is used by show license. Table 45 license properties Name Type Description license-key string • • key: License is installed and valid. not installed: License is invalid or is not installed. platform-maxsnapshots uint32 Maximum number of snapshots that the highest-level license allows. base-maxsnapshots uint32 Maximum number of snapshots allowed without an installed license. max-snapshots uint32 Maximum number of snapshots allowed by the installed license.
Table 45 license properties (continued) Name Type Description remotesnapshotreplicationexpiry-numeric uint32 Numeric equivalents for remote-snapshot-replication values. vds string • • • Shows whether the VDS (Virtual Disk Service) Hardware Provider is enabled. • • vds-numeric uint32 string uint32 vss string • uint32 string uint32 dsd string string uint32 sra string 0: Never Shows whether Storage Replication Adapter (SRA) support is enabled. Disabled: SRA is disabled.
Table 45 license properties (continued) Name Type Description sra-expiry string Shows when the SRA feature will expire. • sra-expirynumeric uint32 Never: Always enabled and doesn't expire. Numeric equivalents for sra-expiry values.
log-header-table This basetype is used in the log file downloaded from the system by using the SMU or FTP. Table 46 log-header-table properties Name Type Description log-contact string Contact person's name, if specified in the SMU Save Logs panel. log-email string Contact's email address, if specified in the SMU Save Logs panel. log-phone string Contact's phone number, if specified in the SMU Save Logs panel.
master-volumes This basetype is shown by show master-volumes. Table 47 master-volumes properties Name Type Description virtual-diskname string Vdisk name. serial-number string Master volume serial number. name string Master volume name. size string Master volume size, formatted to use the current base, precision, and units. size-numeric uint32 Unformatted size value in 512-byte blocks. status string Master volume status.
network-parameters This basetype is used by show network-parameters. Table 48 network-parameters properties Name Type Description durable-id string Controller network port ID in the form mgmtport_controller-ID. active-version uint32 The configured network port IP version. • 4: IPv4 ip-address string Controller network port IP address.
Table 48 network-parameters properties (continued) Name Type Description ping-broadcast string • • ping-broadcastnumeric uint32 Numeric equivalents for ping-broadcast values. • • Enabled: The system will respond to a broadcast ping. Disabled: The system will not respond to a broadcast ping.
ntp-status This basetype is used by show ntp-status. Table 49 ntp-status properties Name Type Description ntp-status string Shows whether use of Network Time Protocol (NTP) is enabled. ntp-serveraddress string • • activated: NTP is enabled. deactivated: NTP is disabled. This is the default. • • The current NTP server IP address if NTP is enabled. The last-set NTP server IP address if NTP was enabled and has been disabled. 0.0.0.0 if the NTP server IP address has not been set.
policy-threshold This basetype is used by show snap-pools. Table 50 policy-threshold properties Name Type Description threshold string Snap pool threshold level: • • • Warning: The snap pool is moderately full. When this threshold is reached, an event is generated to alert the administrator. The default is 75%. Error: The snap pool is nearly full and unless corrective action is taken, snapshot data loss is probable.
port This basetype is used by show ports. Table 51 port properties Name Type Description durable-id string Controller host port ID in the form hostport_controller-ID-and-portnumber. controller string • • controllernumeric uint32 Numeric equivalents for controller values. port string Controller ID and port number. port-type string • • • port-typenumeric uint32 Numeric equivalents for port-type values. media • • A: Controller A. B: Controller B. 0: B 1: A FC: Fibre Channel.
Table 51 port properties (continued) Name Type Description actual-speed string Actual link speed in Mbit/s or Gbit/s. • • • • • • • • • • • • • actual-speednumeric uint32 configuredspeed string configuredspeed-numeric uint32 health string 10Mb 100Mb 1Gb 1.5Gb 2Gb 3Gb 4Gb 6Gb 8Gb 10Gb 12Gb 16Gb (blank): Port is disconnected. Numeric equivalents for actual-speed values. • • • • • • • • • • • • • 0: 1Gb 1: 2Gb 2: 4Gb 4: 1.
Table 51 port properties (continued) Name Type Description health-numeric string Numeric equivalents for health values. • • • • 0: 1: 2: 4: OK Degraded Fault N/A health-reason string If Health is not OK, the reason for the health state. healthrecommendation string If Health is not OK, the recommended actions to take to resolve the health issue. port-details Embedded; see fc-port, iscsi-port, sas-port.
power-supplies This basetype is used by show power-supplies. Table 52 power-supplies properties Name Type Description durable-id string Power supply ID in the form psu_enclosure-ID.power-supply-number. enclosure-id uint32 Enclosure ID. serial-number string Power supply serial number. description string FRU long description. name string • • revision string FRU hardware revision level. model string Power supply model. vendor string Power supply vendor.
Table 52 power-supplies properties (continued) Name Type Description health string • • • • health-numeric uint32 Numeric equivalents for health values. • • • • OK Degraded Fault Unknown 0: 1: 2: 3: OK Degraded Fault Unknown health-reason string If Health is not OK, the reason for the health state. healthrecommendation string If Health is not OK, the recommended actions to take to resolve the health issue. status string Power supply status.
product-info This basetype is used by show inquiry. Table 53 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. Table 54 provisioning properties Name Type Description volume string • • volume-serial string Volume serial number. wwn string • • controller string Owning controller of the vdisk. • • Volume name. Blank if vdisk does not have a volume. Volume World Wide Name. Blank if vdisk does not have a volume. A: Controller A. B: Controller B. Numeric equivalents for controller values.
redundancy This basetype is used by show redundancy-mode. Table 55 redundancy properties Name Type Description redundancy-mode string The system’s operating mode, also called the cache redundancy mode. • • • • redundancymode-numeric uint32 redundancystatus string Numeric equivalents for redundancy-mode values. • • • • 2: 3: 4: 5: • • Redundant: Both controllers are operational. Operational but not redundant: In active-active mode, one controller is operational and the other is offline.
Table 55 redundancy 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. • • • • other-MCstatus-numeric 446 XML API basetype properties uint32 Not Communicating Not Operational Operational Unknown Numeric equivalents for other-mc-status values.
refresh-counters This basetype is used by show refresh-counters. Table 56 refresh-counters properties Name Type Description basetype-name (Not shown) Shows when the data represented by the base type was last updated. • • 0: The data has never been updated and is not cached. nonzero-number: A timestamp indicating that the data has been updated. If the value has changed since the last time you called this command then the data has changed.
remote-addresses This basetype is used by show replication-volumes. Table 57 remote-addresses properties Name Type Description connected-ports string • • remote-address 448 XML API basetype properties string port-IDs: For a remote primary or secondary volume, the IDs of up to two hosts ports in the local system that are connected to the remote system. If two ports are connected but only one is shown, this indicates that a problem is preventing half the available bandwidth from being used.
remote-links This basetype is used by verify links and verify remote-link. Table 58 remote-links properties Name Type Description local-host-port string Controller host port ID in the local system, in the form hostport_controller-ID-and-port-number. type string • • • type-numeric uint32 Numeric equivalents for type values. • • • remote-links string Unknown: Port type is unknown. FC: FC port. iSCSI: iSCSI port.
remote-system This basetype is used by show remote-systems. Table 59 remote-system properties Name Type Description id string Remote system ID. system-name string • • The name of the remote system. Uninitialized Name: The default value. system-contact string • • The name of the person who administers the remote system. Uninitialized Contact: The default value. system-location string • • The location of the remote system. Uninitialized Location: The default value.
Table 59 remote-system properties (continued) Name Type Description storage-modelnumeric uint32 Numeric equivalents for storage-model values. isvalid-ip-a string • 0: LINEAR • False: The IP address is not valid for controller module A in the remote system. True: The IP address is valid for controller module A in the remote system. • isvalid-ip-anumeric uint32 isvalid-ip-b isvalid-ip-bnumeric Numeric equivalents for isvalid-ip-a values.
replicate-volume-tasks This basetype is used by show tasks and show task-details for a ReplicateVolume task. Table 60 replicate-volume-tasks properties Name Type Description primary-volumename string Primary volume name. primary-volumeserial string Primary volume serial number. snapshot-prefix string A label to identify snapshots created by this task. Snapshot names have the format prefix_s#, where # starts at 001.
replication-image This basetype is used by show replication-images. Table 61 replication-image properties Name Type Description image-key string Replication image ID. replicationvolume-serialnumber string Replication volume serial number. image-serialnumber string Replication image serial number. replicationimage-source string Name of the source replication image. snapshot-serial string Replication snapshot serial number associated with the image.
replication-image-params This basetype is used by show replication-images. Table 62 replication-image-params properties Name Type Description status string Replication image status. • • • • • • • status-numeric uint32 N/A: The image information is not valid. Queued: The image is known to exist in the primary-view volume but replication has not started. Replicating: The image is being replicated. Suspended: The image is being replicated but replication is suspended.
replication-set This basetype is used by show replication-sets. Table 63 replication-set properties Name Type Description name string Replication set name. serial-number string Replication set serial number. primary Embedded; see replication-volume.
replication-volume This basetype is used by show replication-volumes. Table 64 replication-volume properties Name Type Description name string Replication volume name. serial-number string Replication volume serial number. status string Replication volume status. • • • • • • • • • status-numeric uint32 Numeric equivalents for status values.
Table 64 replication-volume properties (continued) Name Type Description monitor-numeric uint32 Numeric equivalents for monitor values. • • 2: OK • • Local: The replication volume is in the local system. Remote: The replication volume is in a remote system. other: Failed location string locationnumeric uint32 ip-address-a string IP address of the network port in controller A in the remote system. ip-address-b string IP address of the network port in controller B in the remote system.
Table 64 replication-volume properties (continued) Name Type Description collisionpolicy string Determines the next image to replicate when multiple replication images are queued. • • Newest: Only the latest replication image should be considered for the next replication operation. Oldest: Only the latest n replication images should be considered for the next replication operation, where n is defined by the max-queue property and the oldest of these images should be considered first.
replication-volume-summary This basetype is used by show replication-images. Table 65 replication-volume-summary properties Name Type Description name string Replication volume name. serial-number string Replication volume serial number. volume-type string • • volume-typenumeric uint32 Numeric equivalents for volume-type values. images Embedded; see replication-image. • • Primary Volume: The volume is the primary volume in a replication set.
reset-snapshot-tasks This basetype is used by show tasks and show task-details for a ResetSnapshot task. Table 66 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.
sas-port This basetype is used by show ports and show host-parameters for a SAS host port. Table 67 sas-port properties Name Type Description configuredtopology string • width string Number of PHY lanes in the SAS port. sas-lanesexpected string Expected number of PHY lanes in the SAS port. sas-activelanes string Number of active lanes in the SAS port.
sas-status-controller-a This basetype is used by show expander-status for controller A and controller B. Table 68 sas-status-controller-a properties Name Type Description enclosure-id uint32 Enclosure ID. drawer-id unint8 Not applicable. drawer-idnumeric unint8 Not applicable. controller string • • controllernumeric uint32 Numeric equivalents for controller values.
Table 68 sas-status-controller-a properties (continued) Name Type Description status-numeric uint32 Numeric equivalents for status values. • • • • elem-status string • • • • uint32 elem-disabled Unavailable Enabled - Healthy Enabled - Degraded Disabled The SES status that corresponds to the PHY status. • • elem-statusnumeric 0: 1: 2: 3: Disabled: Critical condition is detected. Error: Unrecoverable condition is detected.
Table 68 sas-status-controller-a properties (continued) Name Type Description elem-reasonnumeric uint32 Numeric equivalents for elem-reason values. change-counter uint32 Number of times the PHY originated a BROADCAST (CHANGE). A BROADCAST (CHANGE) is sent if doubleword synchronization is lost or at the end of a Link Reset sequence. code-violations uint32 Number of times the PHY received an unrecognized or unexpected signal.
schedules This basetype is used by show schedules and show schedule-details. Table 69 schedules properties Name Type Description name string Schedule name. schedulespecification string Schedule settings for running the associated task. status string Schedule status. • • • • • Uninitialized: The schedule is not yet ready to run. Ready: The schedule is ready to run at the next scheduled time. Suspended: The schedule had an error and is holding in its current state.
security-communications-protocols This basetype is used by show protocols. Table 70 security-communications-protocols properties Name Type Description wbi-http string • • wbi-httpnumeric uint32 Numeric equivalents for wbi-http values. wbi-https Disabled: The standard WBI web server is disabled. Enabled: The standard WBI web server is enabled. This is the default. • • 0: Disabled 1: Enabled string • • Disabled: The secure WBI web server is disabled.
Table 70 security-communications-protocols properties (continued) Name Type Description snmp-numeric uint32 Numeric equivalents for snmp values. • • 0: Disabled 1: Enabled Disabled: The Telnet debug port is disabled. This is the default. Enabled: The Telnet debug port is enabled. Remote connection is allowed, through incoming ports only, by HP or HP’s authorized representatives for troubleshooting. Disabling the service debug protocol removes this access.
sensors This basetype is used by show sensor-status. Table 71 sensors properties Name Type Description durable-id string Sensor ID. For example: sensor_temp_ctrl_controller-ID.sensornumber and sensor_volt_ctrl_controller-ID.sensor-number. enclosure-id uint32 Enclosure ID. sensor-name string Sensor name and location. value string • • For a sensor, its value. For overall unit status, one of the status values below.
show-other-mc-status This basetype is used by show shutdown-status. Table 72 show-other-mc-status properties Name Type Description other-mc string Other MC Status other-mc-status string The operational status of the Management Controller in the partner controller. This is not factored into system health. • • • • other-mcstatus-numeric uint32 Not Communicating Not Operational Operational Unknown Numeric equivalents for other-mc-status values.
shutdown-status This basetype is used by show shutdown-status. Table 73 shutdown-status properties Name Type Description controller string • • A: Controller A. B: Controller B. status string • • • up: The controller is operational. down: The controller is shut down. not installed: The controller is not installed. status-numeric uint32 Numeric equivalents for status values.
snap-pools This basetype is used by show snap-pools. Table 74 snap-pools properties Name Type Description virtual-diskname string Vdisk name. serial-number string Snap pool serial number. name string Snap pool name. size string Snap pool size, formatted to use the current base, precision, and units. size-numeric uint32 Unformatted size value in 512-byte blocks. reserved-size string Not applicable. reserved-sizenumeric uint32 Not applicable.
snapshots This basetype is used by show snapshots. Table 75 snapshots properties Name Type Description virtual-diskname string Vdisk name. serial-number string Snapshot serial number. name string Snapshot name. creation-datetime string Date and time, in the format year-month-day hour:minutes:seconds (UTC), when the snapshot was prepared or committed. creation-datetime-numeric uint32 Unformatted creation-date-time value. status string Snapshot status.
Table 75 snapshots properties (continued) Name Type Description uniquedatanumeric uint32 Unformatted uniquedata value in 512-byte blocks. shareddata string Amount of preserved and write data that is shared between this snapshot and other snapshots. shareddatanumeric uint32 Unformatted shareddata value in 512-byte blocks. priority-value string Retention priority for the snapshot, based on the snapshot attributes and the userdefined retention priority for the snapshot type.
Table 75 snapshots properties (continued) Name Type Description snapshot-typenumeric uint32 Numeric equivalents for snapshot-type values.
snapshot-with-retention-tasks This basetype is used by show tasks and show task-details for a TakeSnapshot task. Table 76 snapshot-with-retention-tasks properties Name Type Description master-volumename string Source volume name. master-volumeserial string Source volume serial number. snapshot-prefix string A label to identify snapshots created by this task. Snapshot names have the format prefix_s#, where # starts at 001.
snap-tasks This basetype is used by show schedules, show schedule-details, show tasks, and show task-details for a task that has created at least one snapshot. Table 77 snap-tasks properties Name Type Description snapshot-name string Snapshot name. snapshot-serial string Snapshot serial number.
snmp-parameters This basetype is used by show snmp-parameters. Table 78 snmp-parameters properties Name Type Description snmp-enabled string Shows whether the Simple Network Management Protocol (SNMP) interface is enabled or disabled. • • snmp-enablednumeric uint32 snmp-filter string Disabled: SNMP is disabled. This is the default. Enabled: SNMP is enabled. Numeric equivalents for snmp-enabled values. • • 0: Disabled 1: Enabled Minimum level of events to include for SNMP traps.
status This basetype is used by all commands except exit, help, and meta. (exit does not provide a response; help always prints text; meta does not use the status object.) Table 79 status properties Name Type Description response-type string • • • Success: The command succeeded. Error: The command failed. Info: The command returned an informational message.
syslog-parameters This basetype is used by show syslog-parameters. Table 80 syslog-parameters properties Name Type Description syslog-host-ip string The IP address of the remote syslog server to use for the notifications. syslognotificationlevel string Shows the minimum severity for which the system sends notifications: syslognotificationlevel-numeric uint32 syslog-hostport uint32 • • • • • crit: Sends notifications for Critical events only.
system This basetype is used by show system. Table 81 system properties Name Type Description system-name string The name of the storage system. The default is Uninitialized Name. system-contact string The name of the person who administers the system. The default is Uninitialized Contact. system-location string The location of the system. The default is Uninitialized Location. systeminformation string A brief description of what the system is used for or how it is configured.
Table 81 system properties (continued) Name Type Description fde-securitystatus string Shows whether the system is secured or unsecured: fde-securitystatus-numeric uint32 platform-type string Platform type. platform-typenumeric uint32 Numeric equivalent for the platform-type value. platform-brand string Platform brand. platform-brandnumeric uint32 Numeric equivalent for the platform-brand value. redundancy-mode Embedded; see redundancy.
system-parameters-table This basetype is used by show system-parameters. Table 82 system-parameters-table properties Name Type Description ulp-enabled string Shows true to indicate that the system is using Unified LUN Presentation, which can expose all LUNs through all host ports on both controllers. The interconnect information is managed in the controller firmware.
Table 82 system-parameters-table properties (continued) Name Type Description max-initiator uint32 Not applicable. max-volumegroups-per-pool uint32 Not applicable. max-volumesper-volumegroup uint32 Not applicable. maxreplicationsets uint32 Number of replication sets that the system supports. max-enclosures uint32 Number of enclosures that the system supports. localcontroller string Controller you are currently logged in to.
Table 82 system-parameters-table properties (continued) Name Type Description min-backingstore-size uint32 Minimum snap-pool size in blocks. max-fc-speed string Maximum FC host-port speed. max-fc-speednumeric uint32 Numeric equivalent for the max-fc-speed value. max-iscsi-speed string Maximum iSCSI host-port speed. max-iscsispeed-numeric uint32 Numeric equivalent for the max-iscsi-speed value.
tasks This basetype is used by show tasks and show task-details. Table 83 tasks properties Name Type Description name string Task name. type string Type of operation this task performs. • • • • • • status string Task status. • • • • • state string TakeSnapshot ResetSnapshot VolumeCopy ReplicateVolume EnableDSD DisableDSD Uninitialized: Task is not yet ready to run. Ready: Task is ready to run. Active: Task is running. Error: Task has an error. Invalid: Task is invalid.
Table 83 tasks properties (continued) Name Type Description • For • • • • • a ReplicateVolume task: Start VerifyVolume CreateName RepVolume VerifySnap • For an EnableDSD or DisableDSD task: • Start error-message string Message if an error occurred while processing the task, or blank. associatedvdisk-serial string For a VolumeCopy task, the serial number of the destination vdisk.
time-settings-table This basetype is used by show controller-date. Table 84 time-settings-table properties Name Type Description date-time string Date and time, in the format year-month-day hour:minutes:seconds (UTC), reported by the controller being accessed. date-timenumeric uint32 Unformatted date-time value. time-zoneoffset string The system's time zone as an offset in hours and minutes from UTC. This is shown only if NTP is enabled.
unhealthy-component This basetype is used by all commands that show component health. Table 85 unhealthy-component properties Name Type Description component-type string Component type.
Table 85 unhealthy-component properties (continued) Name Type Description component-typenumeric uint32 Numeric equivalents for component-type values. 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.
unwritable-cache This basetype is used by show unwritable-cache. Table 86 unwritable-cache properties Name Type Description unwritable-apercentage uint8 Total percentage of cache memory used for unwritable data in controller A. unwritable-bpercentage uint8 Total percentage of cache memory used for unwritable data in controller B.
users This basetype is used by show users. Table 87 users properties Name Type Description username string User name. roles string • • • • user-type string The user's level of technical expertise: Novice, Standard, Advanced, or Diagnostic. This parameter does not affect access to commands. The default is Standard. user-typenumeric string Numeric equivalents for user-type values. user-locale string Display language for this user. The default is English.
Table 87 users properties (continued) Name Type Description storage-sizeprecision uint8 The number of decimal places (1–10) for display of storage-space sizes. The default is 1. storage-sizeunits string The unit for display of storage-space sizes. • • • • auto: Lets the system determine the proper unit for a size. This is the default. MB: Megabytes. GB: Gigabytes. TB: Terabytes.
Table 87 users properties (continued) Name Type Description privacypassword string Encryption password for an SNMPv3 user whose privacy type is set to DES or AES. trapdestination string For an SNMPv3 user whose interface-access-SNMP property is set to snmptarget, this specifies the IP address of the host that will receive SNMP traps.
vdisk-hist-statistics This basetype is used by show vdisk-statistics when the historical parameter is specified. Table 88 vdisk-hist-statistics properties Name Type Description total-datatransferred string Total amount of data read and written since the last sampling time. total-datatransferrednumeric uint32 Unformatted total-data-transferred value. data-read string Amount of data read since the last sampling time. data-readnumeric uint32 Unformatted data-read value.
vdisk-statistics This basetype is used by show vdisk-statistics when the historical parameter is omitted. Table 89 vdisk-statistics properties Name Type Description name string Vdisk name. serial-number string Vdisk serial number. bytes-persecond string Data transfer rate 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.
versions This basetype is used by versions and show versions. Table 90 versions properties Name Type Description sc-cpu-type string Storage Controller processor type. bundle-version string Firmware bundle version. build-date string Firmware bundle build date. sc-fw string Storage Controller firmware version. sc-baselevel string Storage Controller firmware base level. sc-memory string Storage Controller memory-controller FPGA firmware version.
virtual-disk-summary This basetype is used by show vdisk-statistics when the historical parameter is specified. Table 91 virtual-disk-summary properties Name Type Description name string Vdisk name. serial-number string Vdisk serial number. vdisk-histstatistics Embedded; see vdisk-hist-statistics.
virtual-disks This basetype is used by show vdisks. Table 92 virtual-disks properties Name Type Description name string Vdisk name. size string Vdisk capacity, formatted to use the current base, precision, and units. size-numeric uint32 Unformatted size value in 512-byte blocks. freespace string Amount of free space in the vdisk, formatted to use the current base, precision, and units. freespacenumeric uint32 Unformatted freespace value in 512-byte blocks.
Table 92 virtual-disks properties (continued) Name Type Description chunksize string • • • status string Vdisk status. • • • • • • • • • • status-numeric uint32 For RAID levels except NRAID, RAID 1, and RAID 50, the configured chunk size for the vdisk. For NRAID and RAID 1, chunk size has no meaning and is therefore shown as not applicable (N/A). For RAID 50, the vdisk chunk size calculated as: configured-chunksize x (subvdisk-members - 1).
Table 92 virtual-disks properties (continued) Name Type Description cache-readahead string Not used. cache-readahead-numeric uint32 Not used. cache-flushperiod uint32 Not used. read-aheadenabled string Not used. read-aheadenabled-numeric uint32 Not used. write-backenabled string Not used. write-backenabled-numeric uint32 Not used. job-running string Same as current-job. current-job string Job running on the vdisk, if any.
Table 92 virtual-disks properties (continued) Name Type Description new-partitionlba string Maximum number of 512-byte blocks that could be allocated to a newly created volume. The value is formatted to use the current base, precision, and units. Expanding a volume in the same vdisk will reduce this amount. new-partitionlba-numeric uint32 Unformatted new-partition-lba value in 512-byte blocks. array-drivetype string Type of disks used in the vdisk.
Table 92 virtual-disks properties (continued) Name Type Description health-reason string If Health is not OK, the reason for the health state. healthrecommendation string If Health is not OK, the recommended actions to take to resolve the health issue. unhealthycomponent Embedded; see unhealthy-component.
volume-copy-status This basetype is used by show volumecopy-status. Table 93 volume-copy-status properties Name Type Description vc_volume_name string Destination volume name. serial-number string Destination volume serial number. virtual-diskname string Destination vdisk name. source-volume string Source volume name. progress string Percent complete of the volume copy (0%–99%).
volume-copy-tasks This basetype is used by show tasks and show task-details for a VolumeCopy task. Table 94 volume-copy-tasks properties Name Type Description source-volumename string Source volume name. source-volumeserial string Source volume serial number. destinationvdisk-name string Destination vdisk name. destinationpool-namenumeric string Not applicable. destinationvdisk-serial string Destination vdisk serial number. destinationpool-serialnumeric string Not applicable.
volume-names This basetype is used by show volume-names. Table 95 volume-names properties Name Type Description volume-name string Volume name. serial-number string Volume serial number.
volume-reservations This basetype is used by show volume-reservations. Table 96 volume-reservations properties Name Type Description volume-name string The name of the volume. serial-number string The serial number of the volume. reservationactive string • • reservationactive-numeric uint32 Numeric equivalents for reservation-active values. host-id string Host WWPN or iSCSI node name. port string The controller host-port identifiers. reserve-type string The reservation type.
volumes This basetype is used by show volumes. Table 97 volumes properties Name Type Description durable-id string Volume ID in the form 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 an MC restart. virtual-diskname string Vdisk name. storage-poolname string Not applicable. volume-name string Volume name.
Table 97 volumes properties (continued) Name Type Description cacheoptimization string • • cacheoptimizationnumeric uint32 read-ahead-size string Numeric equivalents for cache-optimization values. • • • • uint32 volume-type string 508 XML API basetype properties uint32 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.
Table 97 volumes properties (continued) Name Type Description volume-class string • • • standard: Standard volume, not enabled for snapshots. PTSNAP: Snapshot-related volume such as a master volume, snap pool, or snapshot. Proxy: Destination of an in-progress replication from a remote volume, which when complete will change to type snapshot. Numeric equivalents for volume-class values. volume-classnumeric uint32 profilepreference string Not applicable.
Table 97 volumes properties (continued) Name Type Description progress string For a volume-copy operation, the percent complete (0%–99%). The default value is 0%. progressnumeric uint32 Unformatted progress value. container-name string Vdisk name. containerserial string Vdisk serial number. allowedstorage-tiers string Not applicable. allowedstorage-tiersnumeric uint32 Not applicable. thresholdpercent-of-pool string Not applicable. reserved-sizein-pages uint32 Not applicable.
Table 97 volumes properties (continued) Name Type Description pi-formatnumeric string Not applicable. health string • • • • health-numeric uint32 Numeric equivalents for health values. • • • • OK Degraded Fault Unknown 0: 1: 2: 3: OK Degraded Fault Unknown health-reason string If Health is not OK, the reason for the health state. healthrecommendation string If Health is not OK, the recommended actions to take to resolve the health issue. volume-group string Not applicable.
volume-statistics This basetype is used by show volume-statistics. Table 98 volume-statistics properties Name Type Description volume-name string The name of the volume. serial-number string The serial number of the volume. bytes-persecond string The data transfer rate 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 98 volume-statistics properties (continued) Name Type Description reset-timenumeric uint32 Unformatted reset-time value. start-sampletime string The date and time, in the format year-month-day hour:minutes:seconds, when sampling started for the iops and bytes- per-second values. start-sampletime-numeric uint32 Unformatted start-sample-time value.
volume-view This basetype is used by show volume-maps. Table 99 volume-view properties Name Type Description durable-id string Volume ID in the form 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 an MC restart. volume-serial string Volume serial number. volume-name string Volume name. volume-viewmappings Embedded; see volume-view-mappings.
volume-view-mappings This basetype is used by show volume-maps. Table 100 volume-view-mappings properties Name Type Description durable-id string Volume ID in the form 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 an MC restart. parent-id string Not applicable. mapped-id string Not applicable. ports string • • Controller host ports that the mapping applies to.
XML API basetype properties
5 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
Typographic conventions Table 101 Document conventions Convention Element Blue text: Table 2 (page 6) Cross-reference links Blue, bold, underlined text Email addresses Blue, underlined text: http://www.hp.
6 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.
Documentation feedback
A Settings changed by restore defaults This appendix summarizes the system settings that result from using the restore defaults command.
Table 102 Settings changed by restore defaults (continued) Setting Value SMTP settings: • • • • • • • • Email notification Email notify filter Email addresses Email server Email domain Email sender Log destination Include logs • • • • • • • • Disabled (none) (none) (none) (none) (none) (none) Disabled SSL/SSH certificates (preserved)6 Licenses (preserved) Vdisk metadata (preserved) Host port settings: • • FC link speed FC topology • • Auto Point-to-point Host names and profiles (preserved
Glossary 2U12 A enclosure that is two rack units in height and can contain 12 disks. 2U24 A enclosure that is two rack units in height and can contain 24 disks. Additional Sense See ASC/ASCQ. Code/Additional Sense Code Qualifier Advanced Encryption Standard See AES. AES Advanced Encryption Standard. A specification for the encryption of data using a symmetric-key algorithm. Air Management Sled See AMS. ALUA Asymmetric Logical Unit Access. AMS For a 2U12 or 2U24 enclosure, Air Management Sled.
compatible disk A disk that can be used to replace a failed member disk of a vdisk because it both has enough capacity and is of the same type (SAS SSD, enterprise SAS, or midline SAS) as the disk that failed. See also available disk, dedicated spare, dynamic spare, and global spare. complex programmable logic device See CPLD. Configuration See CAPI. Application Programming Interface controller A (or B) A short way of referring to controller module A (or B).
DSD Drive spin down. A power-saving feature that monitors disk activity in the storage system and spins down inactive disks based on user-selectable policies. dual-port disk A disk that is connected to both controllers so it has two data paths, achieving fault tolerance. Dynamic Host See DHCP. Configuration Protocol dynamic spare An available compatible disk that is automatically assigned, if the dynamic spares option is enabled, to replace a failed disk in a vdisk with a fault-tolerant RAID level.
host An external port that the storage system is attached to. The external port may be a port in an I/O adapter in a server, or a port in a network switch. Product interfaces use the terms host and initiator interchangeably. host port A port on a controller module that interfaces to a host computer, either directly or through a network switch. host bus adapter See HBA. image ID A globally unique serial number that identifies the point-in-time image source for a volume.
masking A volume-mapping setting that specifies no access to that volume by hosts. See also default mapping and explicit mapping. master volume A volume that is enabled for snapshots and has an associated snap pool. MC Management Controller. A processor (located in a controller module) that is responsible for human-computer interface and computer-computer interfaces, including the WBI, CLI, and FTP interfaces, and interacts with the Storage Controller. See also EC and SC.
remote replication Asynchronous (batch) replication of block-level data from a volume in a primary system to a volume in one or more secondary systems by creating a replication snapshot of the primary volume and copying the snapshot data to the secondary systems via Fibre Channel or iSCSI links. The capability to perform remote replication is a licensed feature (Remote Snap). remote syslog support See syslog.
serial electrically erasable programmable ROM See SEEPROM. Service Location Protocol See SLP. SES SCSI Enclosure Services. The protocol that allows the initiator to communicate with the enclosure using SCSI commands. SFCB Small Footprint CIM Broker. SFF Small form factor. A type of disk drive. SHA Secure Hash Algorithm. A cryptographic hash function. SLP Service Location Protocol. Enables computers and other devices to find services in a local area network without prior configuration.
storage system A controller enclosure with at least one connected drive enclosure. Product documentation and interfaces use the terms storage system and system interchangeably. syslog Remote syslog support. A configuration that, when enabled, sends selected event messages to the syslog on a remote system. UCS Transformation Format - 8-bit See UTF-8. ULP Unified LUN Presentation. A RAID controller feature that enables a host to access mapped volumes through any controller host port.
Index A access level set user 65, 195 show user 325 activity progress interface enable/disable 176 ALUA 312 array See system auto-stall recovery enable/disable 138 show setting 203 B base 10 22 base 2 22 base for storage-space sizes set 64 set CLI 145 set user 194 show current 212 bytes versus characters 20, 22 C cache clear unwritable data 36 enable/disable auto-write-back 135, 141 set advanced settings 135 set auto-write-through triggers and behaviors 140 set host access to 136 show amount of unwritable
system configuration and utilities 25 volume copy 24 volume, host, and mapping 23 CompactFlash card health show 207 CompactFlash card status show 207 CompactFlash failure trigger enable/disable 136, 140 show setting 202, 205 configuration limits 312, 482 show system 214 controller notify partner when auto-write-through is triggered 137, 141 show failover status and reason 217 show ID being accessed (local) 312 show partner notification setting 203, 205 show shutdown status 301 shut down 346 controller failu
expander clear status and counters 40 enable/disable PHY fault isolation 155 show status 240 explicit mapping 104 F fail controller module 103 failover status and reason show controller 217 fan failure trigger enable/disable 136, 140 show setting 202, 205 fans show 242 FDE clear lock keys 41 secure or repurpose all disks in the system 160 set import key 158 set lock key 159 set system state 160 show system state 244 field-replaceable unit See FRUs firmware show versions 363 firmware update, monitoring prog
L LED set disk 168 set enclosure 168 leftover disk 37 license create temporary 63 licensed features show 260 link rate adjustment 224, 403 link speed set FC host port 165 set iSCSI 167 links verify host-port 358 verify within local system or between local and remote system 358 locale set CLI 145 set user 65, 195 show CLI 212 show user 325 lock key clear FDE 41 set FDE 159 log management enable/disable 136 send events to syslog on a remote system 190 show setting 203 LUNs set response to missing 136 show max
power supply failure trigger enable/disable 137, 140 show setting 202, 205 precision for storage-space sizes set CLI 146 set user 65, 195 show CLI 212 primary volume set 178 priorities set snap-pool retention 173 set snapshot retention 273 priority set utility 138 show utility 201 prompt, set CLI 174 protocols enable/disable 175 set host-port 166 show settings 274 provisioning show 276 Q quarantined vdisk 91 R redundancy mode changing to Single Controller 130, 138 show 279 show Single Controller setting 2
set automatic expansion size 185 set error threshold 187 set policy for critical threshold 185 set policy for error threshold 185 set warning threshold 187 show 302 snapshot delete modified (write) data 85 export replication to standard 102 replicate 114 snapshots create 59 delete 84 delete all 75 reset to current data in master volume 125 set retention priorities 273 show 304 SNMP enable/disable interface 175 set parameters 188 show parameters 307 show trap host address for SNMPv3 users 326 SNMPv3 authenti
users authentication type for SNMPv3 64, 194 create 64 delete 87 make session preferences permanent 196 password rules 21 privacy/encryption password for SNMPv3 65, 195 privacy/encryption type for SNMPv3 65, 195 set access level 65, 195 set base for storage-space sizes 64, 194 set locale 65, 195 set management-interface access 64, 195 set name 196 set password 65, 172, 195 set precision 65, 195 set role 65, 196 set temperature scale 66, 196 set timeout 66, 196 set type 66, 196 set units 66, 196 show 325 sho
show show show show show show show maximum number of 312 names and serial numbers 338 performance statistics 344 persistent reservations 339 provisioning 276 read-ahead cache size 208, 342 write policy 208, 341 W write-through triggers show settings 205 X XML API accessing via HTTP interface 15 basetype list 107 enable/disable brief mode 145 enable/disable output 145 examples 18 optimization 19 scripting guidelines 17 show data omitted by brief mode 107 using 16 538 Index
