HP StorageWorks MSA2312fc HP StorageWorks 2300 Family Modular Smart Array CLI
HP StorageWorks MSA2312fc Manual
View all HP StorageWorks MSA2312fc manuals
Add to My Manuals
Save this manual to your list of manuals |
HP StorageWorks MSA2312fc manual content summary:
- HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 1
HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide Part number: 500912-002 Second edition: September 2009 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 2
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. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 3
guide 9 Intended audience 9 Prerequisites 9 Related documentation 9 Document conventions and symbols 9 HP technical support 10 Product warranties 10 Subscription service 10 HP 29 clear disk-metadata 30 user 43 create vdisk 45 HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 3 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 4
snapshot-write-data 58 delete task 59 delete user 60 delete vdisk 61 delete volume 62 ping 72 rescan 73 reset host-link 74 reset snapshot 75 restart 76 restore defaults 77 rollback master- -parameters 87 set controller-date 90 set debug-log-parameters 91 set disk-parameters 92 set - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 5
165 show snmp-parameters 167 show system 168 show system-parameters 169 show task-details 170 show tasks 173 show users 174 show vdisks 175 show volume-maps 177 show volumecopy-status 178 show volumes 179 shutdown 181 stty 182 test 183 trust 183 HP StorageWorks 2000 G2 Modular Smart - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 6
unmap volume 184 verify vdisk 185 versions 185 volumecopy 186 Glossary 189 Index 191 6 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 7
9 2 Default usernames and passwords 11 3 XML API elements 13 4 Keyboard shortcuts for command completion, editing, and history 20 5 Size representations in base 2 and base 10 21 6 Decimal (radix) point character by locale 21 7 Commands by category 23 HP StorageWorks 2000 G2 Modular Smart - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 8
8 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 9
attach storage (DAS) • Fibre Channel, Serial Attached SCSI (SAS), Internet SCSI (iSCSI), and Ethernet protocols Related documentation In addition to this guide, please refer to other documents for this product: • HP StorageWorks MSA2000 G2 Installation Instructions • HP StorageWorks 2000 G2 Modular - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 10
updates on the latest product enhancements, newest versions of drivers, and firmware documentation updates as well as instant access to numerous other product resources. • After signing up, you can quickly locate your products by selecting Business support and then Storage under Product Category. HP - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 11
. See your product's user guide for information about setting management port IP addresses using the CLI. • By using a terminal emulator on a management host that is directly connected to a controller module's serial CLI port. Table 2 Default usernames and passwords Username Password Access level - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 12
into the CLI, executing a command to show free (available) disks, and exiting the CLI: $: telnet 172.22.5.55 Login: monitor Password: ******** product System Name: Test System Location: Lab Version: version # show disks free Location Serial Number Rate(Gb/s) SP Status Vendor Rev How Used Type - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 13
to use to detect the type of the object (e.g., a disk, a volume, etc.). • name. The name of the object. • oid. The unique identifier for the object in the scope of the response. The OBJECT element can contain PROPERTY elements. HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 13 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 14
name. The label for this data to show in user interfaces. COMP ASC A COMP (composition) element associates on ordering, spacing, or column position. To find a specific property, a script should compare property names as it searches as defined in this guide. The output is in XML which conforms to the - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 15
="true" sort="string" display-name="Read Ahead Size">Default - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 16
ID"> The following example shows XML API output from the create vdisk command: # create vdisk vd-1 disks 2.6,2.7,2.8 level r5 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 17
command with the basetype of the object. This optimization reduces the number of bytes transmitted for each request and allows caching of CLI metadata. Brief mode can be enabled or disabled by using the set cli-parameters command. HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 17 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 18
media-specific detail for ports, and only name and key properties are shown: hostport_A1 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 19
each controller module. You can specify: • A port ID. Example: A1 • A hyphenated range of IDs. Do not mix controller IDs in a range. Example: b1-b2 • A comma-separated list of IDs, ranges, or both (with no spaces). Example: A1,b1-b2 HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 19 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 20
Command completion, editing, and history The CLI supports command completion, command editing, and command history input line Ctrl+L Viewing help To view brief descriptions of all commands that are available to the user level you logged in as, enter: help To view help for a command and then return - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 21
show volume size in base 2. Disk drives usually show size in storage-space sizes can be set per user or per session; see create user and set cli-parameters. When entering storage controller modules and encompasses all field-replaceable HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 21 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 22
22 Using the CLI - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 23
delete snapshot-write-data expand master-volume expand snap-pool reset snapshot rollback master-volume set snap-pool-policy set snap-pool-threshold show master-volumes show snap-pools show snapshots show volumecopy-status volumecopy HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 23 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 24
-parameters show email-parameters show events show snmp-parameters test System configuration and utilities clear cache create chap-record delete chap-records ping show controller-date show controllers show disk-parameters show enclosures reset host-link show enclosure-status restart show - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 25
examples of the command's usage, if the command has parameters or detailed output See also Cross-references to commands that are used with the command HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 25 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 26
abort scrub Description Aborts the scrub vdisk operation for specified vdisks. Syntax abort scrub vdisk vdisks Parameters vdisks Names or serial numbers of the vdisks to stop scrubbing. Example Abort scrubbing vdisk vd1: # abort scrub vdisk vd1 Info: Scrub aborted on vdisk vd1 Success: Command - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 27
Names or serial numbers of the vdisks to stop verifying. Example Abort verifying vdisk vd1: # abort verify vdisk vd1 Info: Verify aborted on vdisk vd1 Success: Command completed successfully See also • show vdisks (to find disks being verified) • verify vdisk HP StorageWorks 2000 G2 Modular Smart - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 28
a volume. When the abort is complete, the destination volume is deleted. Syntax abort volumecopy volume Parameters volume Name or serial number of the source or destination volume. Example Abort creating destination volume vd1_copy: # abort volumecopy v1_copy Success: Command completed successfully - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 29
data will differ between the host and disk. Unwritable cache is also called orphan volume Optional. Name or serial number of the volume whose cache controllers for volume V1: # clear cache volume v1 Success: Command completed successfully HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 30
not clear that disk's metadata. Syntax clear disk-metadata disks Parameters disks IDs of the disks to clear metadata from. For syntax, see Command syntax. Example Clear metadata for the first enclosure's first disk, which is not part of a vdisk: # clear disk-metadata 1.1 Updating disk list... Info - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 31
this parameter is omitted, both event logs are cleared. Example Clear the event log for controller A: # clear events a Success: Command completed successfully. - Controller A event log was successfully cleared. See also • show events HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 31 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 32
service technician. Clears the counters and status for SAS expander lanes. Counters and status can be reset to a good state for all enclosures, or for a specific -status [enclosure ID] Parameters enclosure ID Optional. The enclosure number. Example Clear the expander status for the first enclosure: - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 33
volume. Syntax convert master-to-std master-volume Parameters master-volume Name or serial number of the master volume to convert. For syntax, see Command syntax. Example . See also • delete all-snapshots • show master-volumes HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 33 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 34
. The standard volume and the snap pool must be owned by the same controller, though they can be in different vdisks. Syntax convert std-to-master snap-pool snap-pool standard-volume Parameters snap-pool snap-pool Name or serial number of the snap pool to associate with the new master volume. For - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 35
of 223 bytes, including 0-9, lowercase a-z, hyphen, colon, and period. A storage system's IQN is a controller host-port name without its .a or .b suffix; see the Port-Name field -records • show host-parameters • show iscsi-parameters HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 35 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 36
ux Optional. • standard: The host allows LUN 0 to be assigned to a mapping. This is the default. • openvms: The host does not allow LUN 0 to be assigned to a mapping. • hp-ux: The host allows LUN 0 to be assigned to a mapping and uses Flat Space Addressing. Example Create an entry named Host1 for an - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 37
and snap pool must be owned by the same controller. Syntax create master-volume vdisk vdisk size size serial number of the snap pool to associate with the new master volume. For syntax, see Command syntax. lun LUN Optional. A default HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 37 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 38
runs Task2 for the first time on March 1, 2007, and on the first weekday of each month, with no expiration: # create schedule schedule-specification "start 3/1/2007 00:01 only first weekday of month" task-name Task2 Sched2 Success: Command completed successfully. - The schedule was created. See also - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 39
vdisk size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] name Parameters vdisk vdisk Name or serial number of the vdisk to create the snap pool in. For syntax, see Command syntax. size pool was created. See also • show snap-pools • show vdisks HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 39 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 40
create snapshots Description Creates a snapshot of each specified source volume. The source volume can be a standard volume or a master volume. The first time a snapshot is created of a standard volume, the volume is converted to a master volume and a snap pool is created. The snap pool's size is 20 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 41
prior to resetting the snapshot. serial number of the master volume or snapshot to copy. For syntax, see Command syntax. dest-vdisk vdisk Name or serial number of the destination vdisk for the volume copy. For syntax, see Command syntax. HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 42
that takes a snapshot of master volume VD1_V1 and retains only the latest four snapshots with the prefix VD1_V1 (e.g., VD1_V1_S0001): # create task type successfully. - The task was created. Create task Task2 that resets snapshot VD1_S0001: # create task type ResetSnapshot snapshot-volume VD1_S0001 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 43
and re-enter a password for the user. precision # Optional. Sets the number of decimal places (1-10) for display of storage-space sizes. Default is 1. storage-size-base 2|10 Optional. Alias for base. storage-size-precision # Optional. Alias for precision. HP StorageWorks 2000 G2 Modular Smart Array - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 44
: Enables access to standard and advanced functions. This is the default for manage users. • diagnostic: Enables access to standard, advanced, and troubleshooting functions. units auto|MB|GB|TB Optional. Sets the unit for display of storage-space sizes. auto lets the system determine the proper unit - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 45
must be either SAS or SATA; mixing disk types is not supported. For each RAID level, the minimum and maximum numbers of disks supported are: • NRAID: 1 • RAID 0: fault tolerant. This option is the default. • offline: You must wait HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 45 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 46
the RAID-1 vdisk VD1 using two disks in the first enclosure: # create vdisk level raid1 disks 1.1,1.3 VD1 Success: Vdisk created. Create the RAID-50 vdisk VD2 having three RAID-5 sub-vdisks, each having three disks: # create vdisk level r50 disks 1.1-3:1.4-6:1.7-9 VD2 Success: Vdisk created. See - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 47
ID] name Parameters vdisk vdisk Name or serial number of the vdisk to create the volume in permission for hosts connected to the controller for this volume: read-write ( this parameter is omitted, the default LUN is presented. You HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 47 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 48
create volume-copy See volumecopy. 48 Alphabetical list of commands - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 49
no-access] [ports ports] Parameters vdisk vdisk Name or serial number of the vdisk to create the volumes in. For syntax, access is masked. The default is read-write. ports ports Optional. The controller ports through which hosts can HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 49 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 50
master volumes before you can delete the master volumes. Syntax delete all-master-volumes snap-pool volume Parameters snap-pool volume Name or serial number of the snap pool whose master volumes should be deleted. For syntax, see Command syntax. Example Delete all master volumes associated with snap - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 51
Name or serial number of the volume to delete snapshots of. For syntax, see Command syntax. Example Delete all snapshots associated with master volume MV1: # delete all-snapshots volume MV1 Success: All Snapshots Deleted. See also • show snapshots • show volumes HP StorageWorks 2000 G2 Modular Smart - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 52
CHAP record or all CHAP records. This command is permitted whether or not CHAP is enabled. Syntax To delete the CHAP record for a specific originator: delete chap-records name originator-name To delete all CHAP records: delete chap-records all Parameters name originator-name The originator name - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 53
Delete the manually created host Storage Controllers, and retry. - Host 500605B000320BB4 was discovered, so it cannot be deleted. Error: Remove host failed - some host(s) may have been removed. See also • show host-maps • show hosts HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 54
delete all snapshots that exist for the master volume before you can delete it. Syntax delete master-volume volume Parameters volume Name or serial number of the master volume to delete. For syntax, see Command syntax. Example Delete master volume MV1: # delete master-volume MV1 Success: Command - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 55
schedule to delete. Example Delete schedule Sched1: # delete schedule Sched1 Success: Command completed successfully. - The schedule was deleted. See also • show schedule-details • show schedules HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 55 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 56
must disassociate all master volumes from the snap pool before you can delete it. Syntax delete snap-pool snap-pool Parameters snap-pool Name or serial number of the snap pool to delete. For syntax, see Command syntax. Example Delete snap pool SP1: # delete snap-pool SP1 Success: Command completed - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 57
Name or serial number of the snapshot to delete. For syntax, see Command syntax. Example Delete snapshot SS1: # delete snapshot SS1 Success: Command completed successfully. - The snapshot was deleted. See also • delete snapshot-write-data • show snapshots HP StorageWorks 2000 G2 Modular Smart - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 58
modified data reverts the snapshot to the state when it was first taken. Syntax delete snapshot-write-data snapshot Parameters snapshot Name or serial number of the snapshot to delete modified data from. For syntax, see Command syntax. Example Delete only modified data from snapshot SS1: # delete - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 59
: # delete task Task1 Success: Command completed successfully. - The task was deleted. See also • delete schedule • show schedule-details • show schedules • show task-details • show tasks HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 59 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 60
You can delete any user except the default user manage. Syntax delete user [noprompt] name Parameters noprompt Optional. Suppresses the confirmation prompt that requires a yes or no response. name The user to delete. Names are case sensitive. Example Delete user jsmith: # delete user jsmith Are you - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 61
specified vdisks. This disassociates all disks that are assigned to the vdisks If this parameter is omitted, you must manually reply to the prompt. vdisks Names or serial numbers of the vdisks to delete. For syntax, • show vdisks HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 61 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 62
Deletes specified volumes. CAUTION: Deleting a volume will delete all data in that volume. Syntax delete volume volumes Parameters volumes Names or serial numbers of the standard, master, snap-pool, or snapshot volumes to delete. For syntax, see Command syntax. Example Delete volumes V1 and - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 63
disks to continue operation, when the vdisk is removed from quarantine it goes offline and its data cannot be recovered. Syntax dequarantine vdisk vdisk Parameters vdisk vdisk Name or serial number , Down) See also • show vdisks HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 63 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 64
exit Description Log off and exit the CLI session. Syntax exit 64 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 65
expand master-volume See expand volume. HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 65 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 66
first expand the vdisk by using expand vdisk. Syntax To expand by a specific size: expand snap-pool size size[B|KB|MB|GB|TB|KiB|MiB|GiB| Expands the volume to fill available space on the vdisk. snap-pool Name or serial number of the snap pool to expand. For syntax, see Command syntax. Example Expand - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 67
vdisk Name or serial number of the vdisk to expand. For syntax, see Command syntax. Example Expand vdisk VD1 to include the disk having ID 11 in the first enclosure: # expand vdisk disks 1.11 VD1 See also • show disks • show vdisks HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 67 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 68
a master volume by using convert std-to-master. Syntax To expand by a specific size: expand volume size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] the volume to fill the available space on the vdisk. volume Name or serial number of the volume to expand. For syntax, see Command syntax. Example Expand - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 69
otherwise, those settings become its default mapping, which specifies the controller host ports and access level that all hosts that are not explicitly mapped. volume Name or serial number of the volume to map. For syntax, see Command HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 69 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 70
See also • show host-maps • show hosts • show volume-maps • show volumes • unmap volume 70 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 71
) to specify the objects to show metadata for. Basetypes are listed in XML API basetypes. Example Show all metadata for objects returned by the show disks command: # meta drives HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 71 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 72
. Syntax ping host-address [count] Parameters host-address The remote host's IP address in dotted decimal form. count Optional. The number of packets to send. The default is 4 packets. Use a small count because the command cannot be interrupted. Example Send two packets to the remote computer at - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 73
. When you perform a manual rescan, it temporarily pauses all I/O processes, then resumes normal operation. Syntax rescan Example Scan for device changes and re-evaluate enclosure IDs: # rescan Success: Command completed successfully HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 73 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 74
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 the host link on port A1: # reset host-link ports A1 Success: Command completed successfully. - Reset Host Link(s) on port(s) a1 from current - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 75
during reset on any operating system can result in data corruption. Is the snapshot unmounted from all operating systems? yes Success: Command completed successfully. - The reset of a snapshot completed. See also • show snapshots HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 75 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 76
Storage Controller or Management Controller in a controller module. If you restart a Storage Controller, it attempts to shut down with a proper failover sequence, which includes stopping all I/O operations and flushing the write cache to disk, and then the controller controller modules, you and users - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 77
command changes how the system operates and might require some reconfiguration to restore host access to volumes. Syntax restore defaults [noprompt] Parameters noprompt Optional. Suppresses the confirmation prompt. See also • restart HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 77 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 78
to proceed. • no: Prevent the rollback from proceeding. If this parameter is omitted, you must reply to the prompt. master-volume Name or serial number of the master volume to roll back. For syntax, type Command syntax. Example Roll back master volume MV1 to snapshot SS1: # rollback master-volume - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 79
Parameters vdisks Names or serial numbers of the vdisks to scrub. Example Scrub the disks in vdisk vd1: # scrub vdisk vd1 Info: Scrub started on vdisk vd1 Success: Command completed successfully. See also • abort scrub • show vdisks HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 79 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 80
[host-cache-control enabled|disabled|on|off] [missing-lun-response notready|illegal] [partner-firmware-upgrade enabled| controller fails. The default is disabled. dynamic-spares enabled|disabled|on|off Optional. Sets whether the storage system will automatically designate a properly sized disk - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 81
-upgrade enabled Info: Command completed successfully. - Parameter 'partner-firmware-upgrade' was set to 'enabled'. Success: Command completed successfully. - The settings were changed successfully. See also • show advanced-settings HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 81 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 82
set auto-write-through-trigger Description Sets the trigger conditions that cause the controller to change the cache policy from write-back to write-through. You can set multiple triggers. By default super-cap-failure and auto-write-back are enabled. Alias: set awt. When the cache mode is changed, - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 83
the controller to dynamically calculate the maximum read-ahead cache size for the volume. • 64KB, 128KB, 256KB, 512KB, 1MB, 2MB, 4MB, 8MB, 16MB, 32MB: Sets a specific cache size. volume Name or serial number of the volume to change. For syntax, type Command syntax. HP StorageWorks 2000 G2 Modular - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 84
, multimedia post-production audio and video editing, and similar applications read and write large files in sequential order. • Transaction-based and database update applications read and write small files in random order. Since the cache block size works in conjunction with the default stripe size - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 85
to use write-back cache is automatically mirrored between the two controllers. Cache redundancy has a slight impact on performance but provides fault tolerance. The operating mode applies per storage system, not per volume. HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 85 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 86
recipient name; typically the recipient's IQN. The name can have a maximum of 223 bytes, including 0-9, lowercase a-z, hyphen, colon, and period. A storage system's IQN is a controller host-port name without its .a or .b suffix; see the Port-Name field shown by the show host-parameters command. This - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 87
display language. pager enabled|on|disabled|off Optional. Specifies whether to halt output after each full screen to wait for keyboard input. Enabled by default. When using API mode, which is intended for scripting, disable paging. HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 87 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 88
number of decimal places (1-10) for display of storage-space sizes. storage-size-base 2|10 Optional. Alias for base. storage-size-precision # Optional. Alias for precision. storage The default is 1800 seconds (30 minutes). units auto|MB|GB|TB Optional. Sets the unit for display of storage-space - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 89
Set CLI to show output in console mode: # set cli-parameters console Success: Command completed successfully. - The settings were changed successfully. See also • show cli-parameters HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 89 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 90
and time for each Management Controller and then updates the date and time for each Storage Controller. Syntax set controller-date jan|feb|mar|apr minutes (0-59), and the seconds (0-59). year The year as a four-digit number. time-zone The system's time zone based on an offset from Universal Time (UT - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 91
direction from a service technician. Sets the types of debug messages to include in the Storage Controller debug log. If Internal Configuration API tracing debug messages • disk: Disk interface debug messages • dms: Snapshot parameters HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 91 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 92
Disks equipped with this technology can alert the controller of impending disk failures. Changes to the SMART setting take effect after a rescan or a controller restart. Syntax set disk disks in the storage system. Each disk added after detect-only is set retains its SMART setting. Enabled by default - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 93
should send notifications: Informational (info), Warning (warn), Critical (crit). The default is none, which disables email notification and clears the settings. sender sender Optional . See also • show email-parameters • test HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 93 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 94
rack-position rack-position The enclosure's position in the rack, from 0-255. enclosure-number The enclosure ID. Example Set parameters for enclosure 1: # set enclosure name Storage-5 location Lab rack-number 9 rack-position 3 1 Success: Command completed successfully. See also • show enclosures 94 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 95
-in thresholds, the PHY is disabled to maintain storage system operation. While troubleshooting a storage system problem, a service technician can use this command to temporarily disable fault isolation for a specific Expander Controller in a specific enclosure. NOTE: If fault isolation is disabled - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 96
or with direction from a service technician. Disables or enables a specific PHY. Syntax set expander-phy encl enclosure-ID controller a|b|both type phy-type phy 0x8003 Enable the PHY for disk 5 in controller B, and check the resulting status: # set expander-phy encl 1 controller b type drive phy 5 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 97
is the default. • openvms: The host does not allow LUN 0 to be assigned to a mapping. • hp-ux: HP-UX: # set host-name id Host1 profile hp-ux MyHost Success: Command completed successfully. - The host was renamed. See also • show hosts HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 98
/sec or lets the speed be auto-negotiated (auto). ports #|all Optional. Specific host port numbers or all ports. For syntax, see Command syntax. If this parameter is omitted, all host ports on the specified controllers are affected. fibre-connection-mode loop|point-to-point Optional. For FC, sets - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 99
when controllers arbitrate during a LIP. Use this option if you want ports to have specific addresses, loop ids will not take effect until the affected Storage Controller is restarted. Success: Command completed successfully. - The HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 99 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 100
negotiate the proper speed, or to 1 Gbit/sec (1g). The default is auto. 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 address of an - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 101
scrub' was set to 'on'. Info: Command completed successfully. - Parameter 'partner-firmware-upgrade' was set to 'off'. Success: Command completed successfully. - The settings were changed successfully. See also • show job-parameters HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 101 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 102
state of the Unit Identification (UID) LED on a specified disk or enclosure. LEDs are described in the user guide. Syntax To set a disk LED: set led disk ID on|off To set an enclosure LED: set led enclosure ID on|off Parameters disk ID The disk to locate. For syntax, see Command syntax. enclosure ID - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 103
DHCP for both controllers, if it was enabled): # set network-parameters ip 192.168.0.10 netmask 255.255.255.0 gateway 192.168.0.1 controller a Success: Network parameters have been changed See also • show network-parameters HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 103 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 104
19 bytes. user Optional. The user name to set the password for. If this argument is omitted, this command affects the logged-in user's password. Example Change the password of the default user, monitor: # set password monitor Info: Changing password for user monitor. Enter new password:**** Re-enter - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 105
which can include any valid UTF-8 characters except backslash, double quote, and control characters, and can have a maximum of 16 bytes. A prompt that includes command: # set prompt "" Success: Command completed successfully set ... HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 105 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 106
disabled|on|off Optional. Enables or disables the expert interface for updating firmware. http enabled|disabled|on|off Optional. Enables or disables the Services interface. smis enabled|disabled|on|off Optional. Enables or disables the Storage Management Initiative Specification interface. snmp - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 107
snap pool's default error policy is deleteoldestsnapshot and default critical policy If no unit is specified, the unit is blocks. snap-pool Name or serial number of the snap pool to set the policy for. For syntax, see Command pools HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 107 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 108
. error #% The percent of snap-pool space used that triggers the error threshold policy. This value must be less than 99%. snap-pool Name or serial number of the snap pool to set the threshold for. For syntax, see Command syntax. Example Set the warning and error thresholds for snap pool SP1 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 109
Optional. Replaces the current snmp-parameters enable crit add-trap-host 172.22.4.171 read-community public Success: Command completed successfully. - SNMP parameters were changed. See also • set protocols • show snmp-parameters • test HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 110
as spares, or none to delete all global spares if no vdisk is specified or all dedicated spares for a specified vdisk. For disk syntax, see Command syntax. vdisk vdisk Optional. Name or serial number of the vdisk to assign spares to. For syntax, see Command syntax. If this parameter is omitted, the - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 111
Set the system name to Test and the contact to J. Doe: # set system name Test contact "J. Doe" Success: Command completed successfully See also • show system HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 111 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 112
Disk drives usually show size in base 10. Memory size is always shown in base 2. interfaces values Optional. Specifies the interfaces that the user can and re-enter a password for the user. precision # Optional. Sets the number of decimal places (1-10) for display of storage-space sizes. session- - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 113
the user profile to change. Names are case sensitive. Example Change a user's type and interface access: # set user jsmith type advanced interfaces wbi,cli Success: User-Type set to advanced. See also • set password • show users HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 113 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 114
stop host I/O to the vdisk's volumes. Volume mappings are not affected. vdisk Name or serial number of the vdisk to change. For syntax, see Command syntax. Example Rename vdisk VD1 and change its owner to controller A: # set vdisk name VD2 owner a VD1 Success: Command completed successfully See also - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 115
Name or serial number of the volume to change. For syntax, see Command syntax. Example Rename volume V1 to V2: # set volume name V2 V1 Success: Command completed successfully. - The volume was set. See also • show host-maps • show volumes • show volume-maps HP StorageWorks 2000 G2 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 116
-settings Output Background Scrub Shows whether disks are automatically checked for disk defects to ensure system health. Partner Firmware Upgrade Shows whether component firmware versions are monitored and will be automatically upgraded on the partner controller. Utility Priority Priority at which - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 117
Not Ready Controller Failure: Disabled SuperCap Failure: Enabled CompactFlash Failure: Enabled Power Supply Failure: Disabled Fan Failure: Disabled Temperature Exceeded: Disabled Partner Notify: Disabled Auto Write Back: Enabled See also • set advanced-settings HP StorageWorks 2000 G2 Modular Smart - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 118
-write-through-trigger Description Shows the system's write-through trigger settings. When a trigger condition occurs and the trigger is enabled, the RAID controller cache mode changes from write-back to write-through. Alias: show awt. Syntax show auto-write-through-trigger Example Show the system - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 119
Shows whether cache flush is enabled for the controller Volume cache parameters: Serial Number If a volume is specified, its serial number Name If a volume is specified, its name If a volume is specified, its read-ahead cache setting HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 119 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 120
Flush: Enabled Controller B Cache Parameters Write Back Status: Enabled CompactFlash Status: Installed Cache Flush: Enabled Volume Cache Parameters Serial Number: 00c0ff0a906b0000dcaa834701000000 Name: V1 Cache Write Policy: write-back Cache Optimization: standard Read Ahead Size: Default See also - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 121
Example Show the CHAP record for a specific host initiator: # show chap-records name storage.00c0ffd6000a Mutual CHAP Secret: ABCdef123456 See also • create chap-record • delete chap-records • set chap-record • show host-parameters HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 122
, and must be specified, with the format enclosure-ID.disk-slot-number. For example, the second disk in the first enclosure has address 1.2. Locale Display language. Precision Number of decimal places shown for storage sizes. Units • auto: Storage sizes are shown in units determined by the system - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 123
parameters CLI Parameters Timeout: 1800 Output Format: console Brief Mode: disabled Base: 10 Pager: enabled Disk Mode: enclosure-slot Locale: English Precision: 1 Units: Auto Temperature Scale: Celsius See also • set cli-parameters HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 123 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 124
show ports • Disk information from show disks • Disk information by enclosure from show disks with the encl option • Vdisk information from show vdisks • Enclosure status information, including SCSI Enclosure Services (SES) data from show enclosure-status • Field-replaceable unit (FRU) information - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 125
time zone, shown as an offset in hours from Universal Time (UT) Example Show the system date and time: # show controller-date Controller Date: 2008-06-09 10:58:04 Time-Zone Offset: -6 See also • set controller-date • show ntp-status HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 125 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 126
information about each controller in the storage system. Syntax show controllers Output Controller ID Serial Number Hardware Version CPLD Version MAC Address WWNN IP Address IP Subnet Mask IP Gateway Disks Number connected to this controller Vdisks Number owned by this controller Cache Memory Size - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 127
IP Gateway: 10.134.0.1 Disks: 17 Vdisks: 2 Cache Memory Size (MB): 1024 Host Ports: 4 Disk Channels: 2 Disk Bus Type: SAS Status: Running Failed Over: No Fail Over Reason: Not applicable See also • show configuration • show frus HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 127 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 128
from a service technician. Shows which debug message types are enabled (on) or disabled (off) for inclusion in the Storage Controller debug log . Syntax show debug-log-parameters Example Show debug log parameters: # show debug-log-parameters Host: on Disk: on mem - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 129
Attempt Timeout and Number of Retries settings. Example Show disk settings: # show disk-parameters Disk Parameters SMART: Enabled Drive Write Back Cache: Disabled Timeout Retry Maximum: 3 Attempt Timeout: 8 Overall Timeout: 105 See also • set disk-parameters HP StorageWorks 2000 G2 Modular Smart - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 130
the specified vdisk. For syntax, see Command syntax. Output Without the encl option: Location Disk's enclosure and slot number Serial Number Disk serial number Vendor Disk vendor Rev Firmware revision number How Used • AVAIL: Available • GLOBAL SP: Global spare • LEFTOVR: Leftover • VDISK: Used in - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 131
Show information for all disks, by enclosure: # show disks encl Status Encl Slot Vendor Model Serial Number Size OK 1 1 vendor model SN 146.8GB ... Missing 1 3 N/A N/A N/A N/A ... See also • show vdisks HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 131 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 132
show email-parameters Description Shows SMTP parameters for event notification. Syntax show email-parameters Example Show settings for email notification of events: # show email-parameters Email Parameters (SMTP Email Notification: enabled Email Notify Filter: warn Email Address 1: sysadmin@ - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 133
not that the temperature is within an acceptable range. • N/A: Status is not available. FRU P/N Part number of the field-replaceable unit (FRU) that contains the component FRU S/N Serial number of the FRU that contains the component HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 133 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 134
a system with a controller enclosure and an MSA70 drive enclosure: # show enclosure-status Chassis Vendor Product ID CPLD EMP A Disk 01 OK PN SN addr=0 Disk 02 OK PN SN addr=1 ... Chassis Vendor Product ID CPLD EMP A BUS:ID Rev EMP B BUS:ID Rev WWPN Status Health N/A HP - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 135
: # show enclosures Encl Encl WWN Name Location Rack Pos Vendor Model EMP A BUS:ID Rev EMP B BUS:ID Rev 1 WWN Controller Lab 0 4 vendor model 0:31 1030 1:31 1030 See also • set enclosure • show enclosure-status HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 135 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 136
code identifying the type of event to help service technicians diagnose problems; for example, [181] • Event ID prefixed by A or B, indicating which controller logged the event; for example, #A123 • Model, serial number, and ID of the controller module that logged the event • Severity: CRITICAL - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 137
:00 a.m. on May 2, 2008: # show events from 043008235900 to 050208115900 Show a range of events logged by controller A: # show events from-event a100 to-event a123 See also • clear events • set snmp-parameters • show snmp-parameters HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 137 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 138
service technician. Shows diagnostic information relating to SAS Expander Controller user or by the system. Elem Status A standard SES status for the element: • Disabled: Critical condition is detected. • Error: Unrecoverable condition is detected. Appears only if there is a firmware problem - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 139
control page. • 0x8004: PHY is enabled but not ready. Appears for SC-1 PHYs when the partner I/O module is not installed. Appears for Drive, SC-1, or Ingress PHYs when a connection problem expander-fault-isolation • set expander-phy HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 139 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 140
service technicians. Syntax show frus Output Name • CHASSIS_MIDPLANE: 2U chassis and midplane circuit board • RAID_IOM: Controller module • BOD_IOM: Expansion module • POWER_SUPPLY: Power supply module Description FRU description Part Number FRU part number Serial Number FRU serial number Revision - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 141
. Serial Number Serial number of the volume seen by the host. LUN LUN used to access the volume. Access Type of host access to the volume: • read-write: Read and write • read-only: Read only • none: No access Ports Controller host ports that the mapping applies to. HP StorageWorks 2000 G2 Modular - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 142
-write A1 vd2_v1 00c0ff28201500485b87a94802000000 11 read-write A1 Host View [ID (1A2B3C4D5E6F8900) Name (Host2) Profile (HP-UX) ] Mapping: Name Serial Number LUN Access Ports vd2_v2 00c0ff28201500485b87a94803000000 0 read-write A1,A2,B1,B2 vd2_v0 00c0ff28201500485b87a94801000000 10 read - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 143
.a for ports on controller A or .b for ports on controller B. Target Alias iSCSI only. Target alias for the port. The alias is the storage system's name with the suffix .a for ports on controller A or .b for ports on controller B. HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 143 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 144
PID A1 FC(L) 207000C0FF000015 OK 2Gb Auto Loop 0 A2 FC(L) 217000C0FF000015 OK 2Gb Auto Loop 1 Show host parameters for a controller with four SAS ports: # show host-parameters Port Media Target ID Status Speed(A) Speed(C) Topo(C) Width A1 SAS 500C0FF000013000 Disconnected - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 145
: The host was discovered and its entry was automatically created. • No: The host entry was manually created. Mapped Shows whether the host is explicitly mapped to any volumes: • Yes: At least host • delete host • set host-name HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 145 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 146
-parameters Output CHAP Whether Challenge-Handshake Authentication Protocol is enabled or disabled Jumbo Frames Whether jumbo-frame support is enabled or disabled iSNS Whether Internet Storage Name Service support is enabled or disabled iSNS IP Address of the iSNS server iSNS Alt IP Address of the - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 147
's processors: High, Medium, or Low. Example Show a system's job parameters: # show job-parameters Job Parameters Background Scrub: Disabled Partner Firmware Upgrade: Enabled Utility Priority: High See also • set job-parameters HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 147 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 148
Shows the status of licensed features in the storage system. Syntax show license Output License Key • The license key, if a license is installed and valid • not installed, if a license is invalid or is not installed Base Maximum Snapshots Number of snapshots allowed without an installed license - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 149
volumes associated with snap pool SP1: # show master-volumes snap-pool SP1 Vdisk Serial Number Name Size Status Status-Reason Snap-pool Name Snapshots Snap Data Rollback VD1 SN MV1 20.0GB Available -- SP1 1 0B --- HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 149 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 150
See also • convert master-to-std • create master-volume • delete all-master-volumes • delete master-volume • expand volume • rollback master-volume 150 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 151
C0:FF:0A:43:18 Addressing Mode: Manual Network Parameters Controller B IP Address: 172.22.1.201 Gateway: 172.22.1.1 Subnet Mask: 255.255.255.0 MAC Address: 00:C0:FF:0A:43:26 Addressing Mode: Manual See also • set network-parameters HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 151 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 152
Status ---------Status: activated Client Task Status: present NTP Server Address: 69.10.36.3 Last Server Contact: 2008-12-04 16:24:42 See also • set controller-date 152 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 153
Serial Attached SCSI • iSCSI: Internet SCSI Target ID Enclosure WWN or serial number Status Whether the port is operational, has a problem . MAC iSCSI only. Unique Media Access Control (MAC) hardware address, also called the HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 153 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 154
Show port information for a system with four SAS ports: # show ports Port Media Target ID Status Speed(A) Speed(C) Topo(C) Width A1 SAS 500C0FFD41011000 Disconnected Direct 4 A2 SAS 500C0FFD41011100 Disconnected Direct 4 A3 SAS 500C0FFD41011200 Disconnected Direct 4 A4 SAS - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 155
Disabled Simple Network Management Protocol (SNMP): Enabled Service Interface (Service): Disabled Service Debug (Debug): Disabled In-band SES Management (SES): Enabled In-band CAPI Management (CAPI): Enabled See also • set protocols HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 155 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 156
In single-controller mode, the controller is operational. Controller ID Status • Operational: The controller is operational. • Down: The controller is installed but not operational. • Not Installed: The controller is not installed. Controller ID Serial Number • Controller module serial number • Not - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 157
show refresh-counters Description For API use, shows when the data represented by the base type was last updated. Syntax show refresh-counters HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 157 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 158
port on an expansion module. • In Port: Ingress port on an expansion module. Can be connected to an egress (expansion) port on a controller module or an expansion module. Status Status of the connection: • OK • Disconnected • Not Present • Warning • Error • Unknown Health Relative status of the - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 159
Serial Prefix Count Last Created VD1_V1 00c0ff2824460048904eba4901000000 T1 1 none Snapshot Name Snapshot Serial T1_S0001 00c0ffd2710700482ce3de4501000000 See also • create schedule • delete schedule • show schedules HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 160
two existing task schedules: # show schedules Schedules --------Schedule Name: Sched1 Schedule Specification: Start 2/19/2007 23:47:00, Every 3 Minutes Schedule Status: Serial Prefix Count Last Created VD1_V1 00c0ff2824460048904eba4901000000 T1 1 T1_S0001 Snapshot Name Snapshot Serial - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 161
• N/A: Status is not available Example Show temperature and voltage status for the controllers and power supplies: # show sensor-status Sensor Name Value Status CPU Temperature-Ctlr OK Voltage 3.3V Loc:left-PSU 1 3.49 OK HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 161 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 162
Voltage 12V Loc:right-PSU 2 12.02 OK Voltage 5V Loc:right-PSU 2 5.16 OK Voltage 3.3V Loc:right-PSU 2 3.49 OK Current 12V Loc:upper-IOM 3.89 OK Current 12V Loc:lower-IOM 4.95 OK Current 12V Loc:left-PSU 1 6.15 OK Current 5V Loc:left-PSU 1 6.67 OK Current 12V Loc:right-PSU 2 6.15 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 163
Storage Controller is active or shut down. Syntax show shutdown-status Example Show the shutdown status for each controller: # show shutdown-status storage controller A is up storage controller B is down See also • restart • shutdown HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 164
when the AutoExpand policy is active; otherwise its value is N/A. Example Show information for snap pools owned by controller A: # show snap-pools controller a Vdisk Serial Number Name Size Free MasterVols Snapshots R5 SN SP1 374.6GB 374.6GB 1 2 Threshold %Usage Policy SizeToExpand - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 165
that the snapshot was taken of Snap-pool Name Snap pool name Snap Data Total amount of preserved and write data associated with the snapshot HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 165 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 166
this snapshot and other snapshots Example Show information about snapshots associated with snap pool SP2: # show snapshots snap-pool SP2 Vdisk Serial Number Name Creation Date/Time Status Status-Reason Master Volume Name Snap-pool Name Snap Data UniqueData SharedData VD1 SN SS1 2008-03 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 167
SNMP: enabled SNMP Filter: crit SNMP Trap Host IP1: 172.22.4.171 SNMP Trap Host IP2: 0.0.0.0 SNMP Trap Host IP3: 0.0.0.0 SNMP read community: public SNMP write community: private See also • set snmp-parameters • show protocols HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 168
information, including installed languages (supported locales): # show system System Information System Name: Storage-1 System Contact: J. Smith System Location: Main lab System Information: Used for order processing data Vendor Name: vendor Product ID: product Product Brand: brand SCSI Vendor ID - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 169
Enabled: true Number of Host Ports: 4 Maximum Disks: 108 Maximum Volumes: 512 Maximum Vdisks: 32 Maximum LUNs: 512 Maximum Vdisks Per Controller: 16 Local Controller: A Serial Number: 000013 See also • set volume • set vdisk HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 169 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 170
: Init, Vol Verified, License Checked, Name Created, Snap Created, Snap Verified 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_s001 through prefix_s1023. Count - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 171
: Init, Snap Verified Snapshot Name Name of the snapshot to reset Snapshot Serial Serial number of the snapshot to reset Error Message Any error message associated with this task For a Any error message associated with this task HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 171 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 172
Name: Snap Task Type: TakeSnapshot Task Status: Ready Task State: Init Source Volume Source Volume Serial Prefix Count Last Created VD1 SN VD1 1 VD1_S0001 Snapshot Name Snapshot Serial VD1_S0001 SN See also • create schedule • create task • delete task • show schedules • show tasks - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 173
Count Last Created VD1 SN VD1 1 VD1_S0001 Snapshot Name Snapshot Serial VD1_S0001 SN Task Name: v1_v002_task001 ... See also • create task • create schedule • delete task • show schedule-details • show task-details HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 173 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 174
: Has access to standard, advanced, and troubleshooting functions User Locale Display language for this user WBI x indicates user can use the web-browser interface (SMU) CLI x indicates user can use the command-line interface FTP x indicates user can use the file transfer protocol interface - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 175
. Names or serial numbers of the vdisks controller when the preferred owner is offline Pref Controller that owns the vdisk and its volumes during normal operation RAID Vdisk RAID level Disks Number of disks in the vdisk Spr Number HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 175 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 176
Serial Number Vdisk serial number Example Show information about vdisk VD1 only: # show vdisks VD1 Name Size Free Own Pref RAID Disks Spr Chk Status Jobs Serial Number VD1 587.1GB 116.7GB B B RAID50 6 0 128k FTOL VRSC 41% SN See also • create vdisk • delete vdisk • expand vdisk • - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 177
the volume's default mapping Nickname Serial Number (SN) Name (v2) ] Mapping: Ports LUN Access Host-Port-Identifier Nickname Profile not-mapped all other hosts Standard See also • show host-maps • show hosts • show volumes HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 178
resumes from the point where it stopped. Example Show information about volume copies in progress for controller A: # show volumecopy-status controller a VC Volume Name Serial Number Vdisk Source Volume Progress Status Status-Reason MV1-copy SN VD1 MV1 7% Unavailable VC In Progress - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 179
of the volume Size Volume size Serial Number Volume serial number WR Policy Write-back cache mode (write-back or write-through) Cache Opt Read-ahead cache mode (standard or super-sequential) Read Ahead Size • Disabled • Default • Maximum • Specific size Type • standard: Standard volume • standard - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 180
Ahead Size Type Class Volume Description VD1 V0 20.0GB SN write-back standard Default standard standard Show volume information for vdisk VD1 only: # show volumes vdisk VD1 Vdisk Name Size Serial Number WR Policy Cache Opt Read Ahead Size Type Class Volume Description VD1 V0 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 181
the Storage Controller in controller A, B, or both. Example Shut down the Storage Controller in controller A: # shutdown a Info: Shutting down SC a... Success: Command completed successfully See also • restart • show shutdown-status HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 181 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 182
terminal can display. The terminal usually sets this value; this is an override. The info parameter shows this as screen height. columns # Sets the number of columns that a terminal can display. The terminal usually sets this value; this is an override. The info parameter shows this as screen width - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 183
interprets as a problem with the "late" disks. In this case, the vdisk functions normally after being trusted. • A vdisk is offline because a disk is failing, you serial number of the vdisk to trust. For syntax, see Command syntax. HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 183 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 184
disk VD1 has been trusted. See also • show vdisks unmap volume Description Deletes an explicit mapping whose settings override a volume's default mapping. When the explicit mapping is deleted, host access to the volume is controlled by the volume's default volume Name or serial number of the volume - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 185
Controller Code Version: ver Management Controller Loader Code Version: ver Expander Controller Code Version: ver CPLD Code Version: ver Hardware Version: ver Host Interface Module Version: ver Host Interface Module Model: ver HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 186
destination volume you specify, which must be in a vdisk owned by the same controller as the source volume. While the copy operation is in progress, the destination volume yes|no] volume2 Parameters source-volume volume1 Name or serial number of the snapshot or master volume to copy. For syntax, see - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 187
See also • abort volumecopy • create task • show vdisks • show volumecopy-status • show volumes HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 187 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 188
188 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 189
with CHAP, a password that is shared between an initiator and a target to enable authentication. SCSI Enclosure Services. A single-port disk is connected to both controllers so its data path is not fault tolerant. A single-port disk's type is shown as SAS-S or SATA-S. HP StorageWorks 2000 G2 Modular - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 190
is also called orphan data. vdisk A "virtual" disk comprising the capacity of one or more disks. The number of disks that a vdisk can contain is determined by its RAID level. volume A portion of the capacity of a vdisk that can be presented as a storage device to a host. volume copy Licensed - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 191
12 scripting guidelines 14 set base for storage-space sizes 87 set disk-addressing mode 87 set locale 87 set commands API-specific 24 CLI and user 23 disk and vdisk 23 event notification 24 scheduled task 24 service utilities HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 191 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 192
isolation 95 show status 138 explicit mapping 69 F failover status and reason show controller 126 fan failure trigger enable/disable 80, 82 show setting 116 field-replaceable unit See FRUs firmware show versions 185 firmware update, partner enable/disable 81, 101 show setting 116, 147 FRUs show 140 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 193
112 show user 174 masked volume 69 master volume expand 68 roll back data 78 master volumes convert to standard 33 create 37 delete 54 delete all 50 show 149 metadata clear disk 30 midplane show abbreviated serial number 169 missing LUN response set 80 show 116 HP StorageWorks 2000 G2 Modular Smart - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 194
firmware update enable/disable 81, 101 show setting 116, 147 password set user 43, 104, 112 PHYs enable/disable fault isolation 95 enable/disable specific refresh counters, show 157 related documentation 9 rescan disk channels 73 restore system defaults 77 revert volume data See roll back volume - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 195
81, 101 show 116, 147 V vdisk abort scrub 26 abort verification 27 syntax 19 trust for emergency data collection 183 verify 185 vdisks analyze for disk defects 79 create 45 delete 61 expand 67 remove from quarantine 63 HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 195 - HP StorageWorks MSA2312fc | HP StorageWorks 2300 Family Modular Smart Array CLI - Page 196
set name 114 set owning controller 114 show 175 show maximum number of 169 show maximum number per controller 169 start manual scrub 79 verification abort vdisk 27 versions show hardware and firmware 185 virtual disk name 19 serial number 19 voltages show component 161 volume abort copy 28 convert
HP StorageWorks
2000 G2 Modular Smart Array
CLI Reference Guide
Part number: 500912-002
Second edition: September 2009