HP MSA 1040 HP MSA 1040 CLI Reference Guide (762782-001, March 2014)
HP MSA 1040 Manual
View all HP MSA 1040 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP MSA 1040 manual content summary:
- HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 1
HP MSA 1040 CLI Reference Guide Abstract This guide provides information about managing an HP MSA 1040 storage system by using its command-line interface (CLI). HP Part Number: 762782-001 Published: March 2014 Edition: 1 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 2
computer software. Valid license from HP required for possession, use or license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 3
27 Removed commands 28 3 Alphabetical list of commands 29 abort replication 30 abort scrub 31 abort verify 32 abort volumecopy 33 add replication-volume 34 clear cache 36 clear disk-metadata 37 clear events 39 clear expander-status 40 cls (Deprecated 40 convert master-to-std 41 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 4
-write-data 84 delete task 85 delete user 86 delete vdisk (Deprecated 86 delete vdisks 87 delete vdisk-spare 88 delete volumes 89 dequarantine 90 detach replication-volume 93 down disk 95 exit 96 expand snap-pool 97 expand vdisk 98 expand volume 100 export snapshot 101 fail 102 help - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 5
186 set user 188 set vdisk 192 set vdisk-spare 193 set volume 194 show advanced-settings 195 show auto-write-through-trigger 199 show awt 200 show cache-parameters 201 show certificate 204 show channels (Deprecated 204 show chap-records 205 show cli-parameters 206 show configuration 208 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 6
refresh-counters 270 show remote-systems 271 show replication-images 273 show replication-sets 276 show replication-volumes 280 show sas-link-health 283 show schedule-details 285 show schedules 286 show sensor-status 288 show shutdown-status 290 show snap-pools 291 show snapshots 293 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 7
enclosure-sku 401 events 402 expander-ports 403 fan 404 fc-port 406 host-port-statistics 407 hosts 408 host-view 409 host-view-mappings 410 inquiry 411 io-modules 412 iscsi-parameters 414 iscsi-port 415 license 416 log-header-table 419 master-volumes 420 network-parameters 421 ntp - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 8
-statistics 497 volume-view 499 volume-view-mappings 500 5 Support and other resources 501 Contacting HP 501 Subscription service 501 Product advisories 501 Related information 501 Typographic conventions 502 6 Documentation feedback 503 A Settings changed by restore defaults 505 Glossary - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 9
Index 515 Contents 9 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 10
10 Contents - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 11
43 iscsi-port properties 415 44 license properties 416 45 log-header-table properties 419 46 master-volumes properties 420 47 network-parameters properties 421 48 ntp-status properties 423 49 policy-threshold properties 424 50 port properties 425 51 power-supplies properties 427 52 product - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 12
442 64 replication-volume-summary properties 445 65 reset-snapshot-tasks properties 446 66 sas-status-controller-a properties 447 67 schedules properties 450 68 security-communications-protocols properties 451 69 sensors properties 453 70 show-other-mc-status properties 454 71 shutdown-status - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 13
host that 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 14
: version Serial Number: SN 172.22.5.55 login: monitor Password: product System Name: Test System Location: Lab Version: version # show disks free Location Serial Number Vendor Rev How Used Type Job% Speed (kr/min) Size Rate*(Gbit/s) SP Recon State Copyback State Life Remaining% Health - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 15
= new Net::Telnet ( Timeout=>10, Errmode=>'die', Prompt => '/\# $/i'); if ( !cLogin($ipAddr, $username, $password) == 1 ) { print("Error: $username user failed to log in. Exiting.\n"); $telnet->close; exit(0); } For scripting support, the following command can be used to access the XML API and to - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 16
my $sessionKey; foreach my $prop ( @props ) { my $name = $prop->getAttribute('name'); print "Property = " . $name . "\n"; if( $name eq 'response' ) { $sessionKey = $prop->textContent; } } print "Session Key = $sessionKey\n"; # Run a sample command to obtain the disks in the system. $url = 'http://10 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 17
. The response includes: • A number of OBJECT elements, which varies by a storage-system component such as a disk or a volume. An for this data to show in user interfaces. COMP A COMP (composition) P. The oid of the part component. • G. The oid configuration. Other commands provide configuration - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 18
The following example shows the XML API status object: Success - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 19
by default, returns number of bytes transmitted for each request and allows caching connection to this host port. - No action is required. - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 20
support lists. List example: vd1,"My vdisk" Specifying volumes You can specify: • A volume by its name or serial number. A unique serial number is automatically assigned when a volume is created, and does not change for the life of the volume. • A list of volume names or serial numbers separated - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 21
password contains UTF-8 characters that are outside the range of printable ASCII characters. Command completion, editing, and history The CLI supports Viewing help To view brief descriptions of all commands that are available to the user level you logged in as, enter: help To view full help for a - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 22
. Operating systems usually show volume size in base 2. Disk drives usually show size in base 10. Memory (RAM and ROM) size is always shown in base 2. In the CLI, the base for entry and display of storage-space sizes can be set per user or per session; see create user and set cli-parameters. When - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 23
create host create volume create volume-set delete host delete volumes expand volume map volume release volume scrub volume set cache-parameters set host-name set password set prompt set user show cli-parameters show users rescan scrub vdisk set expander-fault-isolation set led set spares set vdisk - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 24
set email-parameters set snmp-parameters set syslog-parameters show email-parameters 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 25
set system show advanced-settings show auto-write-through-trigger show awt show cache-parameters Service utilities clear events clear expander-status fail reset smis-configuration restore defaults set debug-log-parameters API specific meta Remote systems create remote-system delete - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 26
) Category Commands Remote replication Statistics abort replication add replication-volume create replication-set delete replication-set detach replication-volume export snapshot reattach replication-volume remove replication-volume replicate snapshot replicate volume reset all-statistics reset - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 27
command cls create host-wwn-name delete host-wwn-name delete iscsi-host delete vdisk history reset host-channel-link set drive-parameters set host-wwn-name set iscsi-host set job-parameters set output-format show channels show drive-parameters show enclosure-status show host-wwn-names show job - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 28
disk-metadata create host-name create host create iscsi-host create host echo None exec None expand master-volume expand volume set host-port-interconnects None - not applicable to MSA 1040 set replication-external-view set replication-primary-volume set snap-pool policy set snap-pool - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 29
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 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 30
on the system that owns the secondary volume. Syntax abort replication [set replication-set] replication-volume Parameters set replication-set Optional. The name or serial number of the replication set. replication-volume The name or serial number of the secondary volume. If the name is not unique - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 31
of the vdisks to stop scrubbing. For vdisk syntax, see "Command syntax" (page 20). volume volumes A comma-separated list of the names or serial numbers of the volumes to stop scrubbing. For volume syntax, see "Command syntax" (page 20). Example Abort scrubbing vdisk vd1: # abort scrub vdisk vd1 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 32
the verify vdisk operation for specified vdisks. Syntax abort verify vdisk vdisks Parameters vdisk vdisks A comma-separated list of the names or serial numbers of the vdisks to stop verifying. For vdisk syntax, see "Command syntax" (page 20). Example Abort verifying vdisk vd1: # abort verify vdisk - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 33
. When the abort is complete, the destination volume is deleted. Syntax abort volumecopy volume Parameters volume The name or serial number of the source volume, the destination volume, or if a snapshot is being copied, its associated master volume. For volume syntax, see "Command syntax" (page 20 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 34
-volume volume The name or serial number of the replication volume to be the primary volume for the replication set. priority low|medium|high Optional. The priority of the replication process on the replication volume: low, medium, or high. remote-system system Optional for a local volume; required - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 35
: Command completed successfully. (2012-01-21 17:37:40) Add secondary volume LosAngeles to a replication set that uses iSCSI links and whose primary volume is NewYork: # add replication-volume LosAngeles primary-volume NewYork link-type iSCSI secondary-address ip=10.134.69.5,10.134.69.6 See also - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 36
clear cache [volume volume] Parameters volume volume Optional. The name or serial number of a specific volume for which to clear unwritable cache data. For volume syntax, see "Command syntax" (page 20). Example Clear unwritable cache data for volume V1 from both controllers: # clear cache volume v1 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 37
use this command, contact technical support for further assistance. Each disk RAID level. • The disk's Fault/UID LED is illuminated amber. • For a 2U12 or 2U24 enclosure, the disk's fault LED becomes illuminated. If spares Show disk usage: # show disks Location ... How Used ... 1.1 ... - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 38
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) 38 Alphabetical list of commands - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 39
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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 40
Clears the counters and status for SAS expander lanes. For use by or with direction from technical support. Counters and status can be reset to a good state for all enclosures, or for a specific enclosure whose status is Error as shown by the show expander-status command. NOTE: If a rescan is - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 41
. Syntax convert master-to-std master-volume Parameters master-volume The name or serial number of the master volume to convert. For volume syntax, see "Command syntax" (page 20). Example Convert a master volume having no snapshots to a standard volume: # convert master-to-std MV1 Success: Command - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 42
snap-pool snap-pool The name or serial number of the snap pool to associate with the new master volume. For volume syntax, see "Command syntax" (page 20). standard-volume The name or serial number of the standard volume to convert. For volume syntax, see "Command syntax" (page 20). Example - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 43
. The storage system supports use of unique certificates for secure data communications, to authenticate that the expected storage systems are is generated based on the system's serial number and other standard values. This certificate is installed, and the original certificate is archived. - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 44
Restore the original certificate that existed before the custom one was generated: # create certificate restore To make the certificate change take effect you must restart both Management Controllers by entering "restart mc both". Press Enter to acknowledge this message. Success: Command completed - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 45
pairs to authenticate both the originator and the recipient (mutual CHAP). For a login request from an iSCSI host to a storage system, the host is the originator and the storage system is the recipient. Syntax create chap-record name originator-name secret originator-secret [mutual-name recipient - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 46
volumes to hosts the nickname can make a host easy to recognize. Syntax create host id ID nickname [profile standard|hp double quotes. profile standard|hp-ux Optional. • standard: Default profile. • hp-ux: The host 53:20) Create an entry named Host3 for an iSCSI host: # create host id iqn.1991-05. - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 47
same controller. Volume sizes are aligned to 4-MB boundaries. When a volume is created or expanded, if the ] [prepare-replication-volume] name Parameters vdisk vdisk Name or serial number of the vdisk to create the volume in. For in the vdisk. The default size is either 20% of the volume size or 5.37 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 48
on vdisk VD1, and automatically create an associated 20-GB snap pool: # create master-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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 49
create remote-system username username password password system Parameters username username The name of a user in the remote system. This must be a user with the manage role to remotely configure or provision that system. password password The password for that user. system The network-port IP - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 50
defined in the local system, you can do one of the following: • Use the remote-volume parameter to specify the name or serial number of a replication-prepared volume to use as a secondary volume. If the remote volume is in a remote system, also use the remote-system parameter. If you want to limit - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 51
Serial Number ... vd-1 PrimaryVol 47683.6875MiB SN ... The number of 512-byte blocks would be 47683.6875(MiB) * 2048 = 97656192. In the MSA 1040 system, to create the secondary volume you would run: create volume vdisk vd-1 size 97656192 prepare-replication-volume RepVol Replication - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 52
for the replication volumes: low, medium, or high. remote-system system Optional; required if the remote-vdisk or remote-volume parameter specifies a destination in a remote system. The name or network-port IP address of the remote system. remote-vdisk vdisk Optional. The name or serial number of - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 53
both the snapshot parameter and the nowait parameter. primary-volume The name or serial number of a standard or master volume to use as the primary volume. Example For two systems connected with FC links, set up replication from local standard volume Data to remote vdisk VD1 in remote system System2 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 54
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 54 Alphabetical list of commands - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 55
three volumes to start replicating at the same time, and for those replications to includes the start date. • [count #] Constrains the number of times the task is permitted to run. • [expires run. NOTE: If tasks are scheduled close together, the end of one task may overlap the next task. If this - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 56
Example Create schedule Sched1 that runs Task1 for the first time on March 1, 2012; runs daily between midnight and 1:00 AM; and runs for the last time in the morning of January 1, 2013: # create schedule schedule-specification "start 2012-03-01 00:01, every 1 days, between 12:00 AM and 1:00 AM, - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 57
volume and cannot be mapped. Syntax create snap-pool vdisk vdisk size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] name Parameters vdisk vdisk The name or serial number VD1: # create snap-pool vdisk VD1 size 50GB SP1 Info: The volume was created. (SP1) Success: Command completed successfully. (2012-01-18 12: - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 58
the snap pool. Syntax create snapshots volumes volumes [master-volumes master-volumes] snap-names Parameters volumes volumes A comma-separated list of up to 16 standard or master volumes of which to create snapshots. A standard volume is converted to a master volume before a snapshot is created. For - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 59
can create a task to enable or disable drive spin down; to take a snapshot of a standard or master volume; to reset a snapshot; to copy a standard, master, or snapshot volume to a new standard volume; or to replicate a replication set's primary volume to a remote system. The first time a snapshot - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 60
which to take a snapshot. For a VolumeCopy task, the name or serial number of the standard, master, or snapshot volume to copy. For a ReplicateVolume task, the name or serial number of the primary volume to replicate. For volume syntax, see "Command syntax" (page 20). snapshot-prefix prefix A label - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 61
was created. (2012-01-19 15:46:33) Create task Replicate that replicates primary volume VD1_V2: # create task type ReplicateVolume source-volume VD1_V2 snapshot-prefix VD1_V2 retention-count 4 Replicate Success: Command completed successfully. (Replicate) - The task was created. (2012-01-19 15:46:58 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 62
to the base maximum limit, and you can continue to access existing replication images. After a temporary license is created or a permanent license is installed, the command cannot be re-run. Syntax create temp-license Example Enable licensed features for 60 days in order to try them: # create temp - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 63
interface (the SMU). This is enabled by default. • ftp: FTP interface. • smis: Storage Management Initiative Specification (SMI-S) interface. • snmpuser: Allows an SNMPv3 user to view the SNMP MIB. • snmptarget: Allows an SNMPv3 user to receive SNMP trap notifications. This option requires the trap - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 64
is set to use authentication, this specifies the authentication password. precision # Optional. Sets the number of decimal places (1-10) for display of storage-space sizes. The default is 1. privacy-password encryption-password Optional. For an SNMPv3 user whose privacy-type parameter is set to use - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 65
system information using base 2 in the SMU: # create user base 2 interfaces wbi roles monitor John Enter new password: ******** Re-enter new password: ******** Success: Command completed successfully. (John) - The new user was created. (2012-01-20 15:54:35) Create user MIB that can view the SNMP MIB - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 66
enterprise 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 67
bracket, or backslash; and can have a maximum of 32 bytes. A name that includes a space must be enclosed in double quotes. Example Create the RAID-1 vdisk VD1 using two disks in the first enclosure: # create vdisk level raid1 disks 1.1,1.3 VD1 Success: Command completed successfully. (2012-01-20 09 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 68
] [prepare-replication-volume] name Parameters vdisk vdisk The name or serial number of the vdisk in which to create the volume. For vdisk connected to the controller for this volume: read-write (rw), read-only (ro), or no-access. If no-access is specified, the volume is not mapped. The default - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 69
selected. snap-pool snap-pool Optional. Name or serial number of the snap pool to associate with the new volume. For volume syntax, see "Command syntax" (page 20). volume instead of a standard volume. prepare-replication-volume Optional. Specifies to create a secondary volume for use in a replication - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 70
. For example: for basename vd1_v, if vd1_v0000 and vd1_v0002 exist, the next volumes created will be vd1_v0001 and vd1_v0003. count # The number of volumes to create, from 1 to 128. Volumes will be created up to the maximum number supported per vdisk. size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] Sets - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 71
have to these volumes: read-write (rw), read-only (ro), or no-access. If no-access is specified, the volume is not mapped. The default is read-write. -Port-Identifier Nickname Profile not-mapped all other hosts Standard Volume View [Serial Number (SN) Name (data-0001) ] Mapping: Ports LUN - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 72
SN) Name (vd1_v0000) ] Mapping: Ports LUN Access Host-Port-Identifier Nickname Profile A1 5 read-only all other hosts Standard Volume View [Serial Number (SN) Name (vd1_v0001) ] Mapping: Ports LUN Access Host-Port-Identifier Nickname Profile A1 6 read-only all other hosts Standard - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 73
all snapshots that exist for the master volumes before you can delete the master volumes. Syntax delete all-master-volumes snap-pool volume Parameters snap-pool volume The name or serial number of the snap pool whose master volumes should be deleted. For volume syntax, see "Command syntax" (page 20 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 74
' schedules are also deleted. Syntax delete all-snapshots volume volume [delete-type all-standard-snapshots|all-replication-snapshots |all-snapshot-types] Parameters volume volume The name or serial number of the master volume or snap pool. For volume syntax, see "Command syntax" (page 20). delete - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 75
delete chap-records Description For iSCSI, deletes a specified CHAP record or all CHAP records. This command is permitted whether or not CHAP is enabled. deleted. (2012-01-20 12:40:22) See also • create chap-record • set chap-record • show chap-records • show iscsi-parameters delete chap-records 75 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 76
to delete. For disk syntax, see "Command syntax" (page 20). Example Delete two global spares: # delete global-spare disks 1.1,1.5 Info: Global spare disk 1.1 was deleted. (1.1) Info: Global spare disk 1.5 was deleted. (1.5) Success: Command completed successfully. (2012-01-20 11:32:56) See also - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 77
manually created host or the nickname of a discovered host. If the host is not mapped or has only default nickname of the host. Example Delete the manually created host named MyHost: # delete host Error: The specified host is mapped to one or more volumes so the host was not deleted. (2012-01-18 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 78
are also deleted. NOTE: You must delete all snapshots that exist for the master volume before you can delete it. Syntax delete master-volume volume Parameters volume The name or serial number of the master volume to delete. For volume syntax, see "Command syntax" (page 20). Example Delete master - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 79
system, if you choose to delete the remote system you can safely do so without affecting replications. However, because the remote system's name and IP address will no longer appear in user interfaces, record this information before deleting the remote system so that you can access it at a later - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 80
be run on the primary system. Syntax delete replication-set ID Parameters ID The name or serial number of either the replication set or its primary volume. Example Delete replication set RS1: # delete replication-set RS1 Info: The replication set has been deleted. (RS1) Success: Command completed - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 81
delete schedule Description Deletes a task schedule. If you no longer want a scheduled task to occur, you can delete the schedule. When a volume or snapshot is deleted, its schedules and tasks are also deleted. Syntax delete schedule schedule Parameters schedule The name of the schedule to delete. - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 82
the snap pool before you can delete it. Syntax delete snap-pool snap-pool Parameters snap-pool The name or serial number of the snap pool to delete. For volume syntax, see "Command syntax" (page 20). Example Delete snap pool SP1: # delete snap-pool SP1 Success: Command completed successfully. (SP1 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 83
separated list of the names or serial numbers of the snapshots to delete. For volume syntax, see "Command syntax" (page 20). Example Delete snapshot SS1, which is being used in a replication operation: # delete snapshot delete-priority replicating-snapshot SS1 Success: Command completed successfully - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 84
it was first taken. This command is not allowed for a replication snapshot. Syntax delete snapshot-write-data snapshot Parameters snapshot The name or serial number of the snapshot from which to delete modified data. For volume syntax, see "Command syntax" (page 20). Example Delete only modified - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 85
delete task Description Deletes a task. If the task is scheduled, a confirmation prompt will ask whether you want to delete the task and its schedules. Reply yes to delete both, or no to cancel the command. Syntax delete task task Parameters task The name of the task to delete. Example Delete - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 86
delete user Description Deletes a user account. You can delete any user, including the default users. However, the system requires at least one CLI user with the manage role to exist. When a user is deleted, any sessions associated with that user name are terminated. Syntax delete user [noprompt] - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 87
vdisk if it contains a snap pool that is associated with a master volume on another vdisk. NOTE: If you delete a quarantined vdisk and its missing this parameter is omitted, you must manually reply to the prompt. vdisks A comma-separated list of the names or serial numbers of the vdisks to delete. - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 88
syntax" (page 20). vdisk The name or serial number of the vdisk to delete the spares from. For disk syntax, see "Command syntax" (page 20). Example Delete spare disk 1.5 from vdisk VD1: # delete vdisk-spare disks 1.5 VD1 Info: Vdisk spare disk 1.5 was deleted. (1.5) Success: Command completed - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 89
and its schedules. Syntax delete volumes volumes Parameters volumes A comma-separated list of the names or serial numbers of the volumes to delete. For volume syntax, see "Command syntax" (page 20). Example Delete volumes V1 and V2: # delete volumes V1,V2 Info: Volume V1 was deleted. (V1) (2012 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 90
through use of the trust command. Consult the online troubleshooting guide at http://www.hp.com/support/msa2040/Troubleshooting. Also, see the help for the trust command. To continue operation (that is, not go to quarantined status), a RAID-3 or RAID-5 vdisk can have only one inaccessible disk - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 91
if an associated volume (snap pool, source volume, or destination volume) goes offline. Depending on the operation, the length of the outage, and the settings associated with the operation, the operation may automatically resume when the vdisk is dequarantined or may require manual intervention - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 92
determining that vdisk VD1 is quarantined, remove it from quarantine and re-check its status: # show vdisks Name ... Status VD1 ... QTDN ... (RAID 6 quarantined with a down disk dequarantine vdisk VD1 Info: Vdisk VD1 was dequarantined. (VD1) Success: Command completed successfully. (2013-08-01 14 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 93
communication between other enclosures. Syntax detach replication-volume [set replication-set] replication-volume Parameters set replication-set Optional. The name or serial number of the replication set. replication-volume The name or serial number of the replication volume to detach. If the name - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 94
See also • reattach replication-volume • show replication-sets • show replication-volumes • start vdisk • stop vdisk 94 Alphabetical list of commands - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 95
loss of a disk. This command only applies to disks that are part of fault-tolerant vdisks. CAUTION: Do not use this command in a production system. Use only for testing. This command will interfere with the operation of any volumes in the vdisk, potentially causing data loss. When using this command - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 96
exit Description Log off and exit the CLI session. Syntax exit 96 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 97
the unit is 512-byte blocks. size max Expands the volume to fill available space on the vdisk. snap-pool The name or serial number of the snap pool to expand. For volume syntax, see "Command syntax" (page 20). Example Expand snap pool SP1 by 100 GB: # expand snap-pool size 100GB SP1 Success: Command - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 98
SAS disks, you might have vdisks that contain both types of disks. For those vdisks, you can designate either or both types of disks for expansion. If-through replacement of spares omitted, you must manually reply to the prompt. vdisk The name or serial number of the vdisk to expand. For vdisk syntax - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 99
strongly recommended to review the Best Practices white paper before starting a vdisk expansion. See the online help to access this white paper. Start to expand this vdisk? yes Success: Command completed successfully. - Expansion of vdisk was started. (2012-01-21 12:19:36) Expand RAID-10 vdisk R10 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 100
is 512-byte blocks. size max Expands the volume to fill the available space on the vdisk. volume The name or serial number of the volume to expand. For volume syntax, see "Command syntax" (page 20). Example Expand standard volume V1 by 100 GB: # expand volume size 100GB V1 Success: Command completed - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 101
. set replication-set Optional. The name or serial number of the replication set. replication-snapshot The name or serial number of the replication snapshot to it is mapped. To preserve the exported snapshot's data, create a volume copy of the exported snapshot. Info: The snapshot has been exported. - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 102
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 use this command in a production system. Use only for testing. This command will interfere with the operation of volumes in vdisks owned by the - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 103
the controller host ports and access level that all connected hosts have to the volume, and the LUN presented to all hosts to identify the volume. The default mapping's LUN is known as the volume's default LUN. The map volume command creates mappings with different settings for different hosts - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 104
host to map the volumes to. For iSCSI, the node name (typically the IQN) or nickname of each initiator to map the volumes to. For nickname syntax volumes A comma-separated list of the names or serial numbers of the volumes to map. For volume syntax, see "Command syntax" (page 20). Example Map volume - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 105
6 read-write 207000c0ff001121 Host1 Standard A1,B1 6 read-write 207000c0ff001122 Host2 Standard not-mapped all other hosts Standard Volume View [Serial Number (SN) Name (v2) ] Mapping: Ports LUN Access Host-Port-Identifier Nickname Profile A1,B1 7 read-write 207000c0ff001121 Host1 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 106
A basetype or a list of basetypes separated by commas (with no spaces) to specify the objects for which to show metadata. For names and descriptions of supported basetypes, see "XML API basetype properties" (page 355). Example Show all metadata for objects returned by the show disks command: # meta - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 107
] Parameters host-address The remote host's IP address in dotted decimal form. count Optional. The number of packets to send. The default is 4 packets. Use a small count because the command cannot be interrupted. The default is 4 packets. Example Send two packets to the remote computer at 10.134.50 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 108
set is configured to use, a message will say the reattach operation failed because it could not determine the secondary address. 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 109
See also • detach replication-volume • show replication-sets • show replication-volumes • start vdisk • stop vdisk reattach replication-volume 109 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 110
, quiesce all hosts that have visibility to the volumes whose reservations will be released. Syntax release volume all|volumes Parameters all|volumes Specifies all volumes, or the names or serial numbers of specific volumes. For volume syntax, "Command syntax" (page 20). Example Release reservations - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 111
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 Spin Down Spin Down Delay Health Health Reason Health - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 112
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 only if the replication set has a primary-volume conflict. Name or serial number of - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 113
have a maximum of 32 bytes. A name that includes a space must be enclosed in double quotes. set replication-set Optional. The name or serial number of the replication set. external-snapshot The name or serial number of the external snapshot to use as the data source. If the name is not unique across - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 114
is converted to a replication snapshot. volume The name or serial number of the primary volume to replicate. If the name is not unique across replication sets, specify the set parameter. Example Replicate volume MV1 and name the replication snapshot RepSnap1: # replicate volume snapshot RepSnap1 MV1 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 115
command forces rediscovery of disks and enclosures in the storage system. If both Storage Controllers are online and able to communicate with both expansion modules in each connected enclosure, this command rebuilds the internal SAS layout information, reassigns enclosure IDs based on controller - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 116
. If the historical parameter is specified and the prompt parameter is omitted, you must manually reply to the prompt. If the historical parameter is omitted, the prompt parameter has • reset host-port-statistics • reset vdisk-statistics • reset volume-statistics • show controller-statistics 116 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 117
-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-statistics reset controller-statistics 117 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 118
controllers or by the disk and not categorized as media errors) • Number of block reassignments • Number of bad blocks found To reset other disk statistics, use the reset statistics • reset host-port-statistics • reset vdisk-statistics • reset volume-statistics • show disk-statistics • show disks 118 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 119
-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 reset host-channel-link (Deprecated) Use reset host-link. reset disk-statistics 119 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 120
For an FC host port configured to use FC-AL (loop) topology, a reset issues a loop initialization primitive (LIP). For iSCSI, you can reset a IDs, or a combination of these. A port ID is a controller ID and port number, and is not case sensitive. Do not mix controller IDs in a range. Example Reset - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 121
[ports ports] Parameters ports ports Optional. The controller ID and port number of ports for which to reset statistics. For port syntax, see "Command • reset disk-statistics • reset vdisk-statistics • reset volume-statistics • show host-port-statistics • show ports reset host-port-statistics - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 122
Description Resets the SMI-S configuration files. For use by or with direction from a service technician. This command will reset the configuration of the SMI-S service to default settings. After running this command, any hosts registered via SMI-S will need to be registered again. Messages - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 123
See also • restore defaults reset smis-configuration 123 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 124
replication snapshot. CAUTION: All data represented by the snapshot as it exists prior to issuing this command is lost. Syntax reset snapshot [prompt yes|no] volume you must reply to the prompt. volume The name or serial number of the snapshot to reset. For volume syntax, see "Command syntax" (page - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 125
[vdisks] Parameters vdisks Optional. A comma-separated list of the names or serial numbers of the vdisks for which to reset statistics. For vdisk syntax, see reset disk-statistics • reset host-port-statistics • reset volume-statistics • show vdisk-statistics • show vdisks reset vdisk-statistics 125 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 126
Description Resets performance statistics for all or specified volumes. Syntax reset volume-statistics [volumes] Parameters volumes Optional. A comma-separated list of the names or serial numbers of the volumes for which to reset statistics. For volume syntax, see "Command syntax" (page 20). If this - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 127
and flushing the write cache to disk, and then the Storage Controller restarts. Restarting a Storage Controller restarts the corresponding and configuration information. CAUTION: If you restart both Storage Controllers, both Management Controllers will also be restarted so all hosts and users will - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 128
the specified Storage Controllers restart, communication will temporarily be lost with the corresponding Management Controllers. Restarting both controllers can cause a temporary loss of data availability. Do you want to continue? (y/n) yes Connection closed by foreign host. See also • shutdown 128 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 129
Description Restores the default configuration to the controllers. For use by or with direction from a service technician. For details about which settings are restored see "Settings changed by restore defaults" (page 505). If the system contains only one controller module when the command is - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 130
on the system that owns the secondary volume. Syntax resume replication [set replication-set] replication-volume Parameters set replication-set Optional. The name or serial number of the replication set. replication-volume The name or serial number of the secondary volume. If the name is not unique - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 131
parameter is omitted, you must reply to the prompt. master-volume The name or serial number of the master volume to roll back. For volume syntax, see "Command syntax" (page 20). Example Roll back master volume MV1 to snapshot SS1: # rollback master-volume snapshot SS1 MV1 You MUST unmount the master - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 132
, event 206 is logged. When a vdisk scrub operation ends, event 207 is logged and specifies whether errors were found and whether user action is required. Syntax scrub vdisk vdisks Parameters vdisks A comma-separated list of the names or serial numbers of the vdisks to scrub. For vdisk syntax, see - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 133
24 hours after the manual scrub completes. When a scrub is complete, event 207 is logged and specifies whether errors were found and whether user action is required. Syntax scrub volume volumes Parameters volumes The names or serial numbers of the volumes to scrub. For volume syntax, see "Command - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 134
system configuration parameters spares enabled|disabled|on|off] [emp-poll-rate rate] [fan-failure enabled|disabled|on|off] [host-cache-control enabled|disabled|on|off] [independent-cache on: Auto-write-back is enabled. This is the default. background-disk-scrub enabled|disabled|on|off Optional. Sets - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 135
. This is the default. • enabled or on: Host control of caching is enabled. independent-cache enabled|disabled|on|off Not supported. managed-logs enabled|disabled|on|off Optional. Enables or disables the managed logs feature, which allows log files to be transferred from the storage system to a log - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 136
command is handled. • immediate: Good status is returned immediately and cache content is unchanged. This option is the default. • flush: Good status is returned only after all write-back data for the specified volume is flushed to disk. temperature-exceeded enabled|disabled|on|off Optional. Sets - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 137
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 spares minutes. The default is 15 minutes. single-controller Not supported. auto-stall- firmware upgrade: # set advanced-settings partner-firmware - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 138
See also • scrub vdisk • set spares • show advanced-settings 138 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 139
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 policy automatically changes to write-through when a power supply fails. • disabled or off: The power-supply - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 140
for better data protection. Disable this option to allow the partner to continue using its current caching mode for better performance. • disabled or off: Notification is disabled. This is the default. • enabled or on: Notification is enabled. auto-write-back enabled|disabled|on|off Optional. Sets - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 141
|4MB|8MB|16MB|32MB] volume Parameters write-policy write-back|write-through|wb|wt Optional. Sets the cache write policy, which determines when cached data is written to the disks. The ability to hold data in cache while it is being written to disk can increase storage device speed during sequential - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 142
The name or serial number of the volume to change. For volume syntax, see "Command syntax" (page 20). Example Set the cache policy, optimization mode, and read-ahead size for volume V1: # set cache-parameters write-policy wb optimization standard read-ahead-size stripe V1 Success: Command completed - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 143
IQN format. The name can have a maximum of 223 bytes, including 0-9, lowercase a-z, hyphen, colon, and period. To determine a storage system's IQN, use the show ports command to view an iSCSI port Target ID value. This parameter and mutual-secret must be set together. mutual-secret recipient-secret - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 144
settings are read from the user's account, and can be 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|ipa|json Optional. Sets the output format: • console: Supports - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 145
scripting, disable paging. precision # Optional. Sets the number of decimal places (1-10) for display of storage-space sizes. The default is 1. storage-size-base 2|10 Optional. Alias for base. storage-size-precision # Optional. Alias for precision. storage-size-units auto|MB|GB|TB Optional. Alias - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 146
time manually by specifying a timestamp: set controller-date timestamp timestamp timezone +|-hh[:mm] To configure use year The year as a four-digit number. ntp enabled|disabled|on|off Enables is optional; to specify a negative offset, the '-' is required. The hour value can have one or two digits and - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 147
timestamp timestamp The date and time represented as the number of seconds (not counting leap seconds) that have elapsed since 1970-01-01 00:00:00 UTC. The resulting time will be in UTC, unless you also specify the timezone parameter. Example Manually set the system time and date to 1:45 PM on - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 148
-write-through cache triggers debug messages. Disabled by default. • bkcfg: Internal configuration debug messages. Enabled by default. • cache: Cache debug messages. Enabled by default. • capi: Internal Configuration API debug messages. Enabled by default. • capi2: Internal Configuration API tracing - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 149
user-specified settings. This command sets spin-down parameters for available disks and global spares. To set spin-down parameters for a vdisk, use set vdisk. NOTE: Drive spin down affects disk operations as follows: • Spun-down disks are not polled for SMART events. • Operations requiring default. - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 150
files to managed-logs email notifications that are sent to the log collection system. This option is disabled by default is specified, no other parameters are required and their current values are not changed used as part of an email address, do not include spaces. For example: Storage-1. server - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 151
Example Set the system to send an email from [email protected] to both [email protected] and [email protected] when a non-Informational event occurs, and to send an email with attached logs to [email protected] when logs need to be transferred: # set email-parameters server 10 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 152
location, rack number, and rack position. Set these parameters to values that help you identify and locate the enclosure. These values are used when user 255. enclosure-number The enclosure ID. Example Set parameters for enclosure 1: # set enclosure 1 name Storage-5 location Lab rack-number 9 rack- - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 153
performs fault-isolation analysis of SAS expander PHY statistics. When one or more error counters for a specific PHY exceed the built-in thresholds, the PHY is disabled to maintain storage system operation. While troubleshooting a storage system problem, a service technician can use this command - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 154
with direction from technical support. Syntax set expander-phy [encl enclosure-ID] [wwn enclosure-WWN] controller a|b|both type drive|sc-0| both. type drive|sc-0|sc-1|ingress|egress The PHY type: • drive: PHY connected to a disk drive. • sc-0: PHY in the ingress bus to the local Storage Controller. - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 155
completed successfully. - Enabled PHY 5 on controller b in enclosure 1. (PHY type: drive) (2012-01-21 12:07:50) # show expander-status Encl Ctlr Phy Type Status Elem Status Disabled Reason ... 1 B 5 Drive Enabled-Healthy OK Enabled Success: Command completed successfully. (2012-01 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 156
to designate as spares. For disk syntax, see "Command syntax" (page 20). Example Designate disk 1.5 as a global spare: # set global-spare disks 1.5 Info: Disk 1.5 configured as a Global Spare. Success: Command completed successfully See also • delete all-master-volumes • set spares • show disks 156 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 157
profile of a host entry. This command can also be used to remove a manually created host. If the host is unmapped, it is immediately removed; if the of the host. profile standard|hp-ux Optional. Changes the profile of a host that has a nickname. • standard: Default profile. • hp-ux: The host uses - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 158
host-port parameters for communication with attached hosts. FC and iSCSI ports can be configured. For an FC controller, host ports support use of qualified 8-Gbit/s with a maximum link speed of 8-Gbit/s. For a 1GbE iSCSI controller, host ports support use of qualified 1-Gbit/s SFPs. For a 10GbE - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 159
for XML API format. Suppresses the confirmation prompt, which requires a yes or no response. Specifying this parameter allows the command to proceed without user interaction. ports ports|all Optional. Specific host port numbers or all ports. For port syntax, see "Command syntax" (page 20). prompt - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 160
ports, specify to use IPv6 addressing and change the IP address and default router for port A1: # set host-parameters ports A1 iscsi-ip-version ipv6 ip ::8576:246a default-router ::0a0a:1 WARNING: This change will take effect immediately. Changes may affect access to data. Do you want to continue - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 161
components in the data path. Disabled by default. speed auto|1gbps Not supported. isns enabled|disabled|on|off Enables or disables registration with a specified Internet Storage Name Service server, which provides name-to-IP-address mapping. Disabled by default. isns-ip iSNS-IP Specifies the IP - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 162
of the identification LED on a specified device. LEDs are described in the User Guide. Syntax To set a disk LED: set led disk ID enable|disable|on use with the enclosure parameter. Specifies the I/O module to locate. This affects the unit locator LED on the I/O module and the unit identification LED - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 163
ports. You can manually set static IP values for each controller, or you can specify that IP values should be set automatically for both controllers through communication with a Dynamic Host Configuration Protocol (DHCP) server. Each controller has the following factory-default IP settings: • DHCP - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 164
0000:0000:0000:0000:0000:0000:0A90:3442. ping-broadcast enabled|disabled|on|off Optional. Enables the storage system to respond when a ping to a broadcast address is issued on the system's subnet. The default is Disabled. Example Use DHCP to set network port IP values: # set network-parameters dhcp - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 165
Time Protocol (NTP) parameters for the system. You can manually set system date and time parameters by using the set To specify a positive offset, the '+' is optional; to specify a negative offset, the '-' is required. The hour value can have one or two digits and can omit a leading zero. If the - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 166
interfaces (such as the CLI). A password can be entered as part of the command, or the command prompts you to enter and re-enter the new password. Syntax set password [password password] [user] Parameters password password Optional. Sets a new password for the user. The value is case sensitive and - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 167
requires a full sync to be performed. The default is 0xe000 (57344). queued # Optional. The retention priority 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 168
set prompt Description Sets the prompt for the current CLI session. This setting does not persist beyond the current session. Syntax set prompt prompt Parameters prompt The new prompt, which can include any printable UTF-8 characters except left angle bracket, backslash, and double quote, and can - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 169
remote connection, through incoming ports only, by HP or HP's authorized representatives for troubleshooting. Disabling the service debug protocol removes this access. ftp enabled|disabled|on|off Optional. Enables or disables the expert interface for updating firmware. This is enabled by default - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 170
via HTTP port 8081. This mechanism reports whether a firmware update or partner firmware update operation is active and shows the progress through indication if the operation failed. This is disabled by default. Example Disable unsecure HTTP connections and enable FTP: # set protocols http disabled - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 171
stored in the local system. Do this when the user name or password to access a remote system has been changed in that system. Syntax set remote-system [password password] [username username] system Parameters password password Optional. The new password to access the remote system. The value is - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 172
system, System2. On System1, view the status of replication set RS: # show replication-sets RS Replication Set [Name (RS) Serial Number (SN) ] Primary Volume: Name ... Status ... Location Primary-Volume ... Primary-Volume-Status Data ... Online ... Local Data ... Online rData ... Online - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 173
the system is set to use the new primary volume and that the conflict is resolved: # show replication-sets Replication Set [Name (RS) Serial Number (SN) ] Primary Volume: Name ... Status ... Location Primary-Volume ... Primary-Volume-Status Data ... Online ... Local rData ... Online rData - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 174
See also • show replication-sets • show replication-volumes • show snapshots • unmap volume 174 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 175
=IPs|wwnn=WWNNs|wwpn=WWPNs] [set replication-set] replication-volume Parameters link-type FC|iSCSI Optional. Specifies the type of ports being used for the inter-system link: • FC: FC ports. • iSCSI: iSCSI ports. max-queue # Optional. The number of replication images to consider when determining the - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 176
for example: ip=10.134.2.1,10.134.2.2. set replication-set Optional. The name or serial number of the replication set. replication-volume The name or serial number of the replication volume. If the name is not unique within the replication set, the local volume is assumed. If the name is not unique - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 177
three volumes to start replicating at the same time, and for those replications to recur no includes the start date. • [count #] Constrains the number of times the task is permitted to run. • [ run. NOTE: If tasks are scheduled close together, the end of one task may overlap the next task. If this - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 178
Example Change parameters, including the associated task, for schedule Sched1: # set schedule schedule-specification "start 2011-01-01 00:01 every 1 days expires 2011-12-31 00:01" task-name Task1 Sched1 Success: Command completed successfully. (Sched1) - The schedule was modified. (2011-10-14 08:28: - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 179
pool's default error policy is autoexpand and default critical policy amount by which the snap pool will be automatically expanded when the threshold level is reached. The value uses pool Name or serial number of the snap pool to set the policy for. For volume syntax, see "Command syntax" (page 20 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 180
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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 181
pool space used that triggers the error threshold policy. This value must be less than 98%. The default is 90%. snap-pool Name or serial number of the snap pool to set the threshold for. For volume syntax, see "Command syntax" (page 20). Example Set the warning and error thresholds for snap pool SP1 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 182
set snmp-parameters Description Sets SNMP parameters for event notification. To enable or disable SNMP requests to the MIB use the set protocols command. Syntax set snmp-parameters [enable crit|error|warn|info|none] [add-trap-host address] [del-trap-host address] [trap-host-list trap-host-list] [ - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 183
disks disks [vdisk vdisk] Parameters disks disks IDs of the disks to designate as spares. For disk syntax, see "Command syntax" (page 20). vdisk vdisk Optional. Name or serial number of the vdisk to assign spares to. For vdisk syntax, see "Command syntax" (page 20). If this parameter is omitted - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 184
|warn|info|none [host-ip IP-address] [host-port port-number] Parameters notification-level crit|error|warn|info|none The minimum severity is other than none, host-ip must be specified. host-port port-number Optional. A specific port number on the host. Example Set the system to send an entry to the - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 185
name, location, and contact are included in event notifications. All four values are included in system debug logs for reference by service personnel. location value Optional. The location of the system. info value Optional. A brief description of what the system is used for or how it is configured - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 186
[dest-prefix prefix] [modified-snapshot yes|no] [replication-mode new-snapshot|last-snapshot] name Parameters snapshot-prefix serial number of the destination vdisk for the volume copy. For vdisk syntax, see "Command syntax" (page 20). dest-prefix prefix Optional. A label to identify the volume - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 187
was modified.(2012-01-21 12:37:52) Change parameters for a ReplicateVolume-type task named Replicate: # set task 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 188
parameter requires the password parameter and, for the snmptarget interface, the trap-host parameter. • MD5: MD5 authentication. This is the default. • SHA: SHA (Secure Hash Algorithm) authentication. • none: No authentication. base 2|10 Optional. Sets the base for entry and display of storage-space - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 189
rules, see "Command syntax" (page 20). precision # Optional. Sets the number of decimal places (1-10) for display of storage-space sizes. The default is 1. privacy-password encryption-password Optional. For an SNMPv3 user whose privacy-type parameter is set to use encryption, this specifies the - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 190
type novice|standard|advanced|diagnostic Optional. Identifies the user's experience level. This parameter is informational only and does not affect access to commands. The default is standard. units auto|MB|GB|TB Optional. Sets the unit for display of storage-space sizes: • auto: Sizes are shown in - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 191
successfully. (2013-11-14 12:05:32) For the only CLI user with the manage role, try to reduce the role to monitor: # set user SysAdmin roles monitor Error: At least one CLI user must retain configuration privileges at all times. (2013-10-31 14:10:47) See also • set password • show users set user 191 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 192
delay to 0 will disable spin down. NOTE: Drive spin down affects disk operations as follows: • Spun-down disks are not polled for SMART events. • Operations requiring access to disks may be delayed while the disks are spinning back up. vdisk Name or serial number of the vdisk to change. For vdisk - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 193
disk syntax, see "Command syntax" (page 20). vdisks Name or serial number of the vdisk to assign spares to. For disk syntax, see "Command syntax" (page 20). Example Designate disk 1.5 as a spare for vdisk VD1: # set vdisk-spare disks 1.5 VD1 Info: Disk 1.5 added to VD1. Success: Command completed - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 194
use the "map volume" (page 103). identifying-information description Optional. A description of the volume to help a host-side user identify it. volume The name or serial number of the volume to change. For volume syntax, see "Command syntax" (page 20). Example Rename volume V1 to V2: # set volume - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 195
to the system. Dynamic Spare Configuration Shows whether the storage system will automatically use a compatible disk as a spare to replace a failed disk in a vdisk if no compatible spare is available. • Disabled: The dynamic spares feature is disabled. This is the default. • Enabled: The dynamic - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 196
-back data for the specified volume is flushed to disk. Independent Cache Performance Mode Not supported. Missing LUN Response Shows whether Sense data returned is sensekey = 2, code = 4, qualifier = 3. This is the default. • Illegal Request: Sends a reply that there is a LUN but that the request - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 197
whether the cache mode will change from write-through to write-back when the trigger condition is cleared. • Disabled: Auto-write-back is disabled. • Enabled: Auto-write-back is enabled. This is the default. Drive Spin Down Non-Vdisk Enable Shows whether available disks and global spares will spin - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 198
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 Auto Write Back: Enabled Drive Spin Down Non-Vdisk Enable: Enabled Drive Spin Down Non-Vdisk - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 199
a trigger condition occurs and the trigger is enabled, the RAID controller cache mode changes from write-back to write-through. Syntax show • Disabled: The over-temperature failure trigger is disabled. This is the default. • Enabled: The over-temperature failure trigger is enabled. Partner Notify - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 200
Example Show the system's auto-write-through trigger settings: # show auto-write-through-trigger Auto Write-Through Triggers Controller Failure: Disabled Supercap Failure: Enabled CompactFlash Failure: Enabled Power Supply Failure: Disabled Fan Failure: Disabled Temperature Exceeded: Disabled - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 201
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 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 202
Volume cache parameters: Serial Number If a volume is specified, its serial number. Name If a volume is specified, its name. Cache Write Policy If a volume is specified, its cache write policy: • write-back: Write-back caching does not wait for data to be completely written to disk before signaling - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 203
: Enabled CompactFlash Status: Installed CompactFlash Health: OK Cache Flush: Enabled Controller B Cache Parameters Write Back Status: Enabled CompactFlash Status: Installed CompactFlash Health: OK Cache Flush: Enabled Volume Cache Parameters Serial Number: SN Name: V1 Cache Write Policy: write - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 204
of the system's security certificate. Syntax show certificate Output Certificate Status • Default: No customer-supplied or alternate certificate has been installed. • Customer-supplied: A custom or alternate certificate has been installed. Time Created Date and time in the format year-month-day hour - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 205
show chap-records Description For iSCSI, shows all CHAP records or the record for a specific myhost.domain Mutual CHAP Name: iqn.1995-03.com.acme:01.storage.00c0ffd6000a Success: Command completed successfully. (2013-10-09 14:31:50) As a user with the manage role, show the CHAP record for a specific - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 206
and display of storage-space sizes: • 2: Sizes are shown as powers of 2, using 1024 as a divisor for each magnitude. • 10: Sizes are shown as powers of 10, using 1000 as a divisor for each magnitude. This is the default. Operating systems usually show volume size in base 2. Disk drives usually show - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 207
Temperature Scale • Fahrenheit: Temperatures are shown in degrees Fahrenheit. • Celsius: Temperatures are shown in degrees Celsius. This is the default. Example Show current CLI settings: # show cli-parameters CLI Parameters Timeout: 1800 Output Format: Console Brief Mode: Disabled Base: 10 Pager: - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 208
command. Syntax show configuration Output • System information from show system • Controller information from show controllers • Controller firmware and hardware version show frus Basetypes • system • controllers • versions • port • drives • enclosure-list • virtual-disks • enclosures • status 208 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 209
show controller-date Description Shows the system's current date and time. Syntax show controller-date Output Controller Date Date and time in the format year-month-day hour:minutes:seconds. Time-Zone Offset The system's time zone as an offset in hours and minutes from Coordinated Universal Time ( - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 210
Serial Number • Serial number of the controller module. • Not Available: The controller module is down or not installed. Hardware Version Controller module hardware version. CPLD Version Complex Programmable Logic Device firmware version. MAC Address Controller network port MAC address. WWNN Storage - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 211
disabling of SAS expander PHYs default. • Disabled: PHY fault isolation is disabled. Controller Redundancy Mode Shows the system's operating mode, also called the cache redundancy mode: • Active-Active ULP: Both controllers are active using ULP (Unified LUN Presentation). Data for volumes configured - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 212
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 (MB): 4096 Host Ports: 4 Disk Channels: 2 Disk Bus Type: SAS show configuration • show frus 212 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 213
100. Power On Time (Secs) Number of seconds since the controller was restarted or reset since a controller restart. IOPS Input/output operations per second, calculated user or by a controller restart. Total Power On Hours The total amount of hours the controller has been powered on in its life - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 214
statistics a Durable ID CPU Load Power On Time (Secs) Bytes per second IOPS Number of Reads Number of Writes Data Read Data Written Num Forwarded Cmds Reset Time Total Power -statistics • show disk-statistics • show host-port-statistics • show vdisk-statistics • show volume-statistics 214 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 215
Disabled by default. • raid: RAID debug messages. Enabled by default. • cache: Cache debug 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 216
after which available disks and 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 217
disk slot, whether it contains a disk or not. Do not specify this parameter with other parameters; they will be ignored. Output Without the encl parameter: Location Disk's enclosure ID and slot number Serial Number Disk serial number Vendor Disk vendor Rev Firmware revision number show disks 217 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 218
spare • LEFTOVR: Leftover • VDISK: Used in a vdisk • VDISK SP: Spare expanded. • INIT: The vdisk is being initialized. • RCON: The vdisk is being reconstructed. • VRFY: The vdisk is being verified. • VRSC: The vdisk is being scrubbed. Type • SAS: Enterprise SAS • SAS MDL: Midline SAS the connected - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 219
issue. With the temp parameter: Location Disk's enclosure ID and slot number Temp Temperature of the disk. Temperature expander. • Spun Down: The disk is present and has been spun down by the drive spin down feature. • Warning: The disk is present but the system is having communication problems - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 220
size Example Show information for all installed disks: # show disks Location Serial Number Vendor Rev How Used Type Job% Speed (kr/min) Size Rate*(Gbit/s) SP Recon State Copyback State Life Remaining% Health Health Reason Health Recommendation 1.1 SN vendor A360 VDISK SAS 10 600.1GB - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 221
information for all installed disks: # show disks temp Location Temperature Temperature Status 1.1 33 C OK ... Info: * Rates may vary. This is normal behavior. (2013-11-20 14:59:11) Success: Command completed successfully. (2013-11-20 14:59:11) Basetypes • drives • enclosure-list - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 222
range, the samples' values will be aggregated to show the required number of samples. Statistics shown only in XML API output are described the start time and the latest sample taken before the end time. If the specified start date/time is earlier default set of performance metrics will be shown. 222 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 223
:seconds, when these statistics were last 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 serial number. Total I/Os Total number of read and write operations since the last sampling time - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 224
parameter. Average number of pending read and write operations being serviced since the last by the storage system, or by the disk and not categorized as media errors); number of bad- statistics 1.1,2.1 Durable ID Serial Number Bytes per second IOPS Number of Reads Number of Writes Data Read - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 225
start 2011-12-05 4:40 PM end 2011-12-05 5:00 PM" Durable ID Serial Number disk_1.5 SN Total I/Os Data Transferred Total IOPS Total B/s I/O Resp Time Sample port-statistics • show vdisk-statistics • show volume-statistics show drive-parameters (Deprecated) Use show disk-parameters. show - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 226
"from" address for remote notification. Include Logs Shows whether system log files will automatically be attached to email notification messages generated by the managed logs push" mode for managed logs. This option is disabled by default. Example Show settings for email notification: # show email- - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 227
See also • set email-parameters show email-parameters 227 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 228
ID 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 1040 SFF chassis) • 2U24-6G: Midplane for 2U, 24 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 229
Example Show information for a system containing one 2U24 enclosure: # show enclosures Encl Encl WWN Name Location Rack Pos Vendor Model EMP A CH:ID Rev EMP B CH:ID Rev Midplane Type Health Health Reason Health Recommendation 1 WWN Controller Lab 0 4 vendor model 01: - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 230
in the storage system. A separate set of event numbers is maintained for each controller. Each event number is problems" in the Event Descriptions Reference Guide. To access HP's Guided Troubleshooting website, see http://www.hp.com/support/msa2040/Troubleshooting. Syntax To show a certain number - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 231
may affect system stability but not data integrity. Evaluate the problem and correct it if necessary. • INFORMATIONAL: A configuration or state change occurred, or a problem occurred that the system corrected. No action is required. • Event-specific message giving details about the event Example - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 232
the SAS expander. Ctlr I/O module that contains the SAS expander. Phy Identifies a PHY's logical location within a group based on the PHY type. Logical IDs are 0-23 for drive PHYs; 0-1 for SC PHYs; and 0-3 for other PHYs. If the PHY's controller module or expansion module is not installed, this - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 233
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 drive slot is empty. • Unused - disabled by default: PHY is disabled by default because it is not used. • Excessive - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 234
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 1040 drive enclosure; Fan fan-unit-ID for a D2700 enclosure. The position is as viewed from the back of the enclosure. Location Fan location in the form - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 235
Example Show fan information for a single-enclosure system: # show fans Name Location Status Speed Position Serial Number Firmware Version Hardware Version Health Health Reason Health Recommendation Fan Loc:left-PSU 0 Enclosure 0 - Left Up 4959 Left OK Fan Loc:right-PSU 1 Enclosure 0 - - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 236
storage system. Some information is for use by service technicians. Syntax show frus Output SKU fields: Part Number System part number Serial Number System serial number (also shown by Configuration (global manufacturing code) of the manufacturer FRU Location Location of the FRU in the enclosure: • - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 237
--Name: CHASSIS_MIDPLANE Description: value Part Number: value Serial Number: value 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 238
WWPN. • For iSCSI: iSCSI host initiator's node name (typically the IQN). Name Host port nickname. Mapping information: Profile • Standard: Default profile. • HP-UX: The host uses Flat Space Addressing. Name Name of the volume seen by the host. Serial Number Serial number of the volume seen by the - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 239
Basetypes • host-view • status See also • show hosts • show volume-maps • show volumes show host-maps 239 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 240
Controller ID and port number Media • FC(L): Fibre 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, 8Gb, 4Gb, or 2Gb (Gbit/s) • iSCSI - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 241
the detail parameter is specified, this field shows the SFP part number. Supported Speeds FC only. If the detail parameter is specified, this field shows the link speeds that the SFP supports. 10G Compliance iSCSI only. If the detail parameter is specified, this field shows the SFP's 10G compliance - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 242
port is intentionally unused, no action 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 243
Recommendation ID iSCSI IQN Up 1Gb Auto OK Port Details -----------IP Version: IPv6 IP Address: fe80::a:b Default Router: fe80::1 Link-Local Address: fe80::2c0:ffff:feff:f645 MAC: 00:C0:FF:FF:F6:45 SFP Status: OK Part Number: ABCU-5700RZ 10G Compliance: No Support Ethernet Compliance - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 244
host and a volume. For example, each time a host writes to a volume's cache, the host requested or reset since a controller restart. IOPS Input/output operations per second, calculated over . Queue Depth Number of pending I/O operations being serviced. I/O Resp user or by a controller restart. 244 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 245
show host-port-statistics Durable ID Bytes per second IOPS Number of Reads Number of Writes Data Read Data Written Queue Depth I/O statistics • show disk-statistics • show ports • show vdisk-statistics • show volume-statistics show host-wwn-names (Deprecated) Use show hosts. show host-wwn-names - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 246
in the storage system. volumes are explicitly mapped to the host. Profile • Standard: Default profile. • HP-UX: The host uses Flat Space Addressing. Host Type • If the host was discovered and its entry was automatically created, its host-interface type: FC; iSCSI. • If the host entry was manually - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 247
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 inquiry Product Information Vendor Name - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 248
or disabled. • Enabled: Jumbo-frame support is enabled. • Disabled: Jumbo-frame support is disabled. This is the default. iSNS Shows whether support for Internet Storage Name Service (iSNS) is enabled or disabled. • Enabled: iSNS support is enabled. • Disabled: iSNS support is disabled. This is the - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 249
:0000 iSNS Alt IP: 0000:0000:0000:0000:0000:0000:0000:0003 iSCSI Speed: auto iSCSI IP Version: 6 Success: Command completed successfully. (2013-06-24 04:40:49) Basetypes • iscsi-parameters • status See also • set iscsi-parameters show job-parameters (Deprecated) Use show advanced-settings. show job - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 250
or disabled. Replication Expires • Never. License is purchased and doesn't expire. • Number of days remaining for a temporary license. • Expired. Temporary license has expired and cannot be renewed. • N/A. No license installed. VDS Shows whether the VDS (Virtual Disk Service) Hardware Provider - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 251
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 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 252
controller are shown. snap-pool volume Optional. Only includes master volumes associated with the specified snap pool name or serial number. For volume syntax, see "Command syntax" (page 20). Output Vdisk Vdisk name Serial Number Master volume serial number Name Master volume name Size Total size of - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 253
Show information about all master volumes: # show master-volumes Vdisk Serial Number Name Size Status Status- volumes • status See also • convert master-to-std • create master-volume • delete all-master-volumes • delete master-volume • expand volume • rollback master-volume show master-volumes - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 254
mask MAC Address Controller's unique Media Access Control address Addressing Mode • Manual: Network settings set manually (statically) • DHCP: DHCP used to set network parameters Health The health of the network connection. • OK • Degraded • N/A • Unknown Health Reason If Health is not OK, this - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 255
Show network parameters for a storage system using manual addressing: # show network-parameters Network Parameters Controller A IP Address: 172.22.1.200 Gateway: 172.22.1.1 Subnet Mask: 255.255.255.0 MAC Address: value Addressing Mode: Manual ... Network Parameters Controller B IP Address: 172.22 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 256
show ntp-status Description Shows the status of the use of Network Time Protocol (NTP) in the system. Syntax show ntp-status Output NTP Status • activated: NTP is enabled • deactivated: NTP is disabled NTP Server Address • The current NTP server IP address if NTP is enabled. • The last-set NTP - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 257
Controller ID and port number Media • FC(P): Fibre 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, 8Gb, 4Gb, or 2Gb (Gbit/s) • iSCSI - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 258
the detail parameter is specified, this field shows the SFP part number. Supported Speeds FC only. If the detail parameter is specified, this field shows the link speeds that the SFP supports. 10G Compliance iSCSI only. If the detail parameter is specified, this field shows the SFP's 10G compliance - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 259
port is intentionally unused, no action 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 260
Recommendation ID iSCSI IQN Up 1Gb Auto OK Port Details -----------IP Version: IPv6 IP Address: fe80::a:b Default Router: fe80::1 Link-Local Address: fe80::2c0:ffff:feff:f645 MAC: 00:C0:FF:FF:F6:45 SFP Status: OK Part Number: ABCU-5700RZ 10G Compliance: No Support Ethernet Compliance - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 261
supplies Description Shows information about each power supply in the storage system. Syntax show power-supplies Output Encl Enclosure ID Serial Number Power supply serial number Name • Power supply identifier and location • Voltage Regulator (D2700 only) Health • OK • Degraded • Fault • Unknown - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 262
Standard Snapshot 0x6000 (default) Volume Copy Snapshot 0xa000 (default) Replication Snapshot 0x4000 (default) Replicating Snapshot 0xc000 (default) Common Sync Point Snapshot 0x8000 (default) Only Sync Point Snapshot 0xe000 (default) Queued Snapshot 0x2000 (default) DRM Snapshot - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 263
Telnet debug port is enabled or disabled. The default is Disabled. When the service debug protocol is enabled, remote connection is allowed, through incoming ports only, by HP or HP's authorized representatives for troubleshooting. Disabling the service debug protocol removes this access. In-band - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 264
Command Line Interface (SSH): Enabled Storage Management Initiative Specification (SMI-S): Enabled Unsecure Storage Management Initiative Specification (SMI-S 5988): Disabled File Transfer Protocol (FTP): Disabled Simple Network Management Protocol (SNMP): Enabled Service Debug (Debug): Disabled In - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 265
the OS level, a certain device node (target) looks "slow" relative to the rest of the targets. You can correlate the OS device node to the volume WWN (or LUN), and then use the command output to find the associated controller and disks. Syntax show provisioning [disks disks | luns LUNs | ports ports - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 266
. • read-only: The host has read access to the volume. • no-access: The host is denied access to the volume. • not-mapped: The host is not mapped to the volume. Host-Port-Identifier • FC: Host WWPN • all other hosts for the volume's default mapping Nickname Host nickname, or blank if not set or for - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 267
other hosts Success: Command completed successfully. (2013-10-04 13:46:42) Show provisioning for all unhealthy vdisks: # show provisioning unhealthy Volume WWN Ctlr Disks Vdisk Health Mapped myVol9 WWN B 1.15,1.17-18 myR10 Degraded No myVol10 WWN B 1.15,1.17-18 myR10 Degraded No - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 268
Presentation). Data for volumes configured to use write-back cache is automatically mirrored between installed but not operational. • Not Installed: The controller is not installed. Controller ID Serial Number • Controller module serial number • Not Available: The controller is down or not installed - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 269
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 Number: Not Available Other MC Status: Not Communicating Success: Command completed successfully. (2011-09 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 270
format only, shows when the data represented by the basetype was last updated. The value 0 means the data has never been updated and is not cached. A value other than 0 is a timestamp indicating that the data has been updated. If the value has changed since the last time you called this command - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 271
Location The location of Product Brand 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 user - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 272
System Contact: J. Smith System Location: Denver lab System Information: Uninitialized Info Vendor Name: vendor Product ID: product Product Brand: brand IP Address Controller A: 10.122.1.21 IP Address Controller B: 10.122.1.22 Username: manage Status: Connected Last Connected: 2012-01-18 12:58 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 273
number. Type Replication volume type: • Primary Volume: The volume is the primary volume in a replication set. • Secondary Volume: The volume is the secondary volume in a replication set. Replication volume image information: Image Serial Number Replication image serial number. Image Name User - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 274
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 Image Serial Number Image Name Snapshot Serial Snapshot Name Creation Date/Time SN vd01_v001_i01 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 275
See also • show replication-sets • show replication-volumes show replication-images 275 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 276
set information: Name Replication set name. Serial Number Replication set serial number. Replication volume information: Name Replication volume name. Serial Number Replication volume serial number. Status Replication volume status: • Initializing: The initial (full) replication to the volume is in - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 277
Primary-Volume-Serial Primary volume serial number. If the replication set has a primary-volume conflict, all associated primary volumes are displayed. Primary-Volume-Status Primary volume status: Online, Offline, Conflict, or N/A. MaxQueue Number of replication images to consider when determining - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 278
-sets Replication Set [Name (rsvd01_v001) Serial Number (SN) ] Primary Volume: Name Serial Number Status Status-Reason Monitor Location Primary-Volume Primary-Volume-Serial Primary-Volume-Status MaxQueue MaxRetryTime On Error Link Type On Collision Monitor Interval Priority Connection Status - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 279
Replication Set [Name (rsData) Serial Number (SN) ] Primary Volume: Name Serial Number Status Status-Reason Monitor Location Primary-Volume Primary-Volume-Serial Primary-Volume-Status MaxQueue MaxRetryTime On Error Link Type On Collision Monitor Interval Priority Connection Status Connection - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 280
remote volume has gone offline. Location Replication volume location: Local or Remote. Primary-Volume Primary volume name. If the replication set has a primary-volume conflict, all associated primary volumes are displayed. Primary-Volume-Serial Primary volume serial number. If the replication set - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 281
by the MaxRetryTime value. This is the default. • Suspend: Suspend the replication until the error is resolved automatically or through user intervention. Link Type Type of ports used to link the primary and secondary volumes: • FC: FC ports. • iSCSI: iSCSI ports. On Collision Collision policy used - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 282
about all replication volumes: # show replication-volumes Name Serial Number Status Status-Reason Monitor Location Primary-Volume Primary-Volume-Serial Primary-Volume-Status MaxQueue MaxRetryTime On Error Link Type On Collision Monitor Interval Priority Connection Status Connection Time - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 283
-health Description Shows the condition of SAS expansion-port connections. NOTE: SAS link health is not supported for D2700 enclosures. Syntax show sas-link-health Output Encl Enclosure ID Ctlr ID of the controller module or expansion module Name • Out Port: Egress (expansion) port in a controller - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 284
N/A No drive enclosure is connected to this expansion port. This is normal if this is the last (or only) enclosure in the cabling sequence of the system. - No action is required. 2 B In Port Up OK Success: Command completed successfully. (2012-01-19 10:10:13) Basetypes • expander-ports - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 285
Type: TakeSnapshot Status: Ready Task State: Start Error Message: Task Details -----------Source Volume: V1 Source Volume Serial: SN Prefix: V1 Count: 1 Last Created: V1_S0001 Snapshot Name Snapshot Serial V1_S0001 SN Success: Command completed successfully. (2012-01-19 17:08:43) Basetypes - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 286
Error Message: Tasks ----Task Name: V1_task001 Task Type: VolumeCopy Status: Ready Task State: Start Error Message: Task Details -----------Source Volume: V1 Source Volume Serial: SN Destination Vdisk: vd3 Destination Vdisk Serial: SN Prefix: V3 Modified Data: preserved Last Created: V3_V0001 286 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 287
Type: TakeSnapshot Status: Ready Task State: Start Error Message: Task Details -----------Source Volume: V1 Source Volume Serial: SN Prefix: V1 Count: 1 Last Created: V1_S0001 Snapshot Name Snapshot Serial V1_S0001 SN Success: Command completed successfully. (2012-01-19 17:08:43) Basetypes - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 288
in the User Guide. Syntax show sensor-status Output Encl Enclosure number. Sensor Name Sensor name and location. Value but status is not available. • Not Installed: The sensor is not present. • that includes a controller enclosure and a D2700 drive enclosure: # show sensor-status Encl Sensor - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 289
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 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 290
-status Description Shows whether each Storage Controller is active or shut down. Syntax show shutdown-status Output Controller A • up (active) • down (shut down or killed) • not installed Controller B • up (active) • down (shut down or killed) • not installed Other MC Status The operational status - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 291
cache mode than in write-back cache Serial Number Snap pool serial number Name Snap pool name Size Total size of the snap pool volume Free (size) Amount of free space available in this snap pool Master Volumes Number of master volumes associated with this snap pool Snapshots Number . The default is 90 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 292
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 Threshold %Usage Policy SizeToExpand Warning 75% Notify Only N/A Error 90% Auto Expand 9999.9MB Critical 98% Delete Snapshots - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 293
. Shows snapshots associated with the specified snap pool name or serial number. For volume syntax, see "Command syntax" (page 20). type standard|replication|all Optional. Shows only standard (non-replication) snapshots, only replication snapshots, or snapshots of all types. If this parameter is - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 294
retention priority for the snapshot type User Priority User-defined retention priority for the snapshot type Type • Standard snapshot: Snapshot of a master volume. • Standard snapshot(DRM): A temporary standard snapshot created from a replication snapshot for the purpose of doing a test failover - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 295
Vdisk Serial Number Name Creation Date/Time Status Status-Reason Source Volume Snap-pool Name Snap Data Unique Data Shared Data Priority User Priority Type vd01 SN vd01_v003_i02 2012-01-19 12:51:18 Available N/A vd01_v003 spvd01_v003 1075.1MB 1075.1MB 0B 0xc000 0x0000 Replication - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 296
address of each trap host SNMP read community The community string for read-only access. The value is obscured for users having only the monitor role and is shown in clear text for users having the manage role. SNMP write community The community string for write access. The value is obscured for - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 297
show syslog-parameters Description Shows syslog notification parameters for events and managed logs. Syntax show syslog-parameters Output Syslog Host IP The IP address of the remote syslog server to use for the notifications. Syslog Notification Level Shows the minimum severity for which the system - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 298
system. The default is Uninitialized Location. System Information A brief description of what the system is used for or how it is configured. The default is Uninitialized Info. Midplane Serial Number The serial number of the controller enclosure midplane. Vendor Name The vendor name. Product ID The - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 299
partner firmware update is running on the system, or is idle. Supported Locales Supported display languages Storage-1 System Contact: J. Smith System Location: Main lab System Information: Used for order processing data Midplane Serial Number: SN Vendor Name: vendor Product ID: product Product - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 300
is degraded because of a problem with a vdisk: # show system System Information System Name: Storage-2 System Contact: J. Smith System Location: Main lab System Information: Used for testing Midplane Serial Number: SN Vendor Name: vendor Product ID: product Product Brand: brand SCSI Vendor ID - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 301
Number of LUNs that the system supports Maximum Vdisks Per Controller Number of vdisks that each controller supports Local Controller ID of the controller you are accessing Serial Number Last six digits of the midplane serial number. Example Show settings and configuration limits for the storage - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 302
• ResetSnap • RenameSnap Error Message Message if an error occurred while processing the task, or blank Source Volume Standard or master volume name Source Volume Serial Volume serial number Prefix Label that identifies snapshots created by this task. Snapshot names have the format prefix_s#, where - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 303
Error Message Message if an error occurred while processing the task, or blank Snapshot Name Name of the snapshot to reset Snapshot Serial Number Serial number of the snapshot to reset For a VolumeCopy task: Task Name Task name Task Type VolumeCopy Status • Uninitialized: Task is not yet ready - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 304
occurred while processing the task, or blank Source Volume Name of the volume to be copied Source Volume Serial Serial number of the volume to be copied Destination Vdisk Name of the destination vdisk Destination Vdisk Serial Serial number of the destination vdisk Prefix Label that identifies copies - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 305
if an error occurred while processing the task, or blank Primary Volume Name Name of the volume to replicate Primary Volume Serial Number Serial number of the volume to replicate Prefix Label that identifies copies created by this task. Volume names have the format prefix_s#, where # starts at 001 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 306
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 Success: Command completed successfully. (2012-01-19 15:28:33) Basetypes - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 307
• ResetSnap • RenameSnap Error Message Message if an error occurred while processing the task, or blank Source Volume Standard or master volume name Source Volume Serial Volume serial number Prefix Label that identifies snapshots created by this task. Snapshot names have the format prefix_s#, where - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 308
Error Message Message if an error occurred while processing the task, or blank Snapshot Name Name of the snapshot to reset Snapshot Serial Number Serial number of the snapshot to reset For a VolumeCopy task: Task Name Task name Task Type VolumeCopy Status • Uninitialized: Task is not yet ready - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 309
Error Message Message if an error occurred while processing the task, or blank Primary Volume Name of the volume to replicate Primary Volume Serial Number Serial number of the volume to replicate Prefix Label that identifies snapshots created by this task. Snapshot names have the format prefix_s - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 310
the most recent existing snapshot of the primary volume. Last Created Name of the last volume created by the task, or blank Last Used Snapshot For a task whose replication mode is last-snapshot, the name of the last snapshot used for replication; or N/A For an EnableDSD task: Task Name Task - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 311
-----------Snapshot Name: VD1_V1_S0001 Snapshot Serial Number: SN Task Name: Copy Task Type: VolumeCopy Status: Ready Task State: Start Error Message: Task Details -----------Source Volume: VD1_V1 Source Volume Serial: SN Destination Vdisk: VD2 Destination Vdisk Serial: SN Prefix: C Modified Data - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 312
Name: Replicate Task Type: ReplicateVolume Status: Ready Task State: Start Error Message: Task Details -----------Primary Volume Name: VD1_V2 Primary Volume Serial Number: SN Prefix: VD1_V2 Mode: new-snapshot Count: 1 Last Created: MV_S0001 Last Used Snapshot: N/A Snapshot Name Snapshot Serial - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 313
the data is needed, the volume's disks must be brought online. If the data is not needed it can be cleared, in which case it will be lost and data will differ between the host and disk. Syntax show unwritable-cache Example Show the percentage of unwritable cache data in each controller: # show - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 314
user accounts. Syntax show users [user] [show-snmp-password] Parameters user Optional. User name to show settings for. show-snmp-password Optional. Minimum role: manage. For SNMPv3 users, this parameter shows Password and Privacy Password values in clear text for reference when configuring users - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 315
Standard. • none: No encryption. This is the default. Password User password. For a standard user the password is represented by eight asterisks. For an SNMPv3 user this is the authentication password. Privacy Password Encryption password for an SNMPv3 user whose privacy type is set to DES or AES - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 316
Basetypes • users • status See also • create user • delete user • set user 316 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 317
A comma-separated list of the names or serial numbers of the vdisks to show information about. 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 318
with multiple inaccessible disks causing user data to be incomplete, or is an NRAID or RAID-0 vdisk. • STOP: completed) Serial Number Vdisk serial number Drive Spin Down • Disabled: DSD is disabled for the vdisk. This is the default. spares automatically spin down, from 1-360 minutes. The value 0 means spin - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 319
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 Health Recommendation VD1 2398.0GB 100.0GB A A RAID6 6 0 512k FTOL SN - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 320
time range, the samples' values will be aggregated to show the required number of samples. For each vdisk these statistics quantify destages, read-aheads, and host reads that are cache misses. For example, each time data is written from a volume's cache to disks in the vdisk that contains the - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 321
latest sample taken before the end time. If the specified default set of performance metrics will be shown. Output Name (Live) Vdisk name. Serial Number Vdisk serial number user or by a controller restart. Output Name (Historical) Vdisk name. Serial Number Vdisk serial number. show vdisk- - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 322
the data sample was taken. Example Show 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 323
-statistics VD2 historical time-range "start 2013-01-18 4:40 PM end 2013-01-18 5:00 PM" Name Serial Number VD2 SN Data Transferred Total B/s Sample Time 30.5GB 33.9MB 2012 • show host-port-statistics • show vdisks • show volume-statistics show versions See versions. show versions 323 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 324
copy operations are shown. Output VC Volume Name Destination volume name Serial Number Destination volume serial number Vdisk Destination vdisk name Source Volume Source volume name Progress Percent complete of the volume copy Status • VC Online: A volume copy is in progress to the destination - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 325
, or blank if not set or for all other hosts Profile • Standard: Default profile. • HP-UX: The host uses Flat Space Addressing. Example Show all volume mappings: # show volume-maps Volume View [Serial Number (SN) Name (v2) ] Mapping: Ports LUN Access Host-Port-Identifier Nickname Profile - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 326
Basetypes • volume-view • status See also • show host-maps • show hosts • show volumes 326 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 327
parameter is omitted, information is shown for all volumes. Output Name The name of the volume. Serial Number The serial number of the volume. Example Show volume names and serial numbers: # show volume-names Name Serial Number Data SN Data_s001 SN spData SN vd1_v1 SN Success - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 328
" (page 20). Output Name The name of the volume. Serial Number The serial number of the volume. Volume Reserved • Free: The volume is not reserved. • Reserved: The volume has been reserved by a host. Host ID The host WWPN or iSCSI node name. Port The controller host-port identifiers. Reservation - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 329
Example Show reservations for all volumes: # show volume-reservations all Name Serial Number Volume Reserved Host ID Port Reservation Type vd04_v001 SN Free Undefined vd04_v002 SN Reserved iqn.1991-05.com.microsoft:andiamo A3 Exclusive Access Success: Command completed - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 330
syntax, see "Command syntax" (page 20). Output Vdisk Name of the vdisk Name Name of the volume Size Volume size Serial Number Volume serial number WR Policy Cache write policy: • write-back: Write-back caching does not wait for data to be completely written to disk before signaling the host that the - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 331
will be shown as a secondary volume with the RSR qualifier. Volume Description • For HP-UX, a text value (set in-band by a host application) that identifies the volume. • Blank if not set. WWN World Wide Name of the volume, used by host-based Storage Replication Adapter (SRA) software to identify - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 332
volume information for standard volumes only: # show volumes type standard Vdisk Name Size Serial Number WR Policy Cache Opt Read Ahead Size Type Class Qualifier Volume volumes • status See also • create volume • delete volumes • expand volume • set volume • show vdisks • show volume-maps 332 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 333
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 Reset Time vd1_v0001 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 334
See also • reset all-statistics • reset volume-statistics • show controller-statistics • show disk-statistics • show host-port-statistics • show vdisk-statistics • show volumes 334 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 335
writing any data in write cache to disk. If the Storage Controller in each controller module is shut down, hosts cannot access the system's data. Perform a shut down before removing a controller module or powering down the system. Syntax shutdown [a|b|both] Parameters a|b|both Optional. Specifies - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 336
's vdisk. 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 337
's vdisk. 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 338
aborted to allow the volume to resume normal operation. Syntax suspend replication [set replication-set] replication-volume Parameters set replication-set Optional. The name or serial number of the replication set replication-volume The name or serial number of the secondary volume. If the name is - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 339
this option to test receipt of event-notification messages by every interface that is configured to receive them, such as email, SNMP, and SMI-S. (Event 312) for one of the Storage Controller's four crash logs. • ecdebug: Specify this option to send notification for the Expander Controller log. • mc - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 340
starting this procedure, consult the online troubleshooting guide at http://www.hp.com/support/msa2040/Troubleshooting to determine if the trust operation is applicable to your situation and for guidance to perform it. CAUTION: 1. Do not use the trust command when the storage system is unstable - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 341
spare you can either: • Contact Support for further assistance. This is user's CLI session ends. vdisk vdisk Optional. The name or serial number of Location The enclosure ID and slot number of the disk. Serial Number The serial number of the disk. Type • SAS: Enterprise SAS • SAS MDL: Midline SAS - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 342
spare • LEFTOVR: Leftover • VDISK: Used in a vdisk • VDISK SP: Spare time there is a change in the disk configuration of the vdisk, such as when a value can be used as a guide to decide which disks to vdisk has an insufficient number of in-sync disks. - Please contact Support for further assistance. ( - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 343
Location Serial Number Type State Partially Reconstructed Out Of Sync Age 1.2 SN SAS LEFTOVR False True 6 1.4 SN SAS VDISK False False 7 1.5 SN SAS only with the supervision of Support personnel. If you are ready > abort Error: Command was aborted by user. (2013-09-17 09:05:49) - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 344
See also • show vdisks • verify vdisk 344 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 345
to recover from a simulated failure performed with the fail command (which requires the manage role). If you attempt to unfail a controller that unfail controller b Success: Command completed successfully. - Successfully unfailed (unkilled) Storage Controller B. (2013-08-08 16:30:20) See also • fail - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 346
. For iSCSI, the iSCSI node name (typically the IQN) or nickname of each initiator to unmap the volumes from. If the host parameter is omitted, mapping changes apply to all hosts not explicitly mapped (that is, to the default mapping). volumes A comma-separated list of the names or serial numbers of - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 347
be used for replication from one system to another system. To verify bidirectional communication, run this command from the primary system to the secondary system, and then from the secondary system to the primary system. Syntax verify link [remote-system system] [link-type FC|iSCSI|ALL] Parameters - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 348
Basetypes • remote-links • status See also • show remote-systems • verify remote-link 348 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 349
for replication from one system to another system. To verify bidirectional communication, run this command from the primary system to the secondary system, and then from the secondary system to the primary system. Syntax verify remote-link remote-system system [link-type FC|iSCSI|ALL] Parameters - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 350
similarly to verify vdisk and also can find and fix media errors for any RAID level, including NRAID and RAID 0. Syntax verify vdisk vdisks [fix yes|no] Parameters vdisks A comma-separated list of the names or serial numbers of the vdisks to verify. For vdisk syntax, see "Command syntax" (page 20 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 351
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 Build Date: value Controller - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 352
-snapshot yes|no] [prompt yes|no|expert] destination-volume Parameters source-volume source-volume Name or serial number of the volume or snapshot to copy. For volume syntax, see "Command syntax" (page 20). dest-vdisk vdisk Name or serial number of the destination vdisk. For vdisk syntax, see - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 353
command to proceed. • no: Cancel the command. • 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 destination vdisk. The name is case sensitive; can include spaces and printable UTF-8 characters - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 354
354 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 355
a basetype by name. This chapter excludes basetypes that are for internal use only. Each basetype topic includes the following information: • References to CLI commands that directly use the basetype. • For each property, the values of its name and type elements, and a description of the values that - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 356
• 1: Enabled uint16 Shows the interval in hours between background vdisk scrub finishing and starting again, from 0-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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 357
is unchanged. This is the default. • Flush To Disk: Good status is returned only after all write-back data for the specified volume is flushed to disk. uint32 Numeric equivalents for sync-cache-mode values. • 0: Immediate • 1: Flush to Disk string Not supported. uint32 Numeric equivalents for - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 358
notified when a trigger condition occurs. • Disabled: Notification is disabled; the partner controller will continue using its current caching mode. This is the default. • Enabled: Notification is enabled; the partner controller will change to write-through mode for better data protection. Numeric - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 359
whether the cache policy will Drive spin down for available disks and global spares is disabled. This is the default. • Enabled: Drive spin down for available disks and global spares logs feature is enabled, which allows log files to be transferred from the storage system to a log-collection system to - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 360
that at least one controller is operational, thus avoiding data-unavailability situations. • Disabled: Auto-stall recovery is disabled. This is the default. • Enabled: Auto-stall recovery is enabled. Numeric equivalents for auto-stall-recovery values. • 0: Disabled • 1: Enabled 360 XML API basetype - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 361
is being used to copy data from a source volume to a destination volume. This attribute is temporary for the duration of the volume-copy process. • Replication Snapshot • Replicating Snapshot: A snapshot that is being replicated to a secondary volume. This snapshot is required in order to resume the - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 362
charged or fails. • Disabled: The supercapacitor failure trigger is disabled. • Enabled: The supercapacitor failure trigger is enabled. This is the default. Shows whether the cache policy will change from write-back to write-through when CompactFlash memory is not detected during POST (Power-On Self - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 363
read-ahead-size string string string uint32 string uint32 string If a volume is specified, its serial number. If a volume is specified, its name. If a volume is specified, its cache write policy. • write-back: Write-back caching does not wait for data to be completely written to disk before - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 364
Table 12 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 • - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 365
redundancy mode. • Active-Active ULP: Both controllers are active using ULP (Unified LUN Presentation). Data for volumes configured to use write-back cache is automatically mirrored between the two controllers to provide fault tolerance. • Single Controller: There is only a single controller in - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 366
certificate has been installed. Numeric equivalents for certificate-status values. • 0: Default • 1: Customer-supplied Date and time, in the format year-month-day hour:minutes:seconds, when the custom certificate was created. The first few characters of the certificate file. This property is - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 367
chap-records This basetype is used by show chap-records. Table 15 chap-records properties Name Type Description initiator-name initiatorsecret oname osecret string The originator name. string The secret that the recipient uses to authenticate the originator. string For mutual CHAP, the - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 368
automatically ends. Valid values are 120-43200 seconds (2-720 minutes). The default is 1800 seconds (30 minutes). • console: Supports interactive Enabled Alias for storage-size-base. • Enabled: Halts output after each full screen to wait for keyboard input. This is the default. • Disabled: Output - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 369
each magnitude. 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. uint8 Number of decimal places (1-10) for display of storage-space sizes. The default is 1. string Unit for - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 370
string Numeric equivalents for temperature-scale values. • 0: Fahrenheit • 1: Celsius The logged-in user's experience level. • Novice • Standard (the default) • Advanced • Diagnostic Numeric equivalents for user-type values. • 1: Novice • 2: Standard • 3: Advanced • 4: Diagnostic The logged-in - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 371
• 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 will automatically write cache data to the CompactFlash card. Cache flush is normally enabled, but - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 372
by users. If an auto-write-through trigger condition (such as a CompactFlash failure) is met, the cache policy for all volumes changes to write-through, overriding the volume-specific settings. When the problem is corrected, the cache policy reverts to the value configured for each individual volume - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 373
cache memory size (MB). uint32 uint32 string uint32 string uint32 Number of host ports in the controller module. Number of expansion ports in the controller enclosure. Controller interface to disks. • SAS Numeric equivalent for drive-bus-type value. • 8: SAS • Operational • Down • Not installed - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 374
value is not settable by users. If an AWT trigger condition (such as a CompactFlash failure) is met, the cache policy for all volumes changes to write-through, overriding the volume-specific settings. When the problem is corrected, the cache policy reverts to the value configured for each individual - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 375
location number. the automatic disabling of SAS expander PHYs having high error default. • Disabled: PHY fault isolation is disabled. Numeric equivalents for phy-isolation values. • 0: Enabled • 1: Disabled The system's operating mode, also called the cache volumes configured to use write-back cache - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 376
equivalents for redundancy-status values. • 0: Operational but not redundant • 3: Redundant • 4: Down • 5: Unknown Embedded; see unhealthy-component. Embedded; see network-parameters. Embedded; see port. Embedded; see expander-ports. Embedded; see compact-flash. 376 XML API basetype properties - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 377
cache-hits read-cachemisses number-ofwrites uint64 For the controller that owns the volume, the number of times the block to be read is found in cache. uint64 For the controller that owns the volume, the number either by a user or by a controller restart. reset-timenumeric uint32 Unformatted reset - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 378
format year-month-day hour:minutes:seconds, when sampling started for the iops and bytes-per-second values. Unformatted start-sample-time value. Date and 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 379
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 is the default. • On: Enabled. Numeric equivalents for mem values. • 0: Off • 1: On Shows whether failover and recovery debug messages - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 380
: Enabled. Numeric equivalents for rcm values. • 0: Off • 1: On Shows whether RAID debug messages are enabled for inclusion in the Storage Controller debug log. • Off: Disabled. • On: Enabled. This is the default. Numeric equivalents for raid values. • 0: Off • 1: On 380 XML API basetype properties - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 381
1: On Shows whether Internal Configuration API debug messages are enabled for inclusion in the Storage Controller debug log. • Off: Disabled. • On: Enabled. This is the default. Numeric equivalents for capi values. • 0: Off • 1: On Shows whether internal service interface debug messages are enabled - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 382
: Enabled. Numeric equivalents for res2 values. • 0: Off • 1: On Shows whether Internal Configuration API tracing messages are enabled for inclusion in the Storage Controller debug log. • Off: Disabled. This is the default. • On: Enabled. Numeric equivalents for capi2 values. • 0: Off • 1: On Shows - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 383
number-of-ios number-of-reads number-ofwrites total-datatransferred total-datatransferrednumeric data-read data-readnumeric data-written data-writtennumeric total-iops read-iops write-iops value. uint64 Average number of pending read and write operations being serviced since the last sampling - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 384
up the disk; media errors generated by the disk as specified by its manufacturer; non-media errors (generated by the storage system, or by the disk and not categorized as media errors); number of bad-block reassignments. Date and time, in the format year-month-day hour:minutes:seconds, when the data - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 385
serial-number bytes-persecond bytes-persecond-numeric iops string string string string Disk ID in the form disk_enclosure-number.disk-number. Disk serial number serviced. Date and time, in the format year-month-day hour:minutes:seconds, when these statistics were last reset, either by a user or - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 386
I/O operations currently being serviced. uint32 For port 2, the number of SMART events recorded. uint32 For port 2, the number of timeouts accessing the disk. uint32 For port 2, the number of times the disk did not respond. uint32 For port 2, the number of attempts by the storage system to spin up - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 387
-max drive-attempttimeout drive-overalltimeout uint32 Numeric equivalents for drive-write-back-cache values. • 0: Detect-Only • 1: Enabled • 2: Disabled uint8 Maximum number of times a timed-out I/O operation can be retried before the operation is failed. The default is 3. uint8 Number of - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 388
-statistics when the historical parameter is specified. Table 25 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 disk-hist-statistics. 388 XML API - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 389
This basetype is used by show disks. Table 26 drives properties Name Type Description durable-id enclosure-id drawer-id slot location port scsi-id blocks serial-number vendor model revision state secondarychannel container-index member-index type type-numeric job-running string uint32 unint8 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 390
current-jobcompletion blink locator-led speed smart smart-numeric dual-port error fc-p1-channel fc-p1-device-id fc-p1-node-wwn fc-p1-port-wwn fc-p1-unitnumber fc-p2-channel fc-p2-device-id fc-p2-node-wwn fc-p2-port-wwn fc-p2-unitnumber drive-down-code owner - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 391
Serial number of the disk's vdisk, if any. string string string Enclosure WWN. Disk status. • Up: The disk is present and is properly communicating with the expander. • Spun Down: The disk is present and has been spun down by the drive GLOBAL SP: The disk is a global spare. • LEFTOVR: The disk is a - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 392
Table 26 drives properties (continued) Name Type Description usage-numeric recon-state recon-statenumeric copyback-state copyback-statenumeric storage-tier storage-tiernumeric storage-poolname operation ssd-life-left ssd-life-leftnumeric led-status led-statusnumeric disk-dsd-count spun-down - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 393
Table 26 drives properties (continued) Name Type Description number-of-ios total-datatransferred for temperature-status values. • 1: OK • 2: Critical • 3: Warning • other: Unknown Not supported. Not supported. Disk health. • OK • Degraded • Fault • Unknown • N/A Numeric equivalents for health - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 394
Table 26 drives 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. 394 XML API basetype properties - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 395
. string The sender name that, with the domain name, forms the "from" address for remote notification. Blank by default. string Shows whether system log files will automatically be attached for email notification messages generated by the log-management feature. This is the "push" mode of log - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 396
part-number serial-number revision dash-level fru-shortname mfg-date mfg-datenumeric mfg-location mfg-vendor-id fru-location string status originalserialnumber originalpartnumber originalrevision enclosure-id string Configuration serial number. string string string string uint32 FRU status - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 397
status status-numeric enclosure-id slot vendor model serial-number size size-numeric string uint32 uint32 uint32 string expander. • Spun Down: The disk is present and has been spun down by the drive spin down feature. • Warning: The disk is present but the system is having communication problems - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 398
ID. 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 399
string string string string string FRU part number. Date and time, in the number. Firmware revision of controller A's EMP. Firmware revision of controller B's EMP. Number of rows of disk slots. Number of columns of disk slots. Number of disk slots in this enclosure Shows the state of the locator - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 400
for 2U, reduced-depth, 24-disk enclosure with 6-Gbit/s maximum data rate to disks (HP MSA 1040 SFF chassis) • 2U24-6G: Midplane for 2U, 24-disk enclosure with 6-Gbit/s maximum data rate to disks (HP P2000 SFF chassis) • 2U12-6Gv2: Midplane for 2U, reduced-depth, 12-disk enclosure with 6-Gbit - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 401
enclosure-sku This basetype is used by show frus. Table 31 enclosure-sku properties Name Type Description sku-partnumber string sku_serialnumber string sku-revision string System part number. System serial number. System revision level. enclosure-sku 401 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 402
, see the Event Descriptions Reference Guide. event-id model serial-number controller controllernumeric severity string string problem and correct it if necessary. • INFORMATIONAL: A configuration or state change occurred, or a problem occurred that the system corrected. No action is required - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 403
This basetype is used by show sas-link-health. Table 33 expander-ports properties Name Type Description durable on an expansion module. Can be connected to an egress (expansion) port in a controller module or an expansion module. • 2: In Port • 3: Out Port Expander port status. • Up • Warning - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 404
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 MSA 1040 drive applicable. • Serial number of a fan in a D2700 enclosure. • (blank): Not applicable. • Firmware revision of - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 405
Table 34 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. fan 405 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 406
primary-loop-id sfp-status sfp-present sfp-presentnumeric sfp-vendor sfp-part-number sfp-revision sfp-supportedspeeds string string string string uint32 string string string string Configured topology. • Loop: Fibre Channel arbitrated loop (public or private). • PTP: Fibre Channel - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 407
uint32 The number of pending I/O operations currently being serviced. Average response statistics were last reset, either by a user or by a controller restart. reset-timenumeric day hour:minutes:seconds, when sampling started for the iops and bytes-per-second values. Unformatted start-sample-time - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 408
the host. • No: No volumes are explicitly mapped to the host. • Standard: Default profile. • HP-UX: The host uses Flat Space Addressing. • If the host was discovered and its entry was automatically created, its host interface type: FC; iSCSI. • If the host entry was manually created: Undefined. For - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 409
id hba-nickname host-profile host-viewmapping string FC host port WWN, or iSCSI host initiator node name (typically the IQN). string User-defined name of the host port, or blank. string • Standard: Default profile. • HP-UX: The host uses Flat Space Addressing. Embedded; see host-view-mappings - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 410
is used by show host-maps. Table 39 host-view-mappings properties Name Type Description volume-name volume-serial lun access ports string string string string string Volume name. Volume serial number. LUN assigned to the mapping. Type of access assigned to the mapping. • read-write: Host - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 411
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. Storage Controller firmware version. Storage Controller loader firmware version. Controller serial - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 412
-id controller-id controller-idnumeric name description part-number serial-number revision dash-level fru-shortname mfg-date 1: Bottom • 2: Left • 3: Right Configuration serial number. string uint32 Shows whether the automatic disabling of SAS expander PHYs having high error counts is enabled or - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 413
string uint32 string string • Operational • Down • Not installed • Unknown Numeric equivalents for status values. • 0: Operational • 1: Down • 2: Not installed • 3: Unknown • OK • Degraded • Fault • the health issue. Embedded; see unhealthy-component. Embedded; see expander-ports. io-modules 413 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 414
isns-numeric isns-ip isns-alt-ip iscsi-speed string uint32 string uint32 string uint32 support is enabled. • Disabled: Jumbo-frame support is disabled. This is the default. Numeric equivalents for jumbo-frames values. • 0: Disabled • 1: Enabled Shows whether support for Internet Storage Name Service - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 415
Present • 1: Present The SFP vendor. The SFP part number. The SFP revision. The SFP's 10G compliance code, if supported, or No Support. string The SFP's Ethernet compliance code, if supported, or No Support. string Shows whether the SFP supports active or passive cable technology. uint8 The link - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 416
numeric volume-copy volume-copynumeric volume-copyexpiry volume-copyexpiry-numeric remotesnapshotreplication remotesnapshotreplicationnumeric remotesnapshotreplicationexpiry string uint32 • key: License is installed and valid. • not installed: License is invalid or is not installed. Maximum number - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 417
• 1: Enabled Shows when the VSS (Volume Shadow Copy Service) Hardware Provider will expire. • Never: 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 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 418
Table 44 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 418 XML API basetype properties - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 419
. Contact's email address, if specified in the SMU Save Logs panel. Contact's phone number, if specified in the SMU Save Logs panel. Comments describing the problem and specifying the date and time when the problem occurred, if specified in the SMU Save Logs panel. log-content log-timestamp log - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 420
string string string Master volume serial number. Master volume name. Master volume size, formatted to use volume is not found. • RV: Replication volume (either a primary volume or a secondary volume). • RV Prepared: Replication-prepared volume, which could become a secondary volume in a replication - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 421
ID in the form mgmtport_controller-ID. The configured network port IP version. • 4: IPv4 default. Numeric equivalents for addressing-mode values. • 1: Manual • 2: DHCP Not applicable. Not applicable. Not applicable. Not applicable. Not applicable. Not applicable. The health of the network connection - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 422
Table 47 network-parameters properties (continued) Name Type Description ping-broadcast ping-broadcastnumeric string uint32 • Enabled: The system will respond to a broadcast ping. • Disabled: The system will not respond to a broadcast ping. Numeric equivalents for ping-broadcast values. • 0: - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 423
string string string Shows whether use of Network Time Protocol (NTP) is enabled. • activated: NTP is enabled. • deactivated: NTP is disabled. This is the default. • The current NTP server IP address if NTP is enabled. • The last-set NTP server IP address if NTP was enabled and has been disabled - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 424
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 the snap-pool's error threshold is reached and the system cannot auto-expand the vdisk, the oldest remaining snapshot that is not a current sync - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 425
ID and port number. • FC: Fibre Channel. • iSCSI: Internet SCSI. Numeric equivalents for port-type values. • 6: FC • 9: iSCSI • FC(P): Not all 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 426
10Mb • 9: 100Mb • 10: 10Gb • 255: Port is disconnected. Configured host-port link speed in Gbit/s. • Auto (the default) • 1Gb • 2Gb • 4Gb • 8Gb Numeric equivalents for configured-speed values. • 0: 1Gb • 1: 2Gb • 2: 4Gb • 3: issue. Embedded; see fc-port, iscsi-port. 426 XML API basetype properties - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 427
mfg-datenumeric mfg-location mfg-vendor-id configurationserialnumber dc12v dc5v dc33v dc12i dc5i dctemp uint32 Unformatted mfg-date value. string string string City, state/province, and country where the FRU was manufactured. JEDEC ID of the FRU manufacturer. Configuration serial number. uint32 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 428
Table 51 power-supplies properties (continued) Name Type Description health health-numeric health-reason healthrecommendation status status-numeric unhealthycomponent fan-details string uint32 string string • OK • Degraded • Fault • Unknown Numeric equivalents for health values. • 0: OK • 1: - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 429
product-info This basetype is used by show inquiry. Table 52 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 429 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 430
lun-view string string string string uint32 string string • Volume name. • Blank if vdisk does not have a volume. Volume serial number. • Volume World Wide Name. • Blank if vdisk does not have a volume. Owning controller of the vdisk. • A: Controller A. • B: Controller B. Numeric equivalents - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 431
-bserial-number string uint32 string uint32 string uint32 string string uint32 string The system's operating mode, also called the cache redundancy mode. • Active-Active ULP: Both controllers are active using ULP (Unified LUN Presentation). Data for volumes configured to use write-back cache is - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 432
Table 54 redundancy properties (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 • - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 433
-name (Not shown) Shows when the data represented by the base type was last updated. • 0: The data has never been updated and is not cached. • nonzero-number: A timestamp indicating that the data has been updated. If the value has changed since the last time you called this command then the data - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 434
remote-addresses This basetype is used by show replication-volumes. Table 56 remote-addresses properties Name Type Description connected-ports remote-address string string • port-IDs: For a remote primary or secondary volume, the IDs of up to two hosts ports in the local system that are - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 435
ID in the local system, in the form hostport_controller-ID-and-port-number. string • Unknown: Port type is unknown. • FC: FC port. • iSCSI: iSCSI port. uint32 Numeric equivalents for type values. • 0: Unknown • 6: FC • 9: iSCSI string Controller host port ID of each linked port in the remote - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 436
location systeminformation vendor-name product-id product-brand ip-address-a ip-address-b username status status-numeric last-connected interfaces interfacesnumeric storage-model storage a user that is configured in the remote system. This must be a user with the manage role to remotely configure or - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 437
Table 58 remote-system properties (continued) Name Type Description isvalid-ip-a isvalid-ip-anumeric isvalid-ip-b isvalid-ip-bnumeric string uint32 string uint32 • False: The IP address is not valid for controller module A in the remote system. • True: The IP address is valid for controller - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 438
string Primary volume name. string Primary volume serial number. string A label to identify snapshots created by this task. Snapshot names have the format prefix_s#, where # starts at 001. string • new-snapshot: Replicate a new snapshot of the volume to the remote system. This is the default. • last - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 439
-serial string Replication image ID. string Replication volume serial number. string Replication image serial number. string Name of the source replication image. string Replication snapshot serial number associated with the image. The replication snapshot is associated with the replication volume - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 440
is known to exist in the primary-view volume but replication has not started. • Replicating: The image is being replicated. • Suspended: The image is being replicated but replication is suspended. • Complete: The image is created, fully replicated, and available. • Create-Snapshot: The image is - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 441
replication-set This basetype is used by show replication-sets. Table 62 replication-set properties Name Type Description name serial-number primary string Replication set name. string Replication set serial number. Embedded; see replication-volume. replication-set 441 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 442
serial number. Replication volume status. • Initializing: The initial (full) replication to the volume is in progress. • Online: The volume is online and is consistent with the last replicated image. • Inconsistent: The volume is online but is in an inconsistent state. A full replication is required - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 443
is the default. • Suspend: Suspend the replication until the error is resolved automatically or through user intervention. Numeric equivalents for error-policy values. • 0: Retry • 1: Suspend Type of ports used to link the primary and secondary volumes. • FC: FC ports. • iSCSI: iSCSI ports. Numeric - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 444
Date and time of the last communication with the remote volume, or N/A. uint32 Unformatted connection-time value. string Replication set serial number. string Local replication volume serial number. Embedded; see remote-addresses. Embedded; see replication-image. 444 XML API basetype properties - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 445
name serial-number volume-type string string string Replication volume name. Replication volume serial number. • Primary Volume: The volume is the primary volume in a replication set. • Secondary Volume: The volume is the secondary volume in a replication set. volume-typenumeric images - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 446
show task-details for a ResetSnapshot task. Table 65 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. 446 XML API basetype properties - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 447
: 4-lane PHY that communicates between the expander and an expansion port or SAS Out port. • Inter-Exp: (Expansion module only) Communicates between the expander and the partner's expander. • Unused: The PHY exists in the expander but is not connected, by design. • SC-0: (Controller module only - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 448
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 drive slot is empty. • Unused - disabled by default: PHY is disabled by default because it is not used. • Excessive - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 449
control • 32772: Not ready • 32774: Drive removed • 32775: Unused - disabled by default • 32776: Excessive PHY changes uint32 Number of times the PHY originated a BROADCAST (CHANGE). A BROADCAST (CHANGE) is sent if doubleword synchronization is lost or at the end of a Link Reset sequence. uint32 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 450
schedules This basetype is used by show schedules and show schedule-details. Table 67 schedules properties Name Type Description name schedulespecification status next-time next-timenumeric task-to-run error-message task string Schedule name. string Schedule settings for running the associated - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 451
Disabled • 1: Enabled • Disabled: The secure WBI web server is disabled. • Enabled: The secure WBI web server is enabled. This is the default. Numeric equivalents for wbi-https values. • 0: Disabled • 1: Enabled • Disabled: The standard CLI is disabled. • Enabled: The standard CLI is enabled. This - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 452
debug port is disabled. This is the default. • Enabled: The Telnet debug port is enabled. Remote connection is allowed, through incoming ports only, by HP or HP's authorized representatives for troubleshooting. Disabling the service debug protocol removes this access. uint32 Numeric equivalents - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 453
-ID.sensornumber and sensor_volt_ctrl_controller-ID.sensor-number. Enclosure ID. Sensor name and location. • For a sensor, its value • 2: Error • 3: Warning • 4: Unrecoverable • 5: Not Installed • 6: Unknown • 7: Unavailable Sensor location in a controller enclosure. • 1: Unknown • 2: Overall unit - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 454
show-other-mc-status This basetype is used by show shutdown-status. Table 70 show-other-mc-status properties Name Type Description other-mc other-mc-status other-mcstatus-numeric string string uint32 Other MC Status - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 455
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 installed. Numeric equivalents for status values. • 0: up • 1: down • 2: not installed shutdown-status 455 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 456
Vdisk name. string string string uint32 string uint32 Snap pool serial number. Snap pool name. Snap pool size, formatted to use as a percentage of total space in the snap pool. Number of master volumes associated with this snap pool. Number of snapshots using this snap pool. • Available: The snap - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 457
-numeric string Vdisk name. string string string uint32 Snapshot serial number. Snapshot name. Date and time, in the format year 9: snap pool not found • 10: master volume not found • 254: N/A • hex-code: Unknown reason Name of the volume of which the snapshot was taken. string string uint32 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 458
on any secondary volume. string User-defined retention priority for the snapshot type. string Snapshot type. • Standard snapshot: Snapshot of a master volume that consumes a snapshot license. • Standard snapshot(DRM): A temporary standard snapshot created from a replication snapshot for the - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 459
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 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 460
properties Name Type Description master-volumename master-volumeserial snapshot-prefix retention-count last-created snapshot string Source volume name. string Source volume serial number. string A label to identify snapshots created by this task. Snapshot names have the format prefix_s#, where - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 461
task-details for a task that has created at least one snapshot. Table 75 snap-tasks properties Name Type Description snapshot-name string Snapshot name. snapshot-serial string Snapshot serial number. snap-tasks 461 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 462
traps. • none: No events are sent as traps and traps are disabled. This is the default. Numeric equivalents for snmp-filter values. • 0: none • 1: info • 2: error • 4: . The value is obscured for users having only the monitor role and is shown in clear text for users having the manage role. The - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 463
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 77 status properties Name Type Description response-type response-typenumeric response string uint32 string • - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 464
syslog-parameters This basetype is used by show syslog-parameters. Table 78 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 465
of the system. The default is Uninitialized Location. A brief description of what the system is used for or how it is configured. The default is Uninitialized Info. The serial number of the controller enclosure midplane. string The vendor name. string The product model identifier. string The - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 466
Table 79 system properties (continued) Name Type Description fde-securitystatus fde-securitystatus-numeric platform-type platform-typenumeric platform-brand platform-brandnumeric redundancy-mode unhealthycomponent string Not applicable. uint32 Not applicable. string Platform type. uint32 Numeric - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 467
physical components (enclosures, disks, etc.) in the storage system. Percentage of disk capacity that is reserved to compensate for minor capacity differences between disk drives so they can be used interchangeably. This is not settable by users. The default is 1 percent. Amount of space reserved on - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 468
localcontrollernumeric serial-number Number of replication sets that the system supports. uint32 string uint32 string string Number of enclosures that the system supports. service personnel. uint32 For internal use only. uint32 Number of global-spare disks defined in the storage - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 469
Table 80 system-parameters-table properties (continued) Name Type Description min-backingstore-size max-fc-speed max-fc-speednumeric max-iscsi-speed max-iscsispeed-numeric uint32 Minimum snap-pool size in blocks. string Maximum FC host-port speed. uint32 Numeric equivalent for the max-fc-speed - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 470
tasks This basetype is used by show tasks and show task-details. Table 81 tasks properties Name Type Description name type status state string string string string Task name. Type of operation this task performs. • TakeSnapshot • ResetSnapshot • VolumeCopy • ReplicateVolume • EnableDSD • - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 471
• VerifySnap • For an EnableDSD or DisableDSD 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 472
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. 472 XML API basetype properties - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 473
supply unit • disk: Disk • enclosure: Enclosure • vdisk: Vdisk • fan • CompactFlash • disk slot • SAS port • sensor • network port • volume • snap pool • volume: Master volume • snapshot • host • replication image • replication volume • replication set • volume map • system unhealthy-component 473 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 474
fan • 10: CompactFlash • 11: disk slot • 12: SAS port • 13: sensor • 14: network port • 17: volume • 18: snap pool • 19: volume (master volume) • 20: snapshot • 21: host • 22: replication image • 23: replication volume • 24: replication set • 25: volume map • 26: system Component identifier, such as - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 475
basetype is used by show unwritable-cache. Table 84 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 for unwritable data in - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 476
and display of storage-space sizes: • 2: Sizes are shown as powers of 2, using 1024 as a divisor for each magnitude. • 10: Sizes are shown as powers of 10, using 1000 as a divisor for each magnitude. This is the default. Operating systems usually show volume size in base 2. Disk drives usually show - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 477
none • 1: MD5 • 2: SHA For an SNMPv3 user, this specifies whether to use a security encryption protocol. This parameter requires the privacy-password property and the authentication-type property. • none: No encryption. This is the default. • DES: Data Encryption Standard. • AES: Advanced Encryption - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 478
properties (continued) Name Type Description privacypassword trapdestination string string Encryption password for an SNMPv3 user whose privacy type is set to DES or AES. For an SNMPv3 user whose interface-access-SNMP property is set to snmptarget, this specifies the IP address of the host - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 479
vdisk-hist-statistics This basetype is used by show vdisk-statistics when the historical parameter is specified. Table 86 vdisk-hist-statistics properties Name Type Description total-datatransferred total-datatransferrednumeric data-read data-readnumeric data-written data-writtennumeric total- - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 480
name serial-number bytes-persecond bytes-persecond-numeric iops string string string uint32 Vdisk name. Vdisk serial number. Data hour:minutes:seconds, when these statistics were last reset, either by a user or by a controller restart. reset-timenumeric start-sampletime start-sampletime-numeric - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 481
. 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 version. Expander Controller firmware - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 482
used by show vdisk-statistics when the historical parameter is specified. Table 89 virtual-disk-summary properties Name Type Description name serial-number vdisk-histstatistics string Vdisk name. string Vdisk serial number. Embedded; see vdisk-hist-statistics. 482 XML API basetype properties - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 483
values. • 0: B • 1: A Vdisk RAID level. • NRAID • RAID0 • RAID1 • RAID3 • RAID5 • RAID6 • RAID10 • RAID50 Numeric equivalents for raidtype values. • 0: RAID0 • 1: RAID1 • 3: RAID3 • 5: RAID5 • 6: NRAID • 8: RAID50 • 10: RAID10 • 11: RAID6 Number of disks in the vdisk. Number of spare disks assigned - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 484
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 with multiple inaccessible disks causing user data to be incomplete, or is an NRAID or RAID-0 vdisk. • STOP: - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 485
uint32 The largest contiguous space in which a volume can be created. The value is formatted to use the current base, precision, and units. Unformatted largest-free-partition-space value in 512-byte blocks. uint8 uint8 • For a RAID-10 or RAID-50 vdisk, the number of disks in each sub-vdisk. • For - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 486
for array-drive-type values. • 1: MIX • 4: SAS • 8: sSAS • 11: SAS MDL • false: The current job must be manually aborted before you can delete the vdisk. • true: The current job will automatically abort if you delete the vdisk. • 0: false • 1: true string Vdisk serial number. uint64 Unformatted - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 487
Table 90 virtual-disks properties (continued) Name Type Description healthrecommendation unhealthycomponent string If Health is not OK, the recommended actions to take to resolve the health issue. Embedded; see unhealthy-component. virtual-disks 487 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 488
-copy-status properties Name Type Description vc_volume_name serial-number virtual-diskname source-volume progress status status-numeric role role-numeric status-reason string string string Destination volume name. Destination volume serial number. Destination vdisk name. string string string - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 489
-serialnumeric destinationvolume-prefix includemodified-data last-created string Source volume name. string Source volume serial number. string Destination vdisk name. string Not applicable. string Destination vdisk serial number. string Not applicable. string string string Label that identifies - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 490
volume-names This basetype is used by show volume-names. Table 93 volume-names properties Name Type Description volume-name serial-number string Volume name. string Volume serial number. 490 XML API basetype properties - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 491
string string uint32 The name of the volume. The serial number of the volume. • Free: The volume is not reserved. • Reserved: The volume has been reserved by a host. Numeric equivalents for reservation-active values. • 0: Free • 1: Reserved Host WWPN or iSCSI node name. The controller host-port - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 492
storage-poolname volume-name size size-numeric total-size total-sizenumeric allocated-size allocated-sizenumeric preferred-owner preferredowner-numeric owner owner-numeric serial-number 1: A Volume serial number. • write-back: Write-back caching does not default. • write-through: Write-through caching - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 493
volume-type volume-typenumeric string uint32 string uint32 string uint32 • standard: Optimizes cache for both sequential and random reads. Appropriate for applications that read and write small files in random order, such as transaction-based and database update applications. This is the default - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 494
. Replication set serial number. Shows whether the volume's disks are single pathed. Vdisk serial number. string • For HP-UX, a text value (set in-band by a host application) that identifies the volume. • Blank by default. string World Wide Name of the volume, used by host-based Storage Replication - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 495
-pageon-allocationnumeric raidtype raidtypenumeric pi-format string 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 number. string Not applicable. uint32 Not applicable. string Not - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 496
properties (continued) Name Type Description pi-formatnumeric health health-numeric health-reason healthrecommendation volume-group group-key string Not applicable. string uint32 string string • OK • Degraded • Fault • Unknown Numeric equivalents for health values. • 0: OK • 1: Degraded - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 497
basetype is used by show volume-statistics. Table 96 volume-statistics properties Name Type Description volume-name serial-number bytes-persecond bytes-persecond-numeric iops string string string uint32 The name of the volume. The serial number of the volume. The data transfer rate calculated - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 498
Table 96 volume-statistics properties (continued) Name Type Description reset-timenumeric start- 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 uint32 The date and time, in - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 499
-id volume-serial volume-name volume-viewmappings string Volume ID in the form V#, where # starts at 1 and increments for each new volume to uniquely identify it. The value is generated from available data in the current CLI session and may change after an MC restart. string Volume serial number - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 500
mapped to the volume. • For an FC host port, the host WWPN. • For an iSCSI host port, the host initiator node name (typically the IQN). • For any host that is not explicitly mapped, all other hosts. • Host nickname. • Blank if not set or for all other hosts. • Standard: Default profile. • HP-UX: The - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 501
Instructions • HP MSA 1040 Cable Configuration Guide • HP MSA 1040 User Guide • HP MSA 1040 SMU Reference Guide • HP MSA Event Descriptions Reference Guide From the support website, you can access additional manuals and information, including best practices, guided troubleshooting, and firmware - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 502
harm or death. CAUTION: Indicates that failure to follow directions could result in damage to equipment or data. IMPORTANT: Provides clarifying information or specific instructions. NOTE: Provides additional information. TIP: Provides helpful hints and shortcuts. 502 Support and other resources - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 503
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 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 504
504 Documentation feedback - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 505
Location • Uninitialized Info • Enabled • Enabled • Enabled • Enabled • Enabled • Enabled • Enabled • Disabled • Disabled • Enabled • Disabled All configured users are deleted and replaced with default user definitions and default settings: • User: manage; password: !manage • User: monitor; password - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 506
Drive spin down Disabled Advanced settings: • Vdisk background scrub • Partner firmware upgrade • Utility priority • SMART • Dynamic spare configuration default: no tasks or schedules. 2. Factory default: no remote system definitions. 3. Factory default: MC logs are cleared. 4. Factory default: - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 507
the leftover state. It is available to be configured as a part of a vdisk or as a spare. See also compatible disk, dedicated spare, dynamic spare, and global spare. AWT Auto-write-through. A setting that specifies when the RAID controller cache mode automatically changes from write-back to write - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 508
expansion modules. Drive enclosures can be connected to a controller enclosure to provide additional storage capacity. drive spin down See DSD. DRM Disaster recovery management. Storage-system firmware features that, when the Site Replication Adapter (SRA) feature is enabled, support the use of - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 509
gate array. An integrated circuit designed to be configured after manufacturing. FRU Field-replaceable unit. A part that can be removed and replaced by the user or support technician without having to send the product to a repair facility. global spare A compatible disk that is reserved for use - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 510
protocol. Internet Storage Name Service. "Just a bunch of disks." See drive enclosure. In an iSCSI network, a frame that can contain 9000 bytes for large data transfers. A normal frame can contain 1500 bytes. See LFF. Logical Block Address. The address used for specifying the location of a block - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 511
in a SAS network that enables transmission of data. See PHY. Fibre Channel Point-to-Point topology, where two ports are directly connected. Power-on self test. Tests that run immediately after a device is powered on. See POST. See PSU. The volume that is the source of data in a replication set and - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 512
is an "old common sync point." SAS Serial Attached SCSI interface protocol or disk-drive architecture. SC Storage Controller. A 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 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 513
See SMU. Utility Storage Networking See SNIA. Industry Association storage system A controller enclosure with at least one connected drive enclosure. Product documentation and interfaces use the terms storage system and system interchangeably. syslog Remote syslog support. A configuration that - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 514
number of disks that a vdisk can contain is determined by its RAID level. vdisk spare See dedicated spare. virtual disk See vdisk. volume A portion of the capacity of a vdisk that can be presented as a storage device to a host. volume for managing the system. A user can enable the use of HTTP - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 515
2 22 base for storage-space sizes set 63 set CLI 144 set user 188 show current 206 bytes versus characters 20, 22 C cache clear unwritable data 36 user 23 deprecated 27 disk, vdisk, and spare 23 event notification 24 remote replication 26 remote systems 25 removed 28 scheduled task 24 service - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 516
195 show vdisk scrub setting 195 dynamic spares enable/disable 135 show setting 195 E EMP polling rate set 135 show 195 enclosure locate 162 enclosures set location 152 set name 152 set position in rack 152 set rack number 152 show EMP address and firmware revision 228 show health 228 show ID - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 517
cache set 135 show setting 195 host channel See host ports host link See host ports host ports reset 120 reset performance statistics 121 set default router address for iSCSI 159 set FC connection 162 leftover disk 37 license create temporary 62 licensed features show 250 link rate adjustment 218, 391 link - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 518
set user 63, 189 show user 314 masked volume 103 master volume expand 100 roll back data 131 master volumes convert to standard 41 create 47 delete 78 delete all 73 show 252 metadata clear disk 37 midplane show abbreviated serial number 301 missing LUN response set 135 show 196 N NCQ default 506 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 519
338 replication images show 273 replication set create 50 delete 80 replication sets show 276 replication volumes show 280 rescan disk channels 115 restore system defaults 129, 505 revert volume data See roll back volume data role set user 64, 190 show user 314 S SAS expander See expander SAS port - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 520
setting 196, 199 synchronize-cache mode set 136 show setting 196 syntax, command 20 syslog set parameters 184 show parameters 297 system restart 127 restore defaults 129, 505 set contact 185 set information/description 185 set location 185 set name 185 show configuration 208 show information 298 - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 521
controller 192 set spares 193 set spin- replication 108 replicate 114 serial number 20 set identifying information (description) 194 set parameters for a replication 175 set primary 172 show amount of unwritable cache data 313 show copy status 324 start manual scrub 133 syntax 20 unmap 346 volume - HP MSA 1040 | HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 522
scripting guidelines 17 show data omitted by brief mode 106 using 16 522 Index
HP MSA 1040
CLI Reference Guide
HP Part Number: 762782-001
Published: March 2014
Edition: 1
Abstract
This guide provides information about managing an HP MSA 1040 storage system by using its command-line interface (CLI).