HP MSA 2040 HP MSA 2040 CLI Reference Guide (723979-001, June 2013)
HP MSA 2040 Manual
View all HP MSA 2040 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP MSA 2040 manual content summary:
- HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 1
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). HP Part Number: 723979-001 Published: May 2013 Edition: 1 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 2
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. The only warranties for HP products and services are - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 3
19 Event log 20 2 Categorical list of commands 21 3 Alphabetical list of commands 27 abort replication 28 abort scrub 29 abort verify 30 abort volumecopy 31 add replication-volume 32 clear cache 34 clear disk-metadata 35 clear events 37 clear expander-status 38 convert master-to-std 39 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 4
controller-statistics 112 reset disk-error-statistics 113 reset disk-statistics 114 reset host-link 115 reset host-port-statistics 116 reset smis-configuration 117 reset snapshot 119 reset vdisk-statistics 120 reset volume-statistics 121 restart 122 restore defaults 124 resume replication - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 5
193 show cli-parameters 194 show configuration 196 show controller-date 197 show controllers 198 show controller-statistics 201 show debug-log-parameters 203 show disk-parameters 204 show disks 205 show disk-statistics 209 show email-parameters 213 show enclosures 215 show enclosure - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 6
systems 254 show replication-images 256 show replication-sets 259 show replication-volumes 262 show sas-link-health 265 show schedule-details 267 show schedules 268 show sensor-status 271 show shutdown-status 273 show snap-pools 274 show snapshots 276 show snmp-parameters 279 show syslog - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 7
412 replication-image-params 413 replication-set 414 replication-volume 415 replication-volume-summary 418 reset-snapshot-tasks 419 sas-status-controller-a 420 schedules 423 security-communications-protocols 424 sensors 426 show-other-mc-status 427 shutdown-status 428 snap-pools 429 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 8
volume-view 469 volume-view-mappings 470 5 Support and other resources 471 Contacting HP 471 Subscription service 471 Related information 471 Websites 471 Typographic conventions 472 6 Documentation feedback 473 A Settings changed by restore defaults 475 Glossary 477 Index 485 8 Contents - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 9
18 controller-statistics properties 355 19 debug-log-parameters properties 357 20 disk-hist-statistics properties 361 21 disk-statistics properties 363 22 drive-parameters properties 365 23 drive-summary properties 366 24 drives properties 367 25 email-parameters properties 372 26 enclosure - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 10
414 58 replication-volume properties 415 59 replication-volume-summary properties 418 60 reset-snapshot-tasks properties 419 61 sas-status-controller-a properties 420 62 schedules properties 423 63 security-communications-protocols properties 424 64 sensors properties 426 65 show-other-mc - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 11
is directly connected to a controller module's serial CLI port. For information about accessing the CLI and obtaining IP values for storage-system management, see your product's User Guide. Table 1 Default usernames and passwords Username Password Roles monitor manage !monitor Monitor (view only - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 12
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.55 login: monitor Password: product System Name: Test System Location - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 13
the XML API. The following example shows how to construct a Perl script to communicate with the XML API via HTTP. use LWP::UserAgent; use Digest::MD5 qw(md5_hex); use XML::LibXML; # generate MD5 hash using default username/password my $md5_data = "manage_!manage"; my $md5_hash = md5_hex( $md5_data - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 14
a sample command to obtain the disks in the system. $url = 'http://10.0.0.2/api/show/disks'; $req = HTTP::Request->new XML API The Management Controller provides access for monitoring and management via the output of each CLI command is composed of valid XML data until the CLI prompt (typically #) - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 15
element describes a storage-system component such as a disk or a volume. input, use CLI syntax as defined in this guide. For use with add new fields to the output. The output of show commands is intended for monitoring or obtaining the current configuration. Other commands provide configuration - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 16
value means that the command failed. XML API examples The following example shows the same command, formatted for use with the command-line interface or create vdisk level r5 disks 2.6,2.7,2.8 vd-1 • HTTP interface format: create/vdisk/level/r5/disks/2.6,2.7,2.8/vd-1 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 17
mode, which is disabled by default, returns a subset of attributes of show ports hostport_A1 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 18
with no spaces). Not all commands support lists. List example: vd1_v1,"Vol #1" Specifying ports Controller host ports are specified by controller ID and port number, and are not case sensitive. Controller IDs are A for the upper controller and B for the lower controller. Port IDs increment from 1 in - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 19
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. In the CLI, the base for entry and display of storage-space sizes can be set per user or per session - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 20
, Italian, Spanish Comma (,) 146,81 GB 3,0 Gb/s Event log A controller enclosure's event log records all events that have occurred in or been detected by the controller modules and encompasses all field-replaceable units (FRUs) in the storage system. Each event has one of the following levels, in - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 21
set password set prompt set user show cli-parameters show users scrub disks scrub vdisk set expander-fault-isolation set led set spares set vdisk show disks show vdisks trust verify vdisk show cache-parameters show host-maps show hosts show ports show unwritable-cache show volume-maps show volume - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 22
expand snap-pool reset snapshot rollback master-volume set priorities set snap-pool-policy set snap-pool-threshold show master-volumes show priorities show snap-pools show snapshots volumecopy set task show schedule-details show schedules show task-details show tasks show events show snmp-parameters - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 23
show controllers show disk-parameters show enclosures show enclosure-status show expander-status show fans show frus show host-parameters show inquiry show job-parameters show license show network-parameters show ntp-status show ports show power-supplies show protocols show redundancy-mode show sas - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 24
-view set replication-primary-volume set snap-pool policy set snap-pool-policy set snap-pool threshold set snap-pool-threshold set vdisk-spare set spares show channels show ports show drive-parameters show disk-parameters show enclosure-status show enclosures, show frus, show sensor - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 25
Table 7 Replaced or removed commands (continued) Old command New command show host-port-interconnects None show host-wwn-names show hosts show job-parameters show advanced-settings show lun-maps show volume-maps show output-format show cli-parameters show port-wwn show ports 25 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 26
26 Categorical list of commands - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 27
of the command's parameters Output Descriptions of fields shown in console format Example One or more examples of the command's usage in console format Basetypes References to descriptions of basetype properties shown in XML API format See also - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 28
set parameter. Example Abort replication of primary volume V1 to secondary volume rV1: # abort replication rV1 Success: Command completed successfully. (2012-01-20 14:52:27) See also • resume replication • suspend replication • show replication-sets • show replication-volumes 28 Alphabetical list - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 29
scrub vdisk vd1 Info: Scrub was aborted on vdisk vd1. (vd1) Success: Command completed successfully. (2012-01-20 15:42:08) See also • scrub vdisk • show vdisks abort scrub 29 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 30
verify was aborted on vdisk vd1. (vd1) (2012-01-20 15:40:31) Success: Command completed successfully. (2012-01-20 15:40:31) See also • show vdisks • verify vdisk 30 Alphabetical list of commands - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 31
creating destination volume vd1_copy: # abort volumecopy v1_copy Success: Command completed successfully. (vd1_copy) - The volume copy was aborted. (2012-01-21 12:04:20) See also • show volumecopy-status • show volumes • volumecopy abort volumecopy 31 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 32
is set to oldest. nowait Optional. Adding a volume to a replication set can take the Storage Controller several minutes to complete. This parameter allows that processing to continue in the background so the Management Controller can process other commands. primary-volume volume The name or serial - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 33
volume was added to the replication set. This may take a couple of minutes... (MV2) Info: The secondary volume was added to the replication set. (MV2) Success: Command completed successfully. (2012-01-21 17:37:40) See also • show replication-sets • show replication-volumes add replication-volume 33 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 34
will be lost and data will differ between the host and disk. Unwritable cache is also called orphan data. You can clear controller. 2. Run the clear cache command. 3. Run the show unwritable-cache command to view the percent of unwritable cache in each controller. If the value is not 0, repeat steps - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 35
from leftover disks only. If you specify disks that are not leftovers, the disks are not changed. Syntax clear disk-metadata disks Parameters disks IDs of the leftover disks to clear metadata from. For disk syntax, see "Command syntax" (page 18). Example Show disk usage: # show disks Location - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 36
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. (2012-01-18 10:32:59) 36 Alphabetical list of commands - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 37
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 38
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 39
Success: Command completed successfully. (MV1) - The conversion of a master volume to a standard volume completed. (2012-01-18 12:35:54) See also • delete all-snapshots • show master-volumes convert master-to-std 39 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 40
snapshots 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 41
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 is installed, and this CLI - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 42
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. (2012-10-04 09:31:58) See also • restart mc both • show certificate 42 Alphabetical list of - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 43
a mapping. This is the default. • openvms: The host does not allow LUN 0 to be assigned to a mapping. • hp-ux: The host allows LUN 0 to be assigned to a mapping and uses Flat Space Addressing. Example Create an entry named .(2012-01-18 15:53:20) See also • set host-name • show hosts create host 43 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 44
shown by the show cli-parameters command. pools of at least 50 GB to avoid this situation. lun LUN Optional. A default LUN to assign to the new master volume. If this parameter is omitted, no LUN is assigned. Use either this parameter or the prepare-replication-volume parameter. prepare-replication - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 45
-volume vdisk VD1 size 50GB prepare-replication-volume reserve 20GB MV2 Info: The volume was created. (spMV2) Info: The volume was created. (MV2) Success: Command completed successfully. (2012-01-18 12:32:04) See also • show master-volumes • show snap-pools • show vdisks create master-volume 45 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 46
remote-system username username password password system Parameters username username The name of a user in the remote system. This must be a manage-level user to remotely configure or provision that system. password password The password for that user. system The network-port IP address of the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 47
. 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 48
. nowait Optional. Adding a volume to a replication set can take the Storage Controller several minutes to complete. This parameter allows that processing to continue in the background so the Management Controller can process other commands. primary-address ip=address|iqn=IQN|wwn=WWN Optional - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 49
create replication-set link-type FC remote-volume Test-backup Test 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 49 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 50
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 10 then the interval should be set to 10 minutes. For a ReplicateVolume task, the default and minimum interval is 30 minutes. • [between hh:mm [AM|PM] and hh:mm - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 51
specified start time must be within the range specified with the 'between' parameter. (2012-01-20 15:46:08) See also • delete schedule • set schedule • show schedule-details • show schedules • show task-details • show tasks create schedule 51 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 52
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. The unit can be specified as follows: • byte blocks. The supported minimum size is 5 GiB or 5.37 GB. NOTE: In rare cases, a large amount of I/O can cause a snap pool that is too - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 53
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. Snapshot(s) were created. (2012-01-19 14:23:00) See also • show snapshots • show volumes create snapshots 53 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 54
a replication set's primary volume to a remote system; to reset a snapshot; or to enable or disable drive spin down. 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. The snap pool - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 55
controller as the source volume. • ReplicateVolume: Replicates a replication set's primary volume to a remote system. • EnableDSD: Enables spin down for all disks . snapshot-volume volume The name or serial number of the snapshot to reset. For volume syntax, see "Command syntax" (page 18). dest-vdisk - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 56
spin down for all disks: # create task type DisableDSD taskDSDsuspend Success: Command completed successfully. (taskDSDsuspend) - The task was created. (2012-01-19 15:47:15) See also • create schedule • delete task • set task • show task-details • show tasks • show volumes 56 Alphabetical list - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 57
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 limit. After a temporary license is created or a permanent license is installed, the command cannot be re-run. Syntax create temp-license Example - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 58
display of storage-space sizes: • 2: Sizes are shown as powers of 2, using 1024 as a divisor for each magnitude. • 10: Sizes are shown as powers of 10, using 1000 as a divisor for each magnitude. This is the default. Operating systems usually show volume size in base 2. Disk drives usually show size - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 59
places (1-10) for display of storage-space sizes. The default is 1. privacy-password encryption-password Optional. For an SNMPv3 user whose 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 60
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. For an SNMPv3 user whose interface parameter is set to snmptarget, this specifies the IP address of the host that will receive - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 61
SAS, or midline SAS. For each RAID level, the minimum and maximum numbers of disks supported are: • NRAID: 1 • RAID 0: 2-16 • RAID 1: 2 • RAID 3: 3-16 • RAID 5: 3-16 • RAID 6: 4-16 • RAID 10: 4-16 • RAID 50: 6-32 For best practices for creating vdisks, see the SMU Reference Guide. Syntax - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 62
-1 vdisk VD1 using two disks in the first enclosure: # create vdisk level raid1 disks 1.1,1.3 VD1 Success: Command completed disks: # create vdisk level r6 disks 2.3-4,2.8-9 vdR6 Success: Command completed successfully. (2012-01-20 12:58:43) See also • delete vdisks • set vdisk • show disks • show - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 63
unmap volume commands. By default, this command will not pool snap-pool] [reserve size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]] [snappable] [prepare-replication using the current base, as shown by the show cli-parameters command. The unit can be specified connected to the controller for this volume: read- - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 64
pool running out of space. Create snap pools of at least 50 GB to avoid this situation. snappable Optional. Specifies to create a master volume instead of a standard volume. prepare-replication 53:27) See also • delete volumes • set volume • show vdisks • show volumes 64 Alphabetical list of commands - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 65
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 supported per vdisk. size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] Sets the size for each volume using the current base, as shown by the show cli- - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 66
ports ports Optional. The controller ports through which hosts can access the volumes using 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 67
See also • create volume • delete volumes • map volume • set volume • show vdisks • show volume-maps • show volumes • unmap volume create volume-set 67 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 68
all master volumes associated with snap pool SP1: # delete all-master-volumes snap-pool SP1 Success: Command completed successfully. (SP1) - All master volumes were deleted. (2012-01-20 14:56:23) See also • delete all-snapshots • show master-volumes • show snap-pools 68 Alphabetical list of commands - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 69
all-snapshots volume MV2 delete-type all-replication-snapshots Info: This may take a few minutes if the system is under heavy load... Success: Command completed successfully. (MV2) - All snapshots were deleted. (2012-01-20 14:59:01) See also • show snapshots • show volumes delete all-snapshots 69 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 70
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. (2012-01-20 11:32:56) See also • delete vdisk-spare • set spares • show disks 70 Alphabetical list of commands - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 71
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. Example Delete the manually created host named MyHost: # delete host MyHost Success: Command completed successfully. (2012 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 72
: # delete master-volume MV1 Success: Command completed successfully. (MV1) - The master volume was deleted. (2012-01-21 12:13:00) See also • delete all-snapshots • show master-volumes 72 Alphabetical list of commands - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 73
-port IP address of the remote system. Example Delete remote system System2: # delete remote-system System2 Success: Command deleted successfully. (System2) - The remote system was deleted. (2012-01-21 12:24:18) See also • create remote-system • remote • set remote-system • show remote-systems - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 74
-21 12:16:58) Delete the replication set with primary volume MV1: # delete replication-set MV1 Info: The replication set has been deleted. (MV1) Success: Command completed successfully. (2012-01-21 12:17:31) See also • show replication-sets • show replication-volumes 74 Alphabetical list of commands - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 75
Delete schedule Sched1: # delete schedule Sched1 Success: Command completed successfully. (Sched1) - The schedule was deleted. (2012-01-21 17:05:15) See also • create schedule • show schedule-details • show schedules delete schedule 75 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 76
of the snap pool to delete. For volume syntax, see "Command syntax" (page 18). Example Delete snap pool SP1: # delete snap-pool SP1 Success: Command completed successfully. (SP1) - The snap-pool was deleted. (2012-01-18 12:13:46) See also • show master-volumes • show snap-pools 76 Alphabetical list - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 77
volume to a standard volume and delete the snap pool. delete-priority standard-snapshot|volume-copy-snapshot |replication-snapshot|replicating-snapshot|common-sync-point-snapshot |only-sync-point deleted. (2012-01-21 09:41:58) See also • delete snapshot-write-data • show snapshots delete snapshot 77 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 78
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 was deleted. (2012-01-21 09:54:58) See also • delete snapshot • show snapshots 78 Alphabetical list of commands - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 79
Task1: # delete task Task1 Success: Command completed successfully. (Task1) - The task was deleted. (2012-01-21 17:05:46) See also • create task • delete schedule • show schedule-details • show schedules • show task-details • show tasks delete task 79 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 80
Deletes a user account. You can delete any user that has been created and the default users monitor and ftp. Syntax delete user [noprompt] name Parameters noprompt Optional in console completed successfully. (2012-01-21 15:55:26) See also • create user • show users 80 Alphabetical list of commands - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 81
pool that is associated with a master volume on another vdisk. • If you delete a quarantined vdisk and its missing disks : Cancel the command. If this parameter is omitted, you must manually reply to the prompt. vdisks Names or serial numbers of the show master-volumes • show vdisks delete vdisks 81 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 82
" (page 18). 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.5) Success: Command completed successfully. (2011-10-12 11:11:29) See also • delete global-spare • set spares • show disks • show vdisks 82 Alphabetical list of - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 83
: Volume V2 was deleted. (V2) (2012-01-18 12:18:50) Success: Command completed successfully. (2012-01-18 12:18:50) See also • create volume • show volumes delete volumes 83 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 84
the CLI trust command. If a vdisk is manually dequarantined and does not have enough disks to continue operation, its status will change to OFFL and its data may or may not be recoverable through use of the trust command. Consult the online troubleshooting guide at http://www.hp.com/support/msa2040 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 85
pool used for snapshot, volume-copy, or replication disks are properly seated, that no disks have been inadvertently removed, and that no cables have been unplugged. Sometimes not all disks in the vdisk power up. Check that all enclosures have restarted after a power failure. If these problems - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 86
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 Success: Command completed successfully # show vdisks Name ... Status VD1 ... FTDN ... (RAID 6 fault tolerant with a down - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 87
. d. If the secondary volumes' snap pools are in other vdisks, stop those vdisks. e. Move the vdisks into the secondary system. This system must support the link type that the replication set is configured to use. For example, if the replication set's link type is configured to use FC links, the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 88
See also • reattach replication-volume • show replication-sets • show replication-volumes • start vdisk • stop vdisk 88 Alphabetical list of commands - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 89
Description Simulates vdisk degradation due to loss of a disk. This command only applies to disks that are part of fault-tolerant vdisks. CAUTION: For use by or with direction from technical support. When using this command, you should: 1. Run the show vdisks command to view all vdisks to determine - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 90
exit Description Log off and exit the CLI session. Syntax exit 90 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 91
[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] snap-pool To expand to the maximum size: expand snap-pool size max snap-pool Parameters size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] Specifies the size using the current base, as shown by the show cli-parameters command. The unit can be specified as - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 92
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 93
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 94
size max volume Parameters size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] Specifies the size using the current base, as shown by the show cli-parameters command. The unit can be specified as follows: • If base 2 is in use: B (bytes), KiB (kibibytes), MiB (mebibytes), or GiB (gibibytes) • If base 10 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 95
and changes to it will not affect the replication snapshot. The standard snapshot is subject to the snap pool's deletion policies. If the snap pool reaches its critical threshold, the snapshot may successfully. (2012-01-21 12:10:32) See also • show replication-sets • show snapshots export snapshot 95 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 96
module to crash for a non-maskable interrupt. For use by or with direction from technical support. 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 97
not mapped; otherwise, those settings become its default mapping, which specifies the controller host ports and access level that all connected hosts give a second host no access to the volume. NOTE: You cannot map a replication set's secondary volume. NOTE: When mapping a volume to a host using the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 98
host hosts Optional. For FC, the nickname or 16-hex-digit WWPN of each host to map the volumes to. For nickname syntax, see "Command syntax" (page 18). If the host parameter is specified, either the mapping parameter or both the lun and ports parameters must be specified. If the host parameter is - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 99
host hosts Optional. For FC, the nickname or 16-hex-digit WWPN of each host to map the volumes to. For nickname syntax, see "Command syntax" (page 18). If the host parameter is specified, either the mapping parameter or both the lun and ports parameters must be specified. If the host parameter is - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 100
# show volume-maps Volume View [Serial Number (SN) Name (v1) ] Mapping: Ports LUN Access Host-Port-Identifier all other hosts Standard Success: Command completed successfully. (2012-01-18 14:44:01) See also • show host-maps • show hosts • show volume-maps • show volumes • unmap volume 100 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 101
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 335). Example Show all metadata for objects returned by the show disks command: # meta drives See also • set cli-parameters meta 101 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 102
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 103
the replication set is configured to use, the secondary volume will be attached with the wrong link type. To fix this, repeat process steps 1 and 2 above to move the secondary volume into a system that supports the required link type. Syntax reattach replication-volume [remote-address ip=IPs|wwnn - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 104
See also • detach replication-volume • show replication-sets • show replication-volumes • start vdisk • stop vdisk 104 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 105
, 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 106
IP address of the remote system. command The full name of any CLI command that is valid for the remote user's access level. Example Run the show vdisks command on remote system System2: # remote System2 show vdisks Name Size Free Own Pref RAID Disks Spr Chk Status Jobs Job% Serial Number Drive - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 107
-volume Parameters nowait Optional. Removing a volume from a replication set can take the Storage Controller several minutes to complete. This parameter allows that processing to continue in the background so the Management Controller can process other commands. primary-volume volume Optional; use - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 108
. Example Replicate external snapshot Snap1 and name the resulting replication snapshot RepSnap1: # replicate snapshot name RepSnap1 Snap1 Info: The replication has started. (RepSnap1) Success: Command completed successfully. (2012-01-21 12:49:39) See also • show replication-sets • show snapshots - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 109
Example Replicate volume MV1 and name the replication snapshot RepSnap1: # replicate volume snapshot RepSnap1 MV1 Info: The replication has started. (RepSnap1) Success: Command completed successfully. (2012-01-20 10:53:25) See also • show replication-sets • show replication-volumes replicate volume - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 110
system power-up to display enclosures in the proper order. Whenever you replace a drive chassis or controller chassis, perform a manual rescan to force fresh discovery of all drive enclosures connected to the controller enclosure. A manual rescan is not needed after inserting or removing disks; the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 111
want to reset? (y/n) yes Success: Command completed successfully. (2012-01-21 11:34:50) See also • reset controller-statistics • reset disk-error-statistics • reset disk-statistics • reset host-port-statistics • reset vdisk-statistics • reset volume-statistics • show controller-statistics reset all - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 112
for both controllers: # reset controller-statistics Success: Command completed successfully. (2012-01-21 11:35:06) See also • reset all-statistics • reset disk-error-statistics • reset disk-statistics • reset host-port-statistics • reset vdisk-statistics • reset volume-statistics • show controller - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 113
Success: Command completed successfully. (2012-01-21 11:35:34) See also • reset all-statistics • reset controller-statistics • reset disk-statistics • reset host-port-statistics • reset vdisk-statistics • reset volume-statistics • show disk-statistics • show disks reset disk-error-statistics 113 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 114
for all disks: # reset disk-statistics Success: Command completed successfully. (2012-01-21 11:35:52) See also • reset all-statistics • reset controller-statistics • reset disk-error-statistics • reset host-port-statistics • reset vdisk-statistics • reset volume-statistics • show disk-statistics 114 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 115
, and is not case sensitive. Do not mix controller IDs in a range. Example Reset the host link on port A1: # reset host-link ports A1 Success: Command completed successfully. - Reset Host Link(s) on port(s) A1 from current controller. (2012-01-21 11:36:28) See also • show ports reset host-link 115 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 116
all controller host ports: # reset host-port-statistics Success: Command completed successfully. (2012-01-21 11:36:59) See also • reset all-statistics • reset controller-statistics • reset disk-error-statistics • reset disk-statistics • reset vdisk-statistics • reset volume-statistics • show host - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 117
:55:08) Success: Command completed successfully. (2013-01-10 16:55:08) Reset the SMI-S configuration on both Storage Controllers: # reset smis-configuration both WARNING: The configuration of the SMIS service will be reset to default settings. Any hosts registered via SMIS will need to be registered - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 118
See also • restore defaults 118 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 119
# reset snapshot SS1 You MUST unmount the snapshot from all hosts before resetting it. Ready to continue? (y/n) yes Success: Command completed successfully. - The reset of a snapshot completed. (SS1) - The reset of a snapshot completed. (2012-01-21 13:02:59) See also • show snapshots reset snapshot - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 120
reset vdisk-statistics VD1,MyVdisk Success: Command completed successfully. (2012-01-21 11:37:44) See also • reset all-statistics • reset controller-statistics • reset disk-error-statistics • reset disk-statistics • reset host-port-statistics • reset volume-statistics • show vdisk-statistics • show - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 121
Success: Command completed successfully. (2012-01-21 11:38:05) See also • reset all-statistics • reset controller-statistics • reset disk-error-statistics • reset disk-statistics • reset host-port-statistics • reset vdisk-statistics • show volume-statistics • show volumes reset volume-statistics 121 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 122
not be reset to zero, because disk statistics are summed between the two controllers. For more information, see help for commands that show statistics. Syntax restart sc|mc [a|b|both] [noprompt] Parameters sc|mc The controller to restart: • sc: Storage Controller • mc: Management Controller a|b|both - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 123
Restart both Storage Controllers: # restart sc both Restarting both controllers can cause a temporary loss of data availability. Do you want to continue? (y/n) yes Success: Command completed successfully. - Both SCs were restarted. (2012-01-21 13:09:52) See also • shutdown restart 123 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 124
. If this parameter is omitted, you must manually reply to the prompt. Example Restore the controllers' default configuration: # restore defaults WARNING: The configuration of the array controller will be re-set to default settings. The Management Controller will restart once this is completed. Do - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 125
unique across replication sets, specify the set parameter. Example Resume replication of primary volume V1 to secondary volume rV1: # resume replication rV1 Success: Command completed successfully. (2012-01-20 14:51:14) See also • abort replication • show replication-sets • show replication-volumes - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 126
hosts before starting a rollback operation. Ready to continue? yes Success: Command completed successfully. (MV) - Rollback was started. (2012-01-21 11:45:40) See also • show master-volumes • show snapshots 126 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 127
fix bad-block replacement errors, medium errors, hard errors, and SMART-count errors for the specified disks. You can use a disk while it is being scrubbed. To check the progress of a disk scrub (DRSC) job, use the show disks command. When a disk scrub operation starts, event 208 is logged. When - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 128
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 scrubbed. To check the progress of a vdisk scrub (VRSC) job, use the show vdisks command. When a vdisk scrub operation starts, event 206 is logged. When - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 129
rate] [fan-failure enabled|disabled|on|off] [host-cache-control enabled|disabled|on|off] [independent-cache enabled|disabled|on|off] [managed-logs enabled|disabled|on|off] [missing-lun-response notready|illegal] [partner-firmware-upgrade enabled|disabled|on|off] [partner-notify enabled|disabled|on - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 130
disk and is the same type. • disabled or off: The dynamic spares feature is disabled. This is the default. • enabled or on: The dynamic spares feature is enabled. emp-poll-rate rate Optional. Sets the interval at which the storage system will poll each enclosure's Enclosure Management Processor - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 131
trigger is disabled. This is the default. • enabled or on: The power-supply failure trigger is enabled. smart enabled|disabled|on|off|detect-only Optional. Enables or disables SMART (Self-Monitoring Analysis and Reporting Technology) monitoring for all disks in the storage system. • disabled or off - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 132
period of inactivity after which available disks and global spares will spin down. The default is 15 minutes. Setting the delay to 1-360 minutes will enable spin down; setting the delay to 0 will disable spin down. single-controller Optional; for use by a service technician only. For a system that - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 133
-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. power-supply-failure enabled|disabled|on|off Optional. Sets whether the cache - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 134
: Notification is disabled. This is the default. • enabled or on: Notification is controller-failure enabled partner-notify disabled Success: Command completed successfully. - Auto-write-through-trigger parameters were changed. (2012-01-21 11:50:05) See also • show auto-write-through-trigger • show - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 135
default. • write-through or wt: Write-through caching significantly impacts performance by waiting for data to be completely written to disk before signaling the host that the write is complete. Use this setting only when operating in an environment with low or no fault tolerance. You can configure - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 136
ahead is triggered by sequential accesses to consecutive logical block address (LBA) ranges. Read ahead can be forward (that current workload. This is the default. • stripe: Sets the read-ahead size to one stripe. The controllers treat non-RAID and RAID-1 show cache-parameters • show volumes 136 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 137
. This is the default. 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. console|api|api-embed Optional. Sets the output format: • console: Supports interactive use of the CLI by displaying command - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 138
login session. Valid values are 120-43200 seconds (2-720 minutes). The default is 1800 seconds (30 minutes). units auto|MB|GB|TB Optional. Sets the unit for display of storage # set cli-parameters api-embed pager off brief on Set CLI to show output in console format: # set cli-parameters console - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 139
dec day hh:mm:ss year To set the date and time manually by specifying a timestamp: set controller-date timestamp timestamp timezone +|-hh[:mm] To configure use of NTP: set controller-date ntp enabled|disabled|on|off ntpaddress IP-address timezone +|-hh[:mm] Parameters jan|feb|mar|apr|may|jun|jul|aug - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 140
controller-date sep 22 13:45:0 2011 Success: Command completed successfully. - Date/Time successfully set. (2011-11-02 13:45:03) Manually for the Mountain Time zone: # set controller-date ntp enabled ntpaddress 69.10.36.3 , India, time zone: # set controller-date ntp enabled ntpaddress 69.10.36 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 141
. • capi: Internal Configuration API debug messages. Enabled by default. • capi2: Internal Configuration API tracing debug messages. Disabled by default. • disk: Disk interface debug messages. Enabled by default. • dms: Snapshot feature debug messages. Enabled by default. • emp: Enclosure Management - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 142
or a controller restart. • The drive spin down feature monitors disk activity within system enclosures and spins down inactive disks, based on off: Drive spin down for available disks and global spares is disabled. This is the default. • enabled or on: Drive spin down for available disks and global - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 143
files to managed logs email notifications that are sent to the log collection system. This option is disabled by default. notification-level name is used as part of an email address, do not include spaces. For example: Storage-1. server server The IP address of the SMTP mail server to use for the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 144
com ([email protected]) Info: Set Email Address 2 to: [email protected] ([email protected]) Info: Set Email Address 3 to: Info: Set Email Address 4 to: [email protected] (logcollector@mydomain. completed successfully. (2012-01-21 15:07:46) See also • show email-parameters • test 144 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 145
enclosure's position in the rack, from 0-255. enclosure-number The enclosure ID. Example Set parameters for enclosure 1: # set enclosure 1 name Storage-5 location Lab rack-number 9 rack-position 3 Success: Command completed successfully. (2012-01-21 12:03:12) See also • show enclosures set enclosure - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 146
thresholds, the PHY is disabled to maintain storage system operation. While troubleshooting a storage system problem, a service technician can use this command to temporarily disable fault isolation for a specific Expander Controller in a specific enclosure. NOTE: If fault isolation is disabled, be - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 147
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 148
See also • set expander-fault-isolation • show enclosures • show expander-status 148 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 149
allows LUN 0 to be assigned to a mapping. This is the default. • openvms: The host does not allow LUN 0 to be assigned to a mapping. • hp-ux: The host allows LUN 0 to be assigned to a mapping and uses Flat Space Addressing. new-nickname Optional. Changes the host's nickname to the specified name - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 150
cannot specify the same value for ports on different controllers. • soft or 255: Soft target addressing enables the LIP to determine the loop ID. Use this setting if the loop ID is permitted to change after a LIP or power cycle. • 0-125: Specify a hard target address if you do not want the loop ID - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 151
this parameter is omitted, you must manually reply to the prompt. speed 4g to specify a mutually supported speed for more than two Storage Controller is rebooted. Success: Command completed successfully. - The host parameters were changed successfully. (2013-01-31 15:46:14) See also • restart • show - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 152
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 enable|disable|on|off Parameters disk ID The disk to locate. For disk syntax, see "Command syntax" (page 18). enclosure ID The enclosure to locate. enable - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 153
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.0 • Gateway IP address: 10.0.0.1 When DHCP is - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 154
. Enables the storage system to respond when a ping to a broadcast address is issued on the system's subnet. The default is Disabled. Manually set network port IP values for controller A (disabling DHCP for both controllers, if it was enabled) using IPv4 addressing: # set network-parameters ip - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 155
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 156
is omitted, this command affects the logged-in user's password. Example Change the password for the default user, manage: # set password manage Enter new password: **** Re-enter new password: **** Success: Command completed successfully. (manage) - The password was changed. (2011-10-11 14:48:03 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 157
for a snapshot that was taken for remote replication but is queued waiting for the previous replications to complete. The default is 0x2000 (8192). snap-pool The name or serial number of the snap pool. Example Set attribute priorities for snap pool SP1, raising the priority for standard snapshots - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 158
double quote, and can have a maximum of 16 bytes. A prompt that includes a space must be enclosed in double quotes. Example Change the prompt from "# " to "CLI$ " and start entering another command: # set prompt "CLI$ " Success: Command completed successfully. (2012-08-14 14:47:23) CLI$ show ... 158 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 159
the secure SMU web server. This is enabled by default. ses enabled|disabled|on|off Optional. Enables or disables the in-band SCSI Enclosure Management Services interface. This is enabled by default. smis enabled|disabled|on|off Optional. Enables or disables the secure Storage Management Initiative - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 160
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. Example - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 161
-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. system The name or network-port IP address of - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 162
Storage Controller several minutes to complete. This parameter allows that processing to continue in the background so the Management Controller can process other commands. primary-volume replication , view the status of replication set RS: # show replication-sets RS Replication Set [Name (RS) - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 163
's status and notice that the system is set to use the new primary volume and the conflict is resolved: # show replication-sets RS Replication Set [Name (RS) Serial Number () ] Primary Volume: Name ... Status ... Location Primary-Volume ... Primary-Volume-Status Data ... Online ... Local - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 164
See also • show replication-sets • show replication-volumes • show snapshots • unmap volume 164 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 165
priority low|medium|high] [remote-address ip=IPs|wwnn=WWNNs|wwpn=WWPNs] [set replication-set] replication-volume Parameters link-type FC retry. Maximum time in seconds to retry a single replication if an error occurs. Allowed values are 0-64000; the default is 1800 (30 minutes). A value of 0 means - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 166
remote address and error policy for replication volume MV2 in replication set RS1: # set replication-volume-parameters remote-address ip=10.1.66.55 on-error suspend set RS1 MV2 Success: Command completed successfully. (2012-01-21 16:10:04) See also • show replication-sets • show replication-volumes - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 167
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. If you schedule more - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 168
-12-31 00:01" task-name Snap Sched1 Success: Command completed successfully. (Sched1) - The schedule was modified. (2011-10-14 08:28:50) See also • show schedule-details • show schedules • show task-details • show tasks 168 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 169
preset to notifyonly. A snap pool's default error policy is autoexpand and default critical policy is deletesnapshots. by which the snap pool will be automatically expanded when the threshold level is reached. The value uses the current base, as shown by the show cli-parameters command. The unit - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 170
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. (2012-01-21 12:32:28) See also • set priorities • set snap-pool-threshold • show snap-pools 170 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 171
syntax, see "Command syntax" (page 18). Example Set the warning and error thresholds for snap pool SP1: # set snap-pool-threshold warning 60% error 85% SP1 Success: Command completed successfully. (2012-01-21 12:33:46) See also • set snap-pool-policy • show snap-pools set snap-pool-threshold 171 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 172
[add-trap-host address] [del-trap-host address] add-trap-host address Optional. Specifies the IP address of a destination host that will receive traps. Three trap hosts can be set. del-trap-host address snmp-parameters enable crit add-trap-host 172.22.4. - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 173
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 to be spares. For information about sparing rules for heterogeneous vdisks, see the "About spares" topic in SMU documentation. CAUTION: When - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 174
Sets remote syslog notification parameters for events and managed logs. This allows events to be logged in the syslog of a specified host computer. Syntax set syslog-parameters notification-level crit|error|warn|info|none [host-ip IP-address] [host-port port-number] Parameters notification-level - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 175
event notifications. All four values are included in system debug logs for reference by service personnel. When using the WBI, the system name appears in the A brief description of what the system is used for or how it is configured. Example Set the system name to Test and the contact to J. Doe: # - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 176
If you reduce the retention count for a task, excess snapshots will be removed the next time the task runs. For a ReplicateVolume task, the number of replication images created by this task to retain, from 2 to 32. When a new image exceeds this limit, the oldest image with the same prefix is deleted - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 177
snapshot-prefix VD1v2 replication-mode last-snapshot Replicate Success: Command completed successfully. (Replicate) - The task was modified.(2012-01-21 12:37:57) See also • create task • delete task • set schedule • show schedule-details • show schedules • show task-details • show tasks set task - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 178
display of storage-space sizes: • 2: Sizes are shown as powers of 2, using 1024 as a divisor for each magnitude. • 10: Sizes are shown as powers of 10, using 1000 as a divisor for each magnitude. This is the default. Operating systems usually show volume size in base 2. Disk drives usually show size - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 179
defaults are cli and wbi. • cli: Command-line interface. • wbi: Web-browser interface (SMU). • ftp: File transfer protocol interface. • smis: Storage Management places (1-10) for display of storage-space sizes. The default is 1. privacy-password encryption-password Optional. For an SNMPv3 user whose - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 180
settings. This is the default. • manage: User can view and login session. Valid values are 120-43200 seconds (2-720 minutes). The default is 1800 seconds (30 minutes). trap-host IP-address Optional. For an SNMPv3 user whose interface parameter is set to snmptarget, this specifies the IP address - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 181
. (2012-01-21 14:39:56) Change the authentication type for SNMPv3 user Traps: # set user Traps authentication-type MD5 password snmptraps Success: Command completed successfully. - The settings were changed successfully. (2012-01-12 14:40:10) See also • set password • show users set user 181 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 182
. For vdisk syntax, see "Command syntax" (page 18). Example Rename vdisk VD1, change its owner to controller A, and set its spin-down delay to 10 minutes: # set vdisk name VD2 owner a spin-down-delay 10 VD1 Success: Command completed successfully. (2012-01-21 12:29:15) See also • show vdisks 182 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 183
volume identifying-information "Project X data" V3 Success: Command completed successfully. - The specified volume name change(s) were made. (2012-01-21 14:36:33) See also • show host-maps • show volumes • show volume-maps set volume 183 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 184
spares feature is enabled. Enclosure Polling Rate Shows the interval in seconds at which the storage system will poll each enclosure's Enclosure Management Processor (EMP) for status changes, from 5-3600 seconds. The default is 5 seconds. Host Control of Caching Shows whether hosts are allowed to - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 185
after all write-back data for the specified volume is flushed to disk. Independent Cache Performance Mode Not supported. Disabled by default. Missing LUN Response Shows whether host drivers may probe for LUNs until the host drivers reach the LUN to which they have access. • Not Ready: Sends a reply - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 186
again is 72 hours. • Disabled: Background disk scrub is disabled. This is the default. • Enabled: Background disk scrub is enabled. Managed Logs Shows whether the managed logs feature is enabled, which allows log files to be transferred from the storage system to a log collection system to avoid - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 187
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 188
-On Self-Test), fails during POST, or fails during controller operation. • Disabled: The CompactFlash failure trigger is disabled. • Enabled: The CompactFlash failure trigger is enabled. This is the default. Power Supply Failure Shows whether the cache policy will change from write-back to write - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 189
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 190
problem is corrected, the cache policy reverts to the value configured for each individual volume. • Enabled: Write-back. This is the normal state. • Disabled: Write-through. • Not up: The controller is not up. CompactFlash Status • Not Installed: The CompactFlash card is not installed. • Installed - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 191
disk default. • write-through: Write-through caching significantly impacts performance by waiting for data to be completely written to disk default. • no-mirror: When this mode is enabled, each controller stops mirroring its cache metadata to the partner controller the controller The controllers treat - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 192
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 193
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 194
display of storage-space sizes: • 2: Sizes are shown as powers of 2, using 1024 as a divisor for each magnitude. • 10: Sizes are shown as powers of 10, using 1000 as a divisor for each magnitude. This is the default. Operating systems usually show volume size in base 2. Disk drives usually show size - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 195
: 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 196
from show system • Controller information from show controllers • Controller firmware and hardware version information from versions with the details option • Host and expansion port information from show ports • Disk information from show disks • Disk information by enclosure from show disks with - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 197
in hours and minutes from Coordinated Universal Time (UTC). This is shown only if NTP is enabled. Example Show the date and time on a system that is using NTP: # show controller-date Controller Date: 2012-01-18 14:57:04 Time-Zone Offset: -6:00 Success: Command completed successfully. (2012-01-18 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 198
firmware version. MAC Address Controller network port MAC address. WWNN Storage system World Wide Node Name (WWNN). IP Address Controller network port IP address. IP Subnet Mask Controller network port IP subnet mask. IP Gateway Controller network port gateway IP address. Disks Number of disks - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 199
take to resolve the health issue. Position Position of the controller in the enclosure: • Top: The controller is in the top slot. • Bottom: The controller is in the bottom slot. Phy Isolation Shows whether the automatic disabling of SAS expander PHYs having high error counts is enabled or disabled - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 200
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.1 Disks: 17 Vdisks: 6 Cache Memory Size - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 201
reset, either by a user or by a controller restart. Total Power On Hours The total amount of hours the controller has been powered on in its life time. Example Show statistics for controller A: # show controller-statistics a Durable ID CPU Load Power On Time (Secs) Bytes per second IOPS Number - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 202
Basetypes • controller-statistics • status See also • reset all-statistics • reset controller-statistics • show disk-statistics • show host-port-statistics • show vdisk-statistics • show volume-statistics 202 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 203
messages. Enabled by default. • emp: Enclosure Management Processor debug messages. Enabled by default. • capi: Internal Configuration API debug messages. Enabled by default. • mui: Internal service interface debug messages. Enabled by default. • bkcfg: Internal configuration debug messages. Enabled - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 204
global spares will spin down, from 1-360 minutes. The value 0 means spin down is disabled. The default is 15 minutes. Example Show disk settings: # show disk-parameters Disk Parameters SMART: Enabled Drive Write Back Cache: Disabled Timeout Retry Maximum: 3 Attempt Timeout: 8 Overall Timeout: 105 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 205
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 206
support a 6-Gbit/s transfer rate. If this happens, the controller automatically adjusts transfers to those disks to 3 Gbit/s, increasing reliability and reducing error messages with little impact on system performance. This rate adjustment persists until the controller is restarted or power - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 207
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. For disk and midplane types where this processor also controls power to the disk, power-on failure will result in Error status - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 208
SN vendor A360 VDISK SAS 10 600.1GB 6.0 N/A N/A N/A 12313 5379.3MB 1447 OK Info: * Rates may vary. This is normal behavior. (2013-02-13 16:38:46) Success: Command completed successfully. (2013-02-13 16:38:46) Basetypes • drives • enclosure-list • status See also • show vdisks 208 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 209
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. show disk-statistics - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 210
reset, either by a user or by a controller restart. Output Durable ID (Historical) Disk ID in the form disk_enclosure-number.disk-number. Serial Number Disk last sampling time. Total IOPS Total number of read and write operations per second since the last sampling time. Read IOPS Shown by the all - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 211
number of pending read and write operations being serviced since the last sampling time. This value represents Show live statistics for disks 1.1 and 2.1: # show disk-statistics 1.1,2.1 Durable ID Serial Number Bytes per second IOPS Number of Reads Number of Writes Data Read Data Written Reset - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 212
02-13 14:00:54) Basetypes • disk-statistics (live) • drive-summary (historical) • status See also • reset all-statistics • reset disk-error-statistics • reset disk-statistics • show controller-statistics • show disks • show host-port-statistics • show vdisk-statistics • show volume-statistics 212 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 213
the default. This parameter does not apply to managed-logs notifications. Email Address (1-3) Shows up to three email addresses for recipients of event notifications. Log Destination Shows the email address for the log collection system used by the managed logs feature. Email Server The IP address - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 214
See also • set email-parameters 214 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 215
# BUS:ID Rev Channel ID and firmware revision of the Enclosure Management Processor in each controller's Expander Controller Midplane Type • 2U24-6Gv2: Midplane for 2U, reduced-depth, 24-disk enclosure with 6-Gbit/s maximum data rate to disks (HP MSA 2040 SFF chassis) • 2U24-6G: Midplane for 2U, 24 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 216
Controller Lab 0 4 vendor model 01:031 1115 00:031 1115 2U24-3G OK Success: Command completed successfully. (2012-01-18 15:01:05) Basetypes • enclosures • status See also • set enclosure • show sensor-status show enclosure-status Deprecated; use show enclosures, show frus, or show sensor - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 217
the HP MSA 2040 SW Support and Documentation DVD shipped with your product or at http://www.hp.com/support/msa2040/Manuals. For links to additional information about your product, see http://www.hp.com/support/msa2040. For product support and to download drivers and software, see http://www.hp.com - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 218
to-event parameter. • error: Shows Warning, Error, and Critical events. Output • Date and time when the event was logged • Event code identifying the type of event to help diagnose problems; for example, [181] • Event ID prefixed by A or B, indicating which controller logged the event; for example - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 219
See also • clear events • set snmp-parameters • show snmp-parameters show events 219 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 220
module or expansion module is not installed, this field shows "--". Type • Drive: 1-lane PHY that communicates between the expander and a disk drive. • Egress: 4-lane PHY that communicates between the expander and an expansion port or SAS Out port. • SC-1: (Controller module only) 2-lane PHY that - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 221
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. • Drive removed: PHY disabled because - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 222
Basetypes • sas-status-controller-a • status See also • clear expander-status • set expander-fault-isolation • set expander-phy 222 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 223
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 224
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 225
ID of the manufacturer FRU Location Location of the FRU in the enclosure: • MID-PLANE SLOT: Chassis midplane • UPPER IOM SLOT: Controller module or expansion module A • LOWER IOM SLOT: Controller module or expansion module B • LEFT PSU SLOT: Power supply module on the left, as viewed from the back - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 226
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 227
Revision: value Dash Level: value FRU Shortname: Midplane/Chassis Manufacturing Date: value Manufacturing Location: value Manufacturing Vendor ID: value FRU Location: MID-PLANE SLOT Configuration SN: value FRU Status: value Enclosure ID: value ... FRU --Name: POWER_SUPPLY Description: value Part - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 228
mapped to all hosts or to a specified host. Syntax show host-maps [host] Parameters host Optional. Specifies the host's allow LUN 0 to be assigned to a mapping. • HP-UX: The host allows LUN 0 to be assigned to a mapping and uses Flat Space Addressing. Name Name of the volume seen by the host. Serial - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 229
hosts: # show host-maps Host View [ID (AABBCCDDEEFF0011) Name (Host1) Profile (OpenVMS) ] Mapping: Name Serial Number LUN Access Ports vd2_v2 SN 1 read-write A1,A2,B1,B2 vd2_v0 SN 10 read-write A1,B1 vd2_v1 SN no-access Host View [ID (1A2B3C4D5E6F8900) Name (Host2) Profile (HP-UX - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 230
of the port's PHYs are up. • Not Present: The controller module is not installed or is down. • Disconnected: Either no I/O link is detected or the port is not cabled. Speed (A) Actual link speed in Gbit/s. Blank if not applicable. Speed (C) Configured host-port link speed. • FC: Auto, 16Gb, 8Gb, or - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 231
. - Otherwise, use an appropriate interface cable to connect this host port to a switch or host. - If a cable is connected, check the cable and the switch or host for problems. Topo(C) ------PTP ... Success: Command completed successfully. (2013-02-03 17:01:03) show host-parameters 231 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 232
port information for a system with FC ports: # show host-parameters detail Ports Media Target ID Status Speed(A) Speed(C) Health Health Reason Health Recommendation ID FC(P) WWPN Up 8Gb Auto OK Topo(C) PID SFP Status Part Number Supported Speeds PTP N/A OK value 4G,8G,16G - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 233
requested or reset. This value will be zero if it has not been requested or reset since a controller restart. IOPS Input/output reset. Reset Time Date and time, in the format year-month-day hour:minutes:seconds, when these statistics were last reset, either by a user or by a controller restart. show - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 234
completed successfully. (2013-02-13 16:25:41) Basetypes • host-port-statistics • status See also • reset all-statistics • reset host-port-statistics • show controller-statistics • show disk-statistics • show vdisk-statistics • show volume-statistics • show host-port-statistics • show ports 234 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 235
a mapping. • HP-UX: The host allows LUN 0 to be assigned to a mapping and uses Flat Space Addressing. Host Type • If the host was discovered and its entry was automatically created, its host-interface type: FC. • If the host entry was manually created: Undefined. Example Show hosts: # show hosts - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 236
• Management Controller firmware version and loader version • Storage Controller firmware version and loader version • Controller module serial number • Media Access Control (MAC) address • Network port IP address Example Show inquiry data for a system in which controller B is not installed: # show - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 237
• Never. Always enabled and doesn't expire. VSS Shows whether the VSS (Volume Shadow Copy Service) Hardware Provider is enabled or disabled. VSS Expires • Never. Always enabled and doesn't expire. SRA Shows whether Storage Replication Adapter (SRA) support is enabled or disabled. SRA Expires • Never - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 238
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 239
, 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 240
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% - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 241
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 242
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 243
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 NTP server IP address, or 0.0.0.0 if not set Last Server Contact Date and time in the format year-month-day hour - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 244
of the port's PHYs are up. • Not Present: The controller module is not installed or is down. • Disconnected: Either no I/O link is detected or the port is not cabled. Speed (A) Actual link speed in Gbit/s. Blank if not applicable. Speed (C) Configured host-port link speed. • FC: Auto, 16Gb, 8Gb, or - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 245
is required. - Otherwise, use an appropriate interface cable to connect this host port to a switch or host. - If a cable is connected, check the cable and the switch or host for problems. Topo(C) ------PTP ... Success: Command completed successfully. (2013-02-03 17:01:03) show ports 245 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 246
detailed port information for a system with FC ports: # show ports detail Ports Media Target ID Status Speed(A) Speed(C) Health Health Reason Health Recommendation ID FC(P) WWPN Up 8Gb Auto OK Topo(C) PID SFP Status Part Number Supported Speeds PTP N/A OK value 4G,8G,16G - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 247
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 • - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 248
disaster recovery management (DRM). Priority Retention priority for the corresponding attribute. Example Show priorities for snap-pool SP1: # show priorities SP1 Attribute Name Priority Standard Snapshot 0x6000 (default) Volume Copy Snapshot 0xa000 (default) Replication Snapshot 0x4000 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 249
, through incoming ports only, by HP or HP's authorized representatives for troubleshooting. Disabling the service debug protocol removes this access. In-band SES Management (SES) Shows whether the in-band SES interface is enabled or disabled. The default is Enabled. Activity Progress Reporting - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 250
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 251
is down or not installed. Other MC Status The operational status of the Management Controller in the partner controller. This is not factored into system health. • Operational • Not Operational • Not Communicating • Unknown Example From either controller, show the redundancy status of a dual - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 252
of a single-controller system: # show redundancy-mode System Redundancy Controller Redundancy Mode: Single Controller Controller Redundancy Status: Operational but not redundant Controller A Status: Operational Controller A Serial Number: SN Controller B Status: Not installed Controller B Serial - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 253
refresh-counters Description In XML API format only, shows when the data represented by the basetype was last updated. The you called this command then the data has changed. Syntax show refresh-counters Basetypes • refresh-counters • status See also • set cli-parameters show refresh-counters 253 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 254
The brand name of the remote system. IP Address Controller A The IP address of the network port in controller A in the remote system. IP Address Controller B The IP address of the network port in controller B in the remote system. Username The name of a Manage-level user in the remote system. Status - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 255
.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. (2012-01-18 15:14:23) Basetypes • remote-system • status See also • create remote-system • delete remote-system • remote • set remote-system show - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 256
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 257
expected to complete. Time [HH:MM:SS] Total time of replication (in hours, minutes, and seconds) including any suspension time. Example Show information about replication images for replication set rsvol1: # show replication-images rsvol1 Name Serial Number Type vd01_v001 SN Primary Volume - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 258
See also • show replication-sets • show replication-volumes 258 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 259
. 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 260
policy used to determine the next image to replicate when multiple replication images are queued: Newest or Oldest. Monitor Interval 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 261
Address N/A FCPortWWN=207000c0ff000bee N/A FCPortWWN=217000c0ff000bee N/A FCPortWWN=247000c0ff000bee N/A FCPortWWN=257000c0ff000bee Success: Command completed successfully. (2012-01-18 15:15:03) Basetypes • replication-set • status See also • show replication-images • show replication - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 262
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 263
primary volume should query the secondary volume. The default is 300. Priority Priority of the replication process on the replication volume: • High: Replication has higher priority than host I/O. This can and time of the last communication with the remote volume, or N/A. show replication-volumes 263 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 264
Remote Address N/A IP=10.134.9.40:3260 N/A IP=10.134.9.41:3260 N/A IP=10.134.9.42:3260 N/A IP=10.134.9.43:3260 Success: Command completed successfully. (2012-01-18 15:16:46) Basetypes • replication-volume • status See also • set replication-volume-parameters • show replication-sets - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 265
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 266
-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 Disconnected N/A No drive enclosure - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 267
information about a specified task schedule. Syntax show schedule-details schedule Parameters schedule Schedule name. Example Show information about task schedule SnapSched: # show schedule-details SnapSched Schedule Details Schedule Name: SnapSched Schedule Specification: Start 2011-10-19 23:47 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 268
information about all task schedules. Syntax show schedules Output Schedule Name The schedule name. Schedule Specification The schedule settings for running the associated running the schedule, the error message; otherwise, blank. Task-specific information, as shown by the show tasks command. 268 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 269
information about all task schedules: # show schedules Schedule Details Schedule Name: SnapSched Schedule Specification: Start 2011-10-19 23:47:00, Every Task Details -----------Primary Volume Name: bTx_v002 Primary Volume Serial Number: SN Prefix: bTx_v002_01 Mode: new-snapshot show schedules 269 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 270
bTx_v002_01_R0028 SN bTx_v002_01_R0029 SN bTx_v002_01_R0030 SN Success: Command completed successfully. (2011-10-10 15:20:05) Basetypes • schedules • status See also • create schedule • delete schedule • show schedule-details • show tasks 270 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 271
during controller startup. • Unrecoverable: The enclosure management processor (EMP) cannot communicate with the sensor. • Unknown: The sensor is present but status is not available. • Not Installed: The sensor is not present. • Unsupported: Status detection is not implemented. Example Show sensor - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 272
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 273
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 274
show snap-pools Description Shows information about snap pools owned by a specified controller or both controllers. Syntax show snap-pools [controller a|b|both] Parameters controller a|b|both Optional. Shows snap pools owned by controller A only, by controller B only, or by either controller (both). - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 275
when the threshold is reached. • N/A: The policy is not set to autoexpand. Example Show information for snap pools owned by controller A: # show snap-pools controller a Vdisk Serial Number Name Size Free (size) Master Volumes Snapshots Status vd1 SN SP1 50.9GB 99 % (50.9GB) 1 2 Available - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 276
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). If this parameter - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 277
Status • Available • Unavailable: See the Status-Reason value. Status-Reason Shows N/A for Available status, or one of the following reasons for Unavailable Name of the volume of which the snapshot was taken Snap-pool Name Snap pool name Snap Data Total amount of preserved and write data associated - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 278
): For a primary volume, a snapshot that is waiting to be replicated to a secondary system. 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 279
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- shown in clear text to manage-level and admin-level users. Example Show SNMP notification settings: # show snmp-parameters SNMP Trap Notification Level - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 280
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 281
Count The number of enclosures in the storage system. Health • OK • Degraded • Fault • Unknown Health Reason If Health is not OK, this field shows the reason for the health state. Other MC Status The operational status of the Management Controller in the partner controller. This is not factored - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 282
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 283
type and size. Health Recommendation: - Replace the failed disk. - Configure the new disk as a spare so the system can start reconstructing the vdisk. - To prevent this problem in the future, configure one or more additional disks as spare disks. Success: Command completed successfully. (2012-01-19 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 284
equal. Host Profiles Enabled Shows whether host profiles are enabled, which determines whether LUN 0 can be assigned to volume mappings. Number of Host Ports Number of host-interface ports in the controller enclosure Maximum Disks Number of disks that the system supports Maximum Volumes Number of - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 285
See also • set volume • set vdisk show system-parameters 285 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 286
information about a specified task. Syntax show task-details task Parameters task Task name. Output For a running • Error: Task has an error • Invalid: Task is invalid Task State Current step of the task: • Start • VerifyVolume • ValidateLicensingLimit • CreateName • CreateSnap • VerifySnap • - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 287
Task is invalid Task State Current step of the task: • Start • reset For a VolumeCopy task: Task Name Task name Task Type VolumeCopy 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 show - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 288
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 289
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 290
: 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 291
tasks. Syntax show tasks Output For a TakeSnapshot task: Task Name Task name Task Type TakeSnapshot 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 292
of the snapshot to reset For a VolumeCopy task: Task Name Task name Task Type VolumeCopy 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 293
• Error: Task has an error • Invalid: Task is invalid Task State Current step of the task: • Start • VerifyVolume • CreateName • RepVolume • VerifySnap Error Name of the volume to replicate Primary Volume Serial Number Serial number of the volume to replicate Prefix Label that identifies snapshots - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 294
Snapshot For a task whose replication mode is last-snapshot, the name of the last snapshot used for replication; otherwise, N/A For an • 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 295
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 296
Task Name: Replicate Task Type: ReplicateVolume Status: Ready Task State: Start Error Message: Task Details -----------Primary Volume 28:52) Basetypes • tasks • status See also • create schedule • create task • delete task • set task • show schedule-details • show schedules • show task-details 296 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 297
data is not needed it can be cleared, in which case it will be lost and data will differ between the host and disk. Syntax show unwritable-cache Example Show the percentage of unwritable cache data in each controller: # show unwritable-cache Unwritable System Cache Percent of unwritable cache in - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 298
User name to show settings for. Output Username User name. Roles • monitor: User can view but not change system settings. • manage: User can default is English. WBI • x: The user can access the web-browser interface (SMU). This is the default. • (blank): The user cannot access this interface. CLI - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 299
user that can receive trap notifications. Example Show configured users: # show users Username Roles User Type User Locale WBI CLI FTP SMI-S SNMP Authentication Type Privacy Type Password Privacy Password Trap Host Address ftp manage,monitor Standard English x ******** MIB monitor - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 300
preferred owner is offline Pref Controller that owns the vdisk and its volumes during normal operation RAID Vdisk RAID level Disks Number of disks in the vdisk Spr Number of spares assigned to the vdisk Chk • For RAID levels except NRAID, RAID 1, and RAID 50, the configured chunk size for the vdisk - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 301
for the vdisk and its disks are fully spun down to conserve power. Spin Down Delay The period of inactivity after which the vdisk's disks and dedicated spares automatically spin down, from 1-360 minutes. Data Transferred If the perf parameter is specified, this field shows the total amount of data - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 302
Recommendation If Health is not OK, this field shows recommended actions to take to resolve the health issue. Example Show information for all vdisks: # show vdisks Name Size Free Own Pref RAID Disks Spr Chk Status Jobs Job% Serial Number Drive Spin Down Spin Down Delay Health Health Reason - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 303
by accounting for when data is written from cache to disk or is read from disk to cache. Historical data is obtained by using the summation of the disk statistics for the disks in the vdisk. The historical vdisk data shows transfers to and from the disks in the vdisk that include the overhead of any - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 304
-range parameter. all Optional. Specifies to show the full set of performance metrics. If this parameter is omitted, the default set of performance metrics will be shown. requested or reset. This value will be zero if it has not been requested or reset since a controller restart. IOPS Input/output - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 305
live statistics for vdisks VD1 and MyVdisk: # show vdisk-statistics VD1,MyVdisk Name Serial Number Bytes per second IOPS Number of Reads Number of Writes Data Read Data Written I/O Resp Time Read Resp Time Write Resp Time Reset Time VD1 SN 22.0MB 82 6179839 10507038 478.8GB 1024.4GB - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 306
:35:06) Basetypes • vdisk-statistics (live) • virtual-disk-summary (historical) • status See also • reset all-statistics • reset vdisk-statistics • show controller-statistics • show disk-statistics • show host-port-statistics • show vdisks • show volume-statistics show versions See versions. 306 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 307
from the point where it stopped. Status-Reason More information about the Status value. Example Show information about volume copies in progress for controller A: # show volumecopy-status controller a VC Volume Name Serial Number Vdisk Source Volume Progress Status Status-Reason MV1-copy - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 308
Port-Identifier • FC: Host WWPN • all other hosts for the volume's default mapping Nickname Host nickname, or blank if not set or for all other mapping. • HP-UX: The host allows LUN 0 to be assigned to a mapping and uses Flat Space Addressing. Example Show all volume mappings: # show volume-maps - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 309
See also • show host-maps • show hosts • show volumes show volume-maps 309 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 310
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 18). If this parameter is omitted, information is shown for all volumes. Output Name The name of - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 311
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 Syntax show volume- - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 312
reservations for all volumes: # show volume-reservations all Name Serial Number Volume Reserved Host ID Port Reservation Type vd04_v001 SN Free Undefined A3 Exclusive Access Success: Command completed successfully. (2012-01-19 08:58:28) See also • release volume • show volumes 312 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 313
|ptsnap Optional. Specifies the class of volumes to show. type snap-pool|mastervolume|snapshot|standard|primary-volume |secondary-volume|replication-volume Optional. Specifies the type of volumes to show. The replication-volume option shows primary and secondary volumes. volumes Optional. A comma - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 314
qualifier enables host-based Storage Replication Adapter (SRA) software to determine which volume is the failed-over secondary volume for disaster recovery management (DRM). If both systems are online and the communication link between them is up, both systems will show similar information. When the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 315
9GB SN standard standard N/A write-back standard Adaptive WWN OK Success: Command completed successfully. (2013-01-14 15:34:46) Show volume information for vdisk VD2 only: # show volumes vdisk VD2 Vdisk Name Size Serial Number WR Policy Cache Opt Read Ahead Size Type Class Qualifier Volume - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 316
-month-day hour:minutes:seconds, when these statistics were last reset, either by a user or by a controller restart. Example Show statistics for volume vd1_v0001: # show volume-statistics vd1_v0001 Name Serial Number Bytes per second IOPS Number of Reads Number of Writes Data Read Data Written - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 317
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 317 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 318
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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 319
move its disks into this system. For a replication set, pools are in other vdisks, stop those vdisks. e. Move the vdisks into the secondary system. This system must support the link type that the replication set is configured to use. For example, if the replication set's link type is configured - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 320
pools are in other vdisks, stop those vdisks. e. Move the vdisks into the secondary system. This system must support the link type that the replication set is configured to use. For example, if the replication set's link type is configured data is flushed to disk. • Removing its disks will not cause - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 321
parameter. Example Suspend replication of primary volume V1 to secondary volume rV1: # suspend replication rV1 Success: Command completed successfully. (2012-01-20 14:47:35) See also • abort replication • resume replication • show replication-sets • show replication-volumes suspend replication 321 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 322
receipt of event-notification messages by every interface that is configured to receive them, such as email, SNMP, and SMI Controller log. • mc: Specify this option to send notification for the Management Controller log. • scdebug: Specify this option to send notification for the Storage Controller - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 323
procedure outlines the general steps for performing a trust operation, but the best procedure to follow for your situation may vary from this procedure. Before starting this procedure, consult the online troubleshooting guide at http://www.hp.com/support/msa2040/Troubleshooting to determine if the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 324
disks that you unplugged in steps 6 and 7. 10. Enable the trust command. 11. Run the trust command on the vdisk. After running the trust command 1. Reinsert the host-port cables be automatically disabled when the user's CLI session ends. vdisk vdisk Optional. show vdisks • verify vdisk 17:27:41) 324 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 325
. Syntax unfail controller a|b Parameters controller a|b Specifies whether to unfail controller A or B. You cannot unfail the controller on which the command is issued. Example From controller A, unfail controller B: # unfail controller b See also • fail • show controllers unfail controller 325 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 326
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 2012-01-20 14:34:24) See also • map volume • show host-maps • show hosts • show volume-maps • show volumes 326 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 327
system] [link-type FC] Parameters remote-system system Optional. The remote system's name or the IP address of one of its controller network ports. If this parameter is omitted, links between the local controllers are verified. link-type FC Optional. Specifies the type of host-port links to verify - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 328
A3,A4,B3,B4 B4 FC A3,A4,B3,B4 Success: Command completed successfully. (2013-01-30 15:36:36) Basetypes • remote-links See also • show remote-systems • verify remote-link 328 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 329
-system command.For replication purposes, this tests the links to be used for replication from one system -system system The remote system's name or the IP address of one of its controller network ports. link-type FC Optional. Specifies the show remote-systems • verify links verify remote-link 329 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 330
their user data. This command acts on disks that are associated with a vdisk and of a vdisk verify (VRFY) job, use the show vdisks command. When verification is complete, event 21 is any errors found and they will not be fixed. The default is yes. Example Start verifying vdisk vd1: # verify vdisk - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 331
about the versions of firmware and hardware in each controller module. If this parameter is omitted, only firmware-bundle information is shown Example Show firmware-bundle version information for a system in which controller B is not installed: # versions Controller A Versions Bundle Version: value - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 332
in a vdisk owned by the same controller as the source volume. If the source pool running out of space. If you expect the snap pool to have a high rate of data change, use the show snap-pools command to view the snap pool is not natively supported on all operating systems, all data on the disk at the time of - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 333
. • expert: Cancel the command. If this parameter is omitted, you must manually reply to the prompt. destination-volume A name for the volume to create in - The volume copy started. (2012-01-20 12:02:02) # show volumes Vdisk Name ... Type ... VD2 MV1 ... master volume ... VD2 MV1copy - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 334
334 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 335
only. Each basetype topic includes the following information: • References to CLI commands that directly use the basetype. • For each property, the values of its name and type elements, and a description of the values that the property may show. For descriptions of other elements see Table 2 (page - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 336
and starting again, from 1-360 hours. The default is 24 hours. string Shows whether component firmware versions are monitored and will be automatically updated on the partner controller. • Disabled: Partner firmware upgrade is disabled. • Enabled: Partner firmware upgrade is enabled. This is the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 337
will poll each enclosure's Enclosure Management Processor (EMP) for status changes, from 5-3600 seconds. The default is 5 seconds. string Shows whether hosts are allowed to use the SCSI MODE SELECT command to change the storage system's write-back cache setting. • Disabled: Host control of caching - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 338
is the default. Numeric equivalents for super-cap-failure values. • 0: Disabled • 1: Enabled Shows 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 339
disabled. This is the default. • Enabled: Background disk scrub is enabled. uint32 Numeric equivalents for background-disk-scrub values. • 0: Disabled • 1: Enabled string Shows whether the managed logs feature is enabled, which allows log files to be transferred from the storage system to a log - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 340
This basetype is used by show priorities. Table 9 attribute- replication but is queued waiting for the previous replications to complete. • DRM Snapshot: A temporary standard snapshot created from a replication snapshot for the purpose of doing a test failover for disaster recovery management - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 341
failure trigger is disabled. This is the default. • Enabled: The controller failure trigger is enabled. Shows whether the cache policy will change from write-back to write-through when the super-capacitor that provides backup power for cache is not fully charged or fails. • Disabled: The super - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 342
show cache-parameters, when a volume is specified, to show does not wait for data to be completely written to disk before signaling the host that the write is complete. This default. • no-mirror: When this mode is enabled, each controller stops mirroring its cache metadata to the partner controller - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 343
Table 11 cache-parameter properties (continued) Name Type Description read-aheadsize-numeric uint32 Numeric equivalents for read-ahead-size values. • -2: Stripe • -1: Adaptive • 0: Disabled • 524288: 512 KB • 1048576: 1 MB • 2097152: 2 MB • 4194304: 4 MB • 8388608: 8 MB • 16777216: 16 MB • - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 344
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: There is only a single controller in the enclosure. • Fail Over: Operation has failed over to one - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 345
certificate-status This basetype is used by show certificate. Table 13 certificate-status properties Name Type Description certificatestatus certificatestatus-numeric certificatetime certificatesignature string uint32 string string • Default: No customer-supplied or alternate certificate has - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 346
default is 1800 seconds (30 minutes). • console: Supports interactive use of the CLI full • Enabled: In XML output, this setting shows a subset of attributes of object properties. The name storage-size-base. • Enabled: Halts output after each full screen to wait for keyboard input. This is the default - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 347
of storage-space sizes. • 2: Sizes are shown as powers of 2, using 1024 as a divisor for each magnitude. • 10: Sizes are shown as powers of 10, using 1000 as a divisor for each magnitude. This is the default. Operating systems usually show volume size in base 2. Disk drives usually show size - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 348
14 cli-parameters properties (continued) Name Type Description temperaturescale-numeric ui-refresh user-type user-typenumeric username uint32 uint16 string uint32 string Numeric equivalents for temperature-scale values. • 0: Fahrenheit • 1: Celsius User interface refresh rate. The default is - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 349
• A: Controller A. • B: Controller B. Numeric equivalents for controller-id values. • 0: B • 1: A • Controller A CompactFlash • Controller B CompactFlash • Not Installed • Installed Numeric equivalents for status values. • 0: Not Installed • 1: Installed • Enabled: If the controller loses power, it - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 350
, overriding the volume-specific settings. When the problem is corrected, the cache policy reverts to the value configured for each individual volume. • Enabled: Write-back. This is the normal state. • Disabled: Write-through. • Not up: The controller is not up. Numeric equivalents for write-back - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 351
firmware version. Controller network port MAC address. Storage system World Wide Node Name (WWNN). The configured network port IP version. • 4: IPv4 Controller network port IP address. Controller network port IP subnet mask. Controller network port gateway IP address. Number of disks in the storage - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 352
. string string string string sint32 string Storage Controller firmware version. Controller manufacturer. Controller model. Storage Controller processor type. Storage Controller processor speed. Internal serial number of the controller. string Shows whether hosts are prevented from using the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 353
the health issue. Position of the controller in the enclosure. • Top: The controller is in the top slot. • Bottom: The controller is in the bottom slot. Numeric equivalents for position values. • 0: Top • 1: Bottom Shows whether the automatic disabling of SAS expander PHYs having high error counts - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 354
ip-address port-details enclosure-id compact-flash 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 355
-statistics This basetype is used by show controller-statistics. Table 18 controller-statistics properties Name Type Description durable-id cpu-load power-on-time write-cacheused bytes-persecond string uint32 uint32 uint32 • controller a • controller b Percentage of time the CPU is busy - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 356
-sample-time value. Date and time, in the format year-month-day hour:minutes:seconds, when sampling stopped for the iops and bytes-per-second values. Unformatted stop-sample-time value. The total amount of hours the controller has been powered on in its life time. 356 XML API basetype properties - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 357
are enabled for inclusion in the Storage Controller debug log. • Off: Disabled. • On: Enabled. This is the default. Numeric equivalents for disk values. • 0: Off • 1: On Shows whether internal memory debug messages are enabled for inclusion in the Storage Controller debug log. • Off: Disabled. This - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 358
Enabled. Numeric equivalents for iob values. • 0: Off • 1: On Shows whether upper-layer, verbose debug messages for an I/O interface driver are enabled for inclusion in the Storage Controller debug log. • Off: Disabled. This is the default. • On: Enabled. Numeric equivalents for ioc values. • 0: Off - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 359
for inclusion in the Storage Controller debug log. • Off: Disabled. • On: Enabled. This is the default. Numeric equivalents for cache values. • 0: Off • 1: On Shows whether Enclosure Management Processor debug messages are enabled for inclusion in the Storage Controller debug log. • Off: Disabled - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 360
enabled for inclusion in the Storage Controller debug log. • Off: Disabled. • On: Enabled. This is the default. Numeric equivalents for fruid values. • 0: Off • 1: On Shows whether Reservation Manager debug messages are enabled for inclusion in the Storage Controller debug log. • Off: Disabled. This - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 361
basetype is used by show disk-statistics when the historical parameter is specified. Table 20 disk-hist-statistics properties Name -second value. uint64 Average number of pending read and write operations being serviced since the last sampling time. This value represents periods of activity only - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 362
time. Error types include: number of SMART events; number of timeouts accessing the disk; number of times the disk did not respond; number of attempts by the storage system to spin-up the disk; media errors generated by the disk as specified by its manufacturer; non-media errors (generated by the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 363
-numeric iops string string string string Disk ID in the form disk_enclosure-number.disk-number. Disk serial number. 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 364
of-badblocks-2 uint32 uint32 For port 1, the number of media errors generated by the disk, as specified by its manufacturer. For port 1, the number of other errors generated by the storage system, or generated by the disk and not categorized as media errors. uint32 For port 1, the number of times - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 365
an I/O operation is failed regardless of the drive-attempt-timeout and drive-timeout-retry-max settings. The default is 105 seconds. disk-dsd-enable disk-dsdenable-numeric disk-dsdenable-pool disk-dsd-delay string uint32 string Shows whether available disks and global spares will spin down after - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 366
This basetype is used by show disk-statistics when the historical parameter is specified. Table 23 drive-summary properties Name Type Description durable-id serial-number disk-histstatistics string Disk ID in the form disk_enclosure-number.disk-number. string Disk serial number. Embedded; see - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 367
Not applicable. Disk slot number. Disk's enclosure ID and slot number. For internal use only. SCSI ID assigned to this disk for the primary channel. Unformatted size value in 512-byte blocks. Disk serial number. Disk vendor. Disk model. Disk firmware revision level. Shows the disk's usage value and - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 368
-node-wwn fc-p2-port-wwn fc-p2-unitnumber drive-down-code owner owner-numeric index string Numeric equivalents disk is down. Current owner, which is either the preferred owner during normal operation or the partner controller when the preferred owner is offline. • A: Controller A. • B: Controller - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 369
power-cycled. string For internal use only. string string Shows which controller a single-ported disk is connected to. • A: Controller A. • B: Controller B. For internal use only. string Serial number of the disk's vdisk, if any. string string string Enclosure WWN. Disk status. • Up: The disk - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 370
drives properties (continued) Name Type Description usage-numeric recon-state recon-statenumeric copyback-state copyback-statenumeric storage-tier storage-tiernumeric storage , this field shows the percentage of disk life remaining. This value is determined by polling the disk's internal endurance - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 371
Table 24 drives properties (continued) Name Type Description disk-dsd-count spun-down number-of-ios healthrecommendation uint32 uint32 uint64 bytes Number of times the DSD feature has spun down this disk. Shows whether the disk is spun down by the DSD feature. • 0: Not spun down. • 1: Spun - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 372
• none: Disables email notification. This is the default. This parameter does not apply to managed-logs notifications. uint32 Numeric equivalents for email-notification- Shows the email address for the log-collection system used by the logmanagement feature. Blank by default. string The IP address - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 373
JEDEC ID of the FRU manufacturer. Location of the FRU in the enclosure. • MID-PLANE SLOT: Chassis midplane. • UPPER IOM SLOT: Controller module or expansion module A. • LOWER IOM SLOT: Controller module or expansion module B. • LEFT PSU SLOT: Power supply module on the left, as viewed from the back - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 374
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. For disk and midplane types where this processor also controls power to the disk, power-on failure will result in Error status - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 375
Enclosure WWN. Enclosure name. Enclosure location; blank if not set. Number of the rack containing the enclosure. Position of the enclosure in the rack. Number of fan units in the enclosure. Number of disk slots (not installed disks) in the enclosure. Number of power supplies in the enclosure. Disk - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 376
for enclosure-arrangement values. • 0: vertical • 1: horizontal SCSI channel ID of controller A's EMP. SCSI target ID of controller A's EMP. SCSI channel ID of controller B's EMP. SCSI target ID of controller B's EMP. Shows the field name EMP A in console format. SCSI address and firmware revision - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 377
controllers power-supplies fan-details string uint32 string string uint32 string uint32 string string Enclosure midplane type. • 2U24-6Gv2: Midplane for 2U, reduced-depth, 24-disk enclosure with 6-Gbit/s maximum data rate to disks (HP MSA 2040 SFF chassis) • 2U24-6G: Midplane for 2U, 24-disk - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 378
enclosure-sku This basetype is used by show frus. Table 29 enclosure-sku properties Name Type Description sku-partnumber string sku_serialnumber string sku-revision string System part number. System serial number. System revision level. 378 XML API basetype properties - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 379
For event-code descriptions, see the Event Descriptions Reference Guide. event-id model serial-number controller controllernumeric severity string string string string uint32 string Event ID. Controller model. Controller serial number. • A: Controller A. • B: Controller B. Numeric equivalents for - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 380
expander-ports This basetype is used by show sas-link-health. Table 31 expander-ports properties Name Type Description durable-id enclosure-id controller controllernumeric name name-numeric status status-numeric health health-numeric health-reason healthrecommendation string uint32 string - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 381
is used by show fans. Table 32 fan properties Name Type Description durable-id name location string string string Fan unit ID in the form fan_enclosure-ID.fan-number. Fan unit name in the form Fan loc:position-PSU power-supply-ID for a controller enclosure or P2000 drive enclosure; Fan fan - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 382
Table 32 fan properties (continued) Name Type Description health-reason healthrecommendation string If Health is not OK, the reason for the health state. string If Health is not OK, the recommended actions to take to resolve the health issue. 382 XML API basetype properties - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 383
Configured topology. • Loop: Fibre Channel arbitrated loop (public or private). • PTP: Fibre Channel point-to-point. This is the default status is not Up, this field shows N/A. SFP status: • OK • Not this condition is detected, event 464 is logged. Shows whether the port contains an SFP. • Not - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 384
or by a controller restart. reset-timenumeric start-sampletime start-sampletime-numeric stop-sampletime stop-sampletime-numeric uint32 Unformatted reset-time value. string uint32 Date and time, in the format year-month-day hour:minutes:seconds, when sampling started for the iops and bytes-per - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 385
show and its entry was automatically created. • No: The host entry was manually created. • Yes: At least one volume is explicitly mapped to the host. be assigned to a mapping. • HP-UX: The host allows LUN 0 to be assigned to a mapping and uses Flat Space Addressing. • If the host was discovered and - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 386
allows LUN 0 to be assigned to a mapping. This is the default. • OpenVMS: The host does not allow LUN 0 to be assigned to a mapping. • HP-UX: The host allows LUN 0 to be assigned to a mapping and uses Flat Space Addressing. host-viewmapping Embedded; see host-view-mappings. 386 XML API basetype - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 387
host-view-mappings This basetype is used by show host-maps. Table 37 host-view-mappings properties Name Type Description volume-name volume- has read access to the volume. • no-access: Host is denied access to the volume. Controller host ports assigned to the mapping. host-view-mappings 387 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 388
by show inquiry. Table 38 inquiry properties Name Type Description mc-fw mc-loader sc-fw sc-loader serial-number mac-address ip-address nvram-defaults string string string string string string string string Management Controller firmware version. Management Controller loader firmware version - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 389
the controller's PCBA was programmed or a power supply module Configuration serial number. string uint32 Shows whether the automatic disabling of SAS expander PHYs having high error counts is enabled or disabled for this controller. • Enabled: PHY fault isolation is enabled. This is the default - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 390
39 io-modules properties (continued) Name Type Description status status-numeric health health-numeric health-reason healthrecommendation unhealthycomponent enclosure-id string uint32 string uint32 string string I/O module status. • Up • Warning • Error • Not Present • Unknown • Disconnected - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 391
snapshots allowed without an installed license. uint32 Maximum number of snapshots allowed by the installed license. uint32 Number Snap is enabled. Numeric equivalents for remote-snapshot-replication values. • 0: Disabled • 1: Enabled string Shows when the Remote Snap feature will expire. • - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 392
Disabled • 1: Enabled Shows when the VDS (Virtual Disk Service) Hardware Provider will Shows when the Drive Spin Down (DSD) feature will expire. • Never: Always enabled and doesn't expire. Numeric equivalents for dsd-expiry values. • 0: Never Shows whether Storage Replication Adapter (SRA) support - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 393
Table 40 license properties (continued) Name Type Description sra-expiry sra-expirynumeric string uint32 Shows when the SRA feature will expire. • Never: Always enabled and doesn't expire. Numeric equivalents for sra-expiry values. • 0: Never license 393 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 394
the log file downloaded from the system by using SMU or FTP. Table 41 log-header-table properties Name Type Description log-contact log-email log-phone log-comments string string string string Contact person's name, if specified in the SMU Save Logs panel. Contact's email address, if specified - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 395
master-volumes This basetype is shown by show master-volumes. Table 42 master-volumes properties Name Type Description virtual-diskname serial-number name size size-numeric status status-reason snap-pool-name snapshots snap-data string Vdisk name. string string string uint32 string string - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 396
mgmtport_controller-ID. The configured network port IP version. • 4: IPv4 Controller network port IP address. Controller network port gateway IP address Controller network port IP subnet mask Controller network port MAC address. • Manual: Obtain network address from manual (static) settings. • DHCP - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 397
ntp-status ntp-serveraddress string string Shows whether use of Network Time Protocol (NTP) is enabled. • activated: NTP is enabled. • deactivated: NTP is disabled. This is the default. • 0.0.0.0: NTP server IP address is not set. • NTP server IP address. ntp-contacttime string • Date and time - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 398
loss is probable. When this threshold is reached, an event is generated to alert the administrator and the associated snap-pool policy is triggered. The default is 90%. • Critical: The snap pool is 98% full and data loss is imminent. When this threshold is reached, an event is generated to alert the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 399
is used by show ports. Table 46 port properties Name Type Description durable-id controller controllernumeric port port- • Up: The port is cabled and has an I/O link. • Warning: Not all of the port's PHYs are up. • Not Present: The controller module is not installed or is down. • Disconnected: - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 400
• 6: 6Gb • 7: 8Gb • 8: 10Mb • 9: 100Mb • 10: 10Gb • 12: 16Gb • 255: Port is disconnected. Configured host-port link speed in Gbit/s. • Auto (the default) • 4Gb • 8Gb • 16Gb Numeric equivalents for configured-speed values. • 2: 4Gb • 3: Auto • 7: 8Gb • 12: 16Gb • OK • Degraded • Fault • N/A Numeric - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 401
-supplies This basetype is used by show power-supplies. Table 47 power-supplies properties Name Type Description durable-id enclosure-id serial-number description name revision model vendor location string uint32 string string string string string string string Power supply ID in the form - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 402
reason for the health state. If Health is not OK, the recommended actions to take to resolve the health issue. string Power supply status. • Up • Warning • Error • Not Present • Unknown uint32 Numeric equivalents for status values. • 0: Up • 1: Warning • 2: Error • 3: Not Present • 4: Unknown - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 403
product-info This basetype is used by show inquiry. Table 48 product-info properties Name Type Description vendor-name product-id scsi-vendor-id string string string Vendor name. Product model identifier. Vendor name returned by the SCSI INQUIRY command. product-info 403 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 404
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. • Fail Over: Operation has failed over to one - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 405
(continued) Name Type Description other-MC-status other-MCstatus-numeric string uint32 The operational status of the Management Controller in the partner controller. This is not factored into system health. • Not Communicating • Not Operational • Operational • Unknown Numeric equivalents for - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 406
-counters. Table 50 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 407
is used by show replication-volumes. Table 51 remote-addresses properties Name Type Description connected-ports remote-address string string • port that a problem is preventing half the available bandwidth from being used. • N/A: For a local primary or secondary volume. The address of each - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 408
by verify links and verify remote-link. Table 52 remote-links properties Name local-host-port type type-numeric remote-links Type Description string Controller host port ID in the local system, in the form hostport_controller-ID-and-port-number. string • Unknown: Port type is unknown. • FC: FC - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 409
in the remote system. • Not Present • The IP address of the network port in controller B in the remote system. • Not Present The name of a user that is configured in the remote system. This must be a manage-level user to remotely configure or provision that system. • Uninitialized: This system hasn - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 410
Type Description isvalid-ip-anumeric isvalid-ip-b isvalid-ip-bnumeric uint32 string uint32 Numeric equivalents for isvalid-ip-a values. • 0: False • 1: True • False: The IP address is not valid for controller B in the remote system. • True: The IP address is valid for controller B in the remote - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 411
is used by show tasks and show task-details for a ReplicateVolume task. Table 54 replicate-volume-tasks properties starts at 001. • new-snapshot: Replicate a new snapshot of the volume to the remote system. This is the default. • last-snapshot: Replicate the last (most recent existing) snapshot - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 412
used by show replication-images. Table 55 replication-image properties Name Type Description image-key replicationvolume-serialnumber image-serialnumber replicationimage-source snapshot-serial string Replication image ID. string Replication volume serial number. string Replication image serial - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 413
-image-params This basetype is used by show replication-images. Table 56 replication-image-params properties Name Type Description status status-numeric progress start-time string uint32 string string Replication image status. • N/A: The image information is not valid. • Queued: The - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 414
replication-set This basetype is used by show replication-sets. Table 57 replication-set properties Name Type Description name serial-number primary string Replication set name. string Replication set serial number. Embedded; see replication-volume. 414 XML API basetype properties - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 415
is used by show replication-volumes. Table 58 replication-volume properties Name Type Description name serial-number status status-numeric status-reason status-reasonnumeric monitor string string string uint32 string uint32 string Replication volume name. Replication volume serial number - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 416
in the local system. • Remote: The replication volume is in a remote system. Numeric equivalents for location values. • 0: Local • 1: Remote IP address of the network port in controller A in the remote system. IP address of the network port in controller B in the remote system. Primary volume name - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 417
higher priority than host I/O. This can cause heavy I/O to be slower than normal. This is the default. • Medium: Replication performance is balanced with host I/O performance. • Low: Replication runs at a slower rate with minimal effect on host I/O. Use when streaming data without interruption is - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 418
-volume-summary This basetype is used by show replication-images. Table 59 replication-volume-summary properties Name Type Description name serial-number volume-type string string string Replication volume name. Replication volume serial number. • Primary Volume: The volume is the primary - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 419
tasks This basetype is used by show tasks and show task-details for a ResetSnapshot task. Table 60 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. reset-snapshot-tasks 419 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 420
-a This basetype is used by show expander-status. Table 61 sas-status-controller-a properties Name Type Description enclosure-id drawer-id drawer-idnumeric controller controllernumeric phy type type-numeric status uint32 string uint32 Enclosure ID. Not applicable. Not applicable. string - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 421
connection problem exists such as a broken connector. • Drive removed: PHY disabled because drive slot is empty. • Unused - disabled by default: PHY is disabled by default because it is not used. • Excessive PHY changes: PHY is disabled because of excessive PHY change counts. sas-status-controller - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 422
reset-errorcounter flag-bits uint32 Numeric equivalents for elem-reason values. • 0: (blank) • 32769: Error count interrupts • 32771: PHY control • 32772: Not ready • 32774: Drive removed • 32775: Unused - disabled by default alternate. uint32 In a sequence of SAS transfers (frames), the data is - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 423
schedules This basetype is used by show schedules and show schedule-details. Table 62 schedules properties Name Type Description name schedulespecification status next-time next-timenumeric task-to-run error-message task string Schedule name. - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 424
is enabled. This is the default. Numeric equivalents for cli-ssh values. • 0: Disabled • 1: Enabled • Disabled: The secure SMI-S interface is disabled. • Enabled: The secure SMI-S interface is enabled. This option allows SMI-S clients to communicate with each controller's embedded SMI-S provider via - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 425
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 firmware update or partner firmware update operation is active and shows the progress through each step - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 426
initializing. This typically occurs during controller startup. • Unrecoverable: The enclosure management processor (EMP) cannot communicate Installed • 6: Unknown • 7: Unavailable Sensor location in a controller enclosure. • 1: Unknown • 2: Overall unit status • 5: Power supply unit • 7: Enclosure - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 427
This basetype is used by show shutdown-status. Table 65 show-other-mc-status properties Name Type Description other-mc other-mc-status other-mcstatus-numeric string string uint32 Other MC Status The operational status of the Management Controller in the partner controller. This is not factored - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 428
used by show shutdown-status. Table 66 shutdown-status properties Name Type Description controller status status-numeric string string uint32 • A: Controller A. • B: Controller B. • up: The controller is operational. • down: The controller is shut down. • not installed: The controller is not - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 429
is used by show snap-pools. Table 67 snap-pools properties Name Type Description virtual-diskname serial-number name size size-numeric reserved-size reserved-sizenumeric free string Vdisk name. string string string uint32 string uint32 Snap pool serial number. Snap pool name. Snap pool size - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 430
See the status-reason value. • 0: Available • Nonzero: Unavailable status-reason status-reasonnumeric master-volumename snap-pool-name snap-data snap-datanumeric uniquedata string uint32 string Shows N/A for Available status, or one of the following reasons for Unavailable status: • snapshot not - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 431
the purpose of doing a test failover for disaster recovery management (DRM). • Replication snapshot: For a primary or secondary volume, a snapshot that was created by a replication operation but is not a sync point. • Replication snapshot(Replicating): For a primary volume, a snapshot that is being - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 432
snapshot(Current sync point) • 0x00040000: Replication snapshot(Common sync point) • 0x00080000: Replication snapshot(Only sync point) • 0x00100000: Replication snapshot(Queued) • 0x00200000: Replication snapshot(Awaiting replicate) • 0x00800000: Replication snapshot(Common sync point) • 0x00000000 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 433
snapshot-with-retention-tasks This basetype is used by show tasks and show task-details for a TakeSnapshot task. Table 69 snapshot-with-retention-tasks properties Name Type Description master-volumename master-volumeserial snapshot-prefix retention-count last-created - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 434
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 70 snap-tasks properties Name Type Description snapshot-name string Snapshot name. snapshot- - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 435
crit Trap host IP address. string Trap host IP address. string Trap host IP address. string string The community string for read-only access. The value is represented by six asterisks to monitor-level users and is shown in clear text to manage-level and admin-level users. The default is public - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 436
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 72 status properties Name Type Description response-type response-typenumeric response string uint32 string • - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 437
73 syslog-parameters properties Name Type Description syslog-host-ip syslognotificationlevel syslognotificationlevel-numeric syslog-hostport string string uint32 uint32 The IP address of the remote syslog server to use for the notifications. Shows the minimum severity for which the system sends - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 438
is used for or how it's configured. The default is Uninitialized Info. The serial number of the controller enclosure midplane. The vendor name. The : Operational • 1496: Unknown Shows whether partner firmware update is running on the system, or is idle. Supported display languages: English, Spanish, - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 439
Table 74 system properties (continued) Name Type Description fde-securitystatus fde-securitystatus-numeric redundancy-mode unhealthycomponent string Not applicable. uint32 Not applicable. Embedded; see redundancy. Embedded; see unhealthy-component. system 439 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 440
that each controller supports. uint32 Not applicable. uint32 Same as max-vdisks. uint32 Maximum chunk size for vdisks. uint32 Minimum chunk size for vdisks. uint32 Starting index for physical components (enclosures, disks, etc.) in the storage system. uint32 Percentage of disk capacity that - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 441
the same IP address for both controllers, only one active at a time. Numeric equivalents for lan-heartbeat values. • 0: CAPI_TWO_IP_ADDRESSES_MODE • 1: CAPI_ONE_IP_ADDRESS_MODE For use by service personnel. For internal use only. Number of global-spare disks defined in the storage system. uint32 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 442
tasks This basetype is used by show tasks and show task-details. Table 76 tasks properties Name Type Task is running. • Error: Task has an error. • Invalid: Task is invalid. Current step of the task. • For a TakeSnapshot task: • Start • VerifyVolume • ValidateLicensingLimit • CreateName - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 443
task: • Start Message if an error occurred while processing the task, or blank. For a VolumeCopy task, the serial number of the destination vdisk. Embedded; see replicate-volume-tasks, reset-snapshot-tasks, snap-tasks, snapshot-withretention-tasks, volume-copy-tasks. tasks 443 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 444
in hours and minutes from UTC. This is shown only if NTP is enabled. string Shows whether Network Time Protocol (NTP) is in use. • activated: NTP is enabled. • deactivated: NTP is disabled. This is the default. string NTP server IP address, or 0.0.0.0 if not set. 444 XML API basetype properties - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 445
This basetype is used by all commands that show component health. Table 78 unhealthy-component properties Name MC: Management Controller • port: Host port • controller: Controller module • expansion module: Expansion module • PSU: Power supply unit • disk: Disk slot • enclosure: Enclosure • vdisk - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 446
unwritable-cache This basetype is used by show unwritable-cache. Table 79 unwritable-cache properties Name Type Description unwritable-apercentage unwritable-bpercentage uint8 Total percentage of cache memory used for unwritable data in controller A. uint8 Total percentage of cache memory used - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 447
display of storage-space sizes: • 2: Sizes are shown as powers of 2, using 1024 as a divisor for each magnitude. • 10: Sizes are shown as powers of 10, using 1000 as a divisor for each magnitude. This is the default. Operating systems usually show volume size in base 2. Disk drives usually show size - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 448
of decimal places (1-10) for display of storage-space sizes. The default is 1. The unit for display of storage-space sizes. • auto: Lets the system determine protocol. Authentication uses the user password. • none: No authentication. • MD5: MD5 authentication. This is the default. • SHA: SHA (Secure - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 449
is set to DES or AES. The password is shown in clear text for reference when configuring users in the corresponding management application. 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 450
vdisk-hist-statistics This basetype is used by show vdisk-statistics when the historical parameter is specified. Table 81 vdisk-hist-statistics properties Name Type Description total-datatransferred total-datatransferrednumeric data-read data-readnumeric - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 451
bytes-persecond-numeric iops string string string uint32 Vdisk name. Vdisk serial number. 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. Unformatted bytes - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 452
date. Storage Controller firmware version. Storage Controller firmware base level. Storage Controller memory-controller FPGA firmware version. Storage Controller loader firmware version. Configuration API (CAPI) version. Management Controller firmware version. Management Controller loader firmware - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 453
summary This basetype is used by show vdisk-statistics when the historical parameter is specified. Table 84 virtual-disk-summary properties Name Type Description name serial-number vdisk-histstatistics string Vdisk name. string Vdisk serial number. Embedded; see vdisk-hist-statistics. virtual - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 454
This basetype is used by show vdisks. Table 85 virtual-disks properties Name Type Description name size size-numeric the partner controller when the preferred owner is offline. • A: Controller A. • B: Controller B. Numeric equivalents for owner values. • 0: B • 1: A Controller that owns - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 455
85 virtual-disks properties (continued) Name Type Description chunksize status status-numeric lun min-drive-size min-drive-sizenumeric create-date create-datenumeric string string uint32 uint32 string uint32 string uint32 • For RAID levels except NRAID, RAID 1, and RAID 50, the configured chunk - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 456
these statistics were last reset or since the controller was restarted. uint32 Total sectors read. uint32 Total sectors written. string string uint32 string uint32 uint32 Same as current-job. Job running on the vdisk, if any. • (blank): No job is running. • DRSC: A disk is being scrubbed. • EXPD - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 457
Type of disks used in the vdisk. • SAS: Enterprise SAS. • SAS MDL: Midline SAS. • sSAS: SAS SSD. • MIX: Mixture of enterprise SAS and midline SAS disks. Numeric equivalents for array-drive-type values. • 1: MIX • 4: SAS • 8: sSAS • 11: SAS MDL • false: The current job must be manually aborted before - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 458
Table 85 virtual-disks properties (continued) Name Type Description total-datatransferred total-datatransferrednumeric total-bytesper-sec total-bytesper-sec-numeric health health-numeric health-reason healthrecommendation unhealthycomponent bytes Total - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 459
volume-copy-status This basetype is used by show volumecopy-status. Table 86 volume-copy-status properties Name Type Description vc_volume_name serial-number virtual-diskname source-volume progress status string string string Destination volume - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 460
volume-copy-tasks This basetype is used by show tasks and show task-details for a VolumeCopy task. Table 87 volume-copy-tasks properties Name Type Description source-volumename source-volumeserial destinationvdisk-name destinationpool-namenumeric destinationvdisk-serial destinationpool- - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 461
volume-names This basetype is used by show volume-names. Table 88 volume-names properties Name Type Description volume-name serial-number string Volume name. string Volume serial number. volume-names 461 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 462
-reservations This basetype is used by show volume-reservations. Table 89 volume-reservations Numeric equivalents for reservation-active values. • 0: Free • 1: Reserved Host WWPN. The controller host-port identifiers. The reservation type. • Undefined: The volume has no persistent reservations. - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 463
is used by show volumes. Table 90 volumes properties Name Type Description durable-id virtual-diskname storage-poolname volume- This is the default. • write-through: Write-through caching significantly impacts performance by waiting for data to be completely written to disk before signaling the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 464
is the default. • no-mirror: When this mode is enabled, each controller stops mirroring its cache metadata to the partner controller. This improves snap-pool: Snap-pool volume. • master volume: Master volume. • snapshot: Snapshot volume. • replication source: Source for an in-progress replication to - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 465
qualifier enables host-based Storage Replication Adapter (SRA) software to determine which volume is the failed-over secondary volume for disaster recovery management (DRM). If both systems are online and the communication link between them is up, both systems will show similar information. When the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 466
allowedstorage-tiers allowedstorage-tiersnumeric thresholdpercent-of-pool reserved-sizein-pages allocatereserved-pagesfirst allocatereserved uint32 For a volume-copy operation, the percent complete (0%-99%). The default value is 0%. Unformatted progress value. string Vdisk name. string Vdisk serial - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 467
-numeric iops string string string uint32 The name of the volume. The serial number of the volume. 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 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 468
start-sampletime-numeric stop-sampletime stop-sampletime-numeric uint32 Unformatted reset-time value. string uint32 The date and time, in the format year-month-day hour:minutes:seconds, when sampling started for the iops and bytesper-second values. Unformatted start-sample-time value. string - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 469
volume-view This basetype is used by show volume-maps. Table 92 volume-view properties Name 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. string Volume serial number. string Volume name. - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 470
show the current CLI session and may change after an MC restart Not applicable. Not applicable. • Controller host ports has read and write access to the volume. This is the default. • read-only: The host has read access to the HP-UX: The host allows LUN 0 to be assigned to a mapping and uses - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 471
firmware updates, and other product resources. Related information The following documents provide related information: • HP MSA System Racking Instructions • HP MSA 2040 Quick Start Instructions • HP MSA 2040 Cable Configuration Guide • HP MSA 2040 User Guide • HP MSA 2040 SMU Reference Guide • HP - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 472
• HP MSA 2040 best practices: http://www.hp.com/support/msa2040/BestPractices • HP MSA 2040 firmware downloads: http://www.hp.com/support • HP MSA 2040 Guided Troubleshooting: http://www.hp.com/support/msa2040/Troubleshooting • Safety and Compliance Information for Server, Storage, Power, Networking - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 473
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 ([email protected]). Include the document title and part number, version number, or the URL when - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 474
474 Documentation feedback - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 475
• Disabled • Enabled All configured users are deleted and replaced with default user definitions and default settings: • User: manage; password: !manage • User: monitor; password: !monitor • User: ftp; password: !ftp • Temperature scale: Celsius • Timeout: 30 minutes CLI/Telnet timeout Tasks and - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 476
) Enabled Managed Logs Disabled 1. Factory default: no tasks or schedules. 2. Factory default: no remote system definitions. 3. Factory default: MC logs are cleared. 4. Factory default: NTP is disabled; NTP host IP address is 0.0.0.0; NTP offset is 0. 5. Factory default: IP addresses are released - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 477
back to write-through. CAPI Configuration Application Programming Interface. A proprietary protocol used for communication between the Storage Controller and the Management Controller in a controller module. CAPI is always enabled. chassis The sheetmetal housing of an enclosure. chunk size The - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 478
management. Storage-system firmware features that, when the Site Replication Adapter (SRA) feature is enabled, support the use of VMware's Site Recovery Manager to automate disaster-recovery failover and failback tasks. See also SRA. Drive spin down. A power-saving feature that monitors disk - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 479
modules, disk drives, and other FRUs. enclosure management See EMP. processor Expander Controller See EC. expansion enclosure See drive enclosure. expansion module A FRU that contains the following subsystems and devices: a SAS expander and EC processor; host, expansion, and service ports; and - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 480
interface and computer-computer interfaces, including the WBI, CLI, and FTP interfaces, and interacts with the Storage Controller. See also EC and SC. See MAC address. Data in the first sectors of a disk drive that stores all disk-, vdisk-, and volume-specific information including vdisk membership - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 481
orphan data Partner Firmware Update PFU PHY physical layer point-to-point POST Power-On Self Test power supply unit primary volume proxy volume PSU recovery remote replication remote syslog support replication image replication set replication snapshot replication sync point SAS Object Identifier - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 482
The processor (located in a controller module) that is responsible for RAID controller functions. The SC is also referred to as the RAID controller. See also EC and MC. SCSI Enclosure Services See SES. secondary volume The volume that is the destination for data in a replication set and that is - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 483
SRA Storage Replication Adapter. A host-based software component that allows VMware's Site Recovery Manager to manage the storage-system firmware's disaster recovery management (DRM) features, automating disaster-recovery failover and failback tasks. The SRA uses the CLI XML API to control the - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 484
Wide Node Name See WWNN. World Wide Port Name See WWPN. WQL Windows Management Instrumentation Query Language. WWN World Wide Name. A globally unique 64-bit number that identifies a device used in storage technology. WWNN World Wide Node Name. A globally unique 64-bit number that identifies - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 485
18 command-line interface See CLI commands API-specific 23 CLI and user 21 disk, vdisk, and spare 21 event notification 22 remote replication 24 remote systems 23 replaced or removed 24 scheduled task 22 service utilities 23 snapshot 22 statistics 24 system configuration and utilities 23 volume copy - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 486
setting 184 start manual scrub 127 dynamic spares enable/disable 130 show setting 184 E EMP polling rate set 130 show 184 enclosure locate 152 enclosures set location 145 set name 145 set position in rack 145 set rack number 145 show EMP address and firmware revision 215 show health 215 show ID 215 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 487
set CLI 137 set user 59, 179 show CLI 194 show user 298 log management enable/disable 130 send events to syslog on a remote system 174 show setting 186 LUNs set response to missing 130 show maximum number of 284 show setting for response to missing 185 M MAC address, controller 241 managed logs - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 488
syntax 18 ports show health for SAS 265 power supplies show 247 power supply failure trigger enable/disable 131, 133 show setting 185, 188 488 Index precision for storage-space sizes set CLI 138 set user 59, 179 show CLI 194 primary volume set 162 priorities set snap-pool retention 157 priority - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 489
reset disk error 113 reset disk performance 114 reset host-port performance 116 reset vdisk performance 120 reset volume performance 121 show controller performance 201 show disk performance 209 show host-port performance 233 show vdisk performance 303 show volume performance 316 Storage Controllers - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 490
number per controller 284 show performance statistics 303 start manual scrub 128 verification abort 30 versions show hardware and firmware 331 virtual disk name 18 serial number 18 voltages show component 271 volume abort copy 31 convert standard to master 40 create copy 332 create replication 32 - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 491
reservations 105 reset performance statistics 121 roll back master 126 set name 183 set read-ahead cache size 136 set the default mapping 63 set write policy 135 show 313 show cache optimization mode 191, 313 show cache redundancy mode 190 show mappings 308 show maximum number of 284 show names and - HP MSA 2040 | HP MSA 2040 CLI Reference Guide (723979-001, June 2013) - Page 492
492 Index
HP MSA 2040
CLI Reference Guide
HP Part Number: 723979-001
Published: May 2013
Edition: 1
Abstract
This guide provides information about managing an HP MSA 2040 storage system by using its command-line interface (CLI).