About this guide This guide provides information about managing an HP P2000 G3 MSA System by using its command-line interface (CLI). Intended audience This guide is intended for storage system administrators. Prerequisites Prerequisites for using this product include knowledge of: •...
Document conventions and symbols Table 1 Document conventions Convention Element Medium blue text: Figure 1 Cross-reference links and e-mail addresses Medium blue, underlined text Web site addresses (http://www.hp.com) Bold font • Key names • Text typed into a GUI element, such as into a box •...
• http://www.hp.com/support/downloads • http://www.hp.com/storage/whitepapers • http://www.hp.com/go/p2000 Documentation feedback HP welcomes your feedback. To make comments and suggestions about product documentation, please send a message to storagedocs.feedback@hp.com. All submissions become the property of HP. HP P2000 G3 MSA System CLI Reference Guide...
Using the CLI This chapter introduces the HP P2000 G3 MSA System command-line interface (CLI). Accessing the CLI The CLI software embedded in the controller modules enables you to manage and monitor storage-system operation. You can access the CLI in two ways: •...
Using CLI interactively By default the CLI is an interactive application. When you are logged into the CLI, the CLI waits for a command to be entered and then responds to it. The following example shows interactively starting a Telnet session, logging into the CLI, executing a command to show free (available) disks, and exiting the CLI: $: telnet 172.22.5.55 172.22.5.55 login: monitor...
Page 17
@objects = $root->getElementsByTagName('OBJECT'); my @props = $objects[0]->getElementsByTagName('PROPERTY'); my $sessionKey; foreach my $prop ( @props ) { my $name = $prop->getAttribute('name'); print "Property = " . $name . "\n"; if( $name eq 'response' ) { HP P2000 G3 MSA System CLI Reference Guide...
CLI when XML API format is enabled. By obtaining the latest DTD for validation, the parser will be forward compatible. To obtain the DTD, go to http://hp.com/go/p2000. The output of each CLI command is composed of valid XML data until the CLI prompt (typically #) is encountered.
In a script, each command should check the previous command’s status before proceeding. If the value of the status object’s return-code property is 0, the command succeeded; any other value means that the command failed. XML API examples The following example shows the same command, formatted for use with the command-line interface or for use with the HTTP interface, and its XML API output.
A comma-separated list of individual disks, ranges, or both (with no spaces). Example: 1.4,1.6-9 • A RAID 10 or 50 vdisk, with disks in sub-vdisks separated by colons (with no spaces). RAID-50 example: 1.1-3:1.4-6:1.7,1.10-11 HP P2000 G3 MSA System CLI Reference Guide...
Vdisks You can specify: • A vdisk by its name or serial number. A unique serial number is automatically assigned when a vdisk is created, and does not change for the life of the vdisk. • A list of vdisk names or serial numbers separated by commas (with no spaces). Not all commands support lists.
Table 6 Decimal (radix) point character by locale Language Character Examples English, Chinese, Japanese, Korean Period (.) 146.81 GB 3.0 Gb/s Dutch, French, German, Italian, Spanish Comma (,) 146,81 GB 3,0 Gb/s HP P2000 G3 MSA System CLI Reference Guide...
Event log A controller enclosure’s event log records all events that have occurred in or been detected by the controller modules and encompasses all field-replaceable units (FRUs) in the storage system. Each event has one of the following levels, in decreasing severity: •...
Page 26
Table 7 Commands by category (continued) Category Commands Volume copy abort volumecopy show volumecopy-status create volume-copy volumecopy Scheduled create schedule set task tasks create task show schedule-details delete schedule show schedules delete task show task-details set schedule show tasks Event set email-parameters show events notification...
None set host-wwn-name set host-name set iscsi-host set host-name HP P2000 G3 MSA System CLI Reference Guide...
Page 28
Table 8 Replaced or removed commands (continued) Old command New command set output-format set cli-parameters set replication-external-view set replication-primary-volume set snap-pool policy set snap-pool-policy set snap-pool threshold set snap-pool-threshold set vdisk-spare set spares show channels show ports show drive-parameters show disk-parameters show host-port-interconnects None show host-wwn-names show hosts...
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 References to commands that are used with the command HP P2000 G3 MSA System CLI Reference Guide...
abort replication Description Aborts the current replication operation on the specified replication volume. The current replication may be running or suspended. This command must be issued on the system that owns the secondary volume. Syntax abort replication [set replication-set] replication-volume Parameters set replication-set Optional.
Names or serial numbers of the vdisks to stop scrubbing. For vdisk syntax, see Command syntax page 21. Example Abort scrubbing vdisk vd1: # abort scrub vdisk vd1 Info: Scrub was aborted on vdisk vd1. See also • scrub vdisk • show vdisks HP P2000 G3 MSA System CLI Reference Guide...
21. Example Abort creating destination volume vd1_copy: # abort volumecopy v1_copy Success: Command completed successfully. - The volume copy was aborted. See also • show volumecopy-status • show volumes • volumecopy HP P2000 G3 MSA System CLI Reference Guide...
add replication-volume Description Adds an existing secondary volume to a replication set. The volume can be on the same system as the primary volume or on a remote system. A secondary volume is a master volume created specifically for use as the destination for a replication by using the create master-volume command's prepare-replication-volume...
Page 35
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 • show replication-sets • show replication-volumes HP P2000 G3 MSA System CLI Reference Guide...
clear cache Description Clears unwritable cache data from both controllers. This data cannot be written to disk because it is associated with a volume that no longer exists or whose disks are not online. If the data is needed, the volume's disks must be brought online. If the data is not needed it can be cleared, in which case it will be lost and data will differ between the host and disk.
----------------------..LEFTOVR ... VDISK Clear metadata from a leftover disk: # clear disk-metadata 1.1 Updating disk list... Info: Disk 1.1 metadata was cleared. Success: Command completed successfully. - Metadata was cleared. HP P2000 G3 MSA System CLI Reference Guide...
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. - Disk 1.2 metadata was NOT cleared. Error: The specified disk is not a leftover disk. (1.2) - Metadata was not cleared for one or more disks.
Optional. The controller event log to clear. If this parameter is omitted, both event logs are cleared. Example Clear the event log for controller A: # clear events a Info: Controller A event log was successfully cleared. Success: Command completed successfully. See also • show events HP P2000 G3 MSA System CLI Reference Guide...
clear expander-status Description For use by or with direction from a 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 enclosure whose status is Error as shown by the show expander-status command.
Example Convert a master volume having no snapshots to a standard volume: # convert master-to-std MV1 Success: Command completed successfully. - The conversion of a master volume to a standard volume completed. See also • delete all-snapshots • show master-volumes HP P2000 G3 MSA System CLI Reference Guide...
convert std-to-master Description Converts a standard volume to a master volume; that is, it enables the volume for snapshots and associates it with an existing snap pool. The standard volume and the snap pool must be owned by the same controller, though they can be in different vdisks. Syntax convert std-to-master snap-pool snap-pool...
# create chap-record name iqn.1991-05.com.microsoft:myhost.domain secret 123456abcDEF Success: Command completed successfully. - A CHAP record was created. See also • delete chap-records • set chap-record • show chap-records • show host-parameters • show iscsi-parameters HP P2000 G3 MSA System CLI Reference Guide...
create host Description Creates a host entry with an associated nickname. Use this to create an entry for a host that is not automatically discovered. When mapping volumes to hosts the nickname can make a host easy to recognize. Syntax create host id ID nickname...
A name for the new volume. The name is case sensitive; cannot include a comma, double quote, or backslash; and can have a maximum of 20 bytes. A name that includes a space must be enclosed in double quotes. HP P2000 G3 MSA System CLI Reference Guide...
Page 46
Example Create the 20-GB master volume MV1 on vdisk VD1, and associate it with snap pool SP1: # create master-volume vdisk VD1 size 20GB snap-pool SP1 lun 3 MV1 Success: Command completed successfully. (MV1) - The master volume was created. Create the 50-GB replication volume MV2 on vdisk VD1, and automatically create an associated 20-GB snap pool: # create master-volume vdisk VD1 size 50GB prepare-replication-volume reserve...
# create remote-system username manage password !manage 10.122.1.21 Success: Command completed successfully. (10.122.1.21) - The remote system was created. See also • delete remote-system • remote • set remote-system • show remote-systems HP P2000 G3 MSA System CLI Reference Guide...
create replication-set Description Creates a replication set from a specified standard or master volume. If you specify a standard volume, it is converted to a master volume using default policies for snap-pool creation. You can optionally use the reserve parameter to set the snap-pool size. The specified volume becomes the replication set's primary volume.
Page 49
If no unit is specified, the unit is 512-byte blocks. If this parameter is omitted, the size will be either 20% of the volume size or the minimum snap-pool size, whichever is larger. HP P2000 G3 MSA System CLI Reference Guide...
Page 50
secondary-address ip=IPs|wwnn=WWNNs|wwpn=WWPNs Optional if the MCs can communicate and the remote-system parameter is specified; required if the MC cannot communicate and a replication-prepared volume is specified. Specifies host ports on the remote system by IP address, World Wide Node Name, or World Wide Port Name. An IP address value can include a port number;...
Page 51
# create replication-set link-type FC remote-volume Test-backup Test See also • add replication-volume • delete replication-set • remove replication-volume • replicate snapshot • show remote-systems • show replication-images • show replication-sets • show replication-volumes HP P2000 G3 MSA System CLI Reference Guide...
create schedule Description Schedules a task to run automatically. When scheduling ReplicateVolume tasks, a best practice is to schedule no more than three volumes to start replicating at the same time, and for those replications to recur no less than 60 minutes apart.
Page 53
Error: create schedule: (Sched3) - The specified start time must be within the range specified with the 'between' parameter. See also • show schedule-details • show schedules • show task-details • show tasks HP P2000 G3 MSA System CLI Reference Guide...
create snap-pool Description Creates a snap pool to use for snapshot data. A snap pool is an internal volume and cannot be mapped. Syntax create snap-pool vdisk vdisk size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] name Parameters vdisk vdisk Name or serial number of the vdisk to create the snap pool in. For vdisk syntax, see Command syntax on page 21.
Example Create snapshots of standard volume V1 and master volume V2: # create snapshots volumes V1,V2 V1snap,V2snap Info: Snap pool spV1 was created. Success: Command completed successfully. (V1snap,V2snap) - Snapshot(s) were created. See also • show snapshots • show volumes HP P2000 G3 MSA System CLI Reference Guide...
create task Description Creates a task that can be scheduled. You can create a task to take a snapshot of a standard or master volume; to copy a standard, master, or snapshot volume to a new standard volume; to replicate a replication set's primary volume to a remote system; to reset a snapshot; or to enable or disable disk spin-down.
Page 57
Name or serial number of the destination vdisk for the volume copy. For vdisk syntax, see Command syntax on page 21. dest-prefix prefix A label to identify the volume copy created by this task. Copy names have the format prefix_c#, where # starts at 001. HP P2000 G3 MSA System CLI Reference Guide...
Page 58
modified-snapshot yes|no Optional. Specifies whether to include or exclude modified write data from the snapshot in the copy. This parameter applies only when the source volume is a snapshot; it is ignored if the source volume is a master volume. •...
# 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. HP P2000 G3 MSA System CLI Reference Guide...
Page 60
storage-size-precision # Optional. Alias for precision. storage-size-units auto|MB|GB|TB Optional. Alias for units. temperature-scale celsius|c|fahrenheit|f Optional. Specifies to use the Celsius scale or Fahrenheit scale for temperature values. Default is Celsius. timeout # Optional. Sets the timeout value in seconds for the login session. Valid values are 120–43200 seconds (2–720 minutes).
Online initialization is fault-tolerant. This option is the default. • offline: You must wait for the vdisk initialization process to finish before using the vdisk; however, offline takes less time to complete initializing than online. HP P2000 G3 MSA System CLI Reference Guide...
Page 62
name A name for the new vdisk. The name is case sensitive; cannot include a comma, double quote, or backslash; and can have a maximum of 20 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.
Optional. Size of the snap pool to create in the vdisk. If this parameter is omitted, the size will be either 20% of the volume size or the minimum snap-pool size, whichever is larger. Use either this parameter or the snap-pool parameter. HP P2000 G3 MSA System CLI Reference Guide...
Page 64
snappable Optional. Specifies to create a master volume instead of a standard volume. prepare-replication-volume Optional. Specifies to create a secondary volume instead of a regular master volume. This parameter precludes use of the mapping, lun, and ports parameters because a secondary volume cannot be mapped.
create volume-set Description Creates a specified number of volumes in a vdisk. You must specify a base name and a size for the volumes. You can create the volumes unmapped or set their default mapping. Default mapping settings apply to all hosts, unless overridden by an explicit mapping between a host and the volume. You can later change mappings by using the map volume unmap volume...
Page 67
Host-Port-Identifier Nickname Profile ----------------------------------------------------------------- read-only all other hosts Standard Volume View [Serial Number (SN) Name (vd1_v009) ] Mapping: Ports LUN Access Host-Port-Identifier Nickname Profile ----------------------------------------------------------------- read-only all other hosts Standard Success: Command completed successfully. HP P2000 G3 MSA System CLI Reference Guide...
Page 68
See also • map volume • set volume • show vdisks • show volume-maps • show volumes • unmap volume Alphabetical list of commands...
Example Delete all master volumes associated with snap pool SP1: # delete all-master-volumes snap-pool SP1 Success: Command completed successfully. (SP1) - All master volumes were deleted. See also • delete all-snapshots • show master-volumes • show snap-pools HP P2000 G3 MSA System CLI Reference Guide...
delete all-snapshots Description Deletes all snapshots associated with a specified volume. All data associated with the snapshots is deleted and their space in the snap pool is freed for use. The specified volume can be a master volume or a snap pool. The snapshots' schedules are also deleted. Syntax delete all-snapshots volume volume...
Info: Removed CHAP record 0. Info: Removed CHAP record 1. Success: Command completed successfully. - All CHAP records were deleted. See also • create chap-record • set chap-record • show chap-records • show host-parameters HP P2000 G3 MSA System CLI Reference Guide...
delete global-spare Description Deletes specified global spare disks. Syntax delete global-spare disks disks Parameters disks disks IDs of the global spares to delete. For disk syntax, see Command syntax on page 21. Example Delete two global spares: # delete global-spare disks 0.5,1.5 Info: Command completed successfully.
Error: The command had an invalid value. (257000c0ffd8b6cb) - Host 257000c0ffd8b6cb was discovered, so it cannot be deleted. Error: The command had an invalid value. See also • set host-name • show host-maps • show hosts HP P2000 G3 MSA System CLI Reference Guide...
delete master-volume Description Deletes a master volume. The volume's schedules 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 Name or serial number of the master volume to delete. For volume syntax, see Command syntax page 21.
Example Delete remote system System2: # delete remote-system System2 Success: Command deleted successfully. (System2) - The remote system was deleted. See also • create remote-system • remote • set remote-system • show remote-systems HP P2000 G3 MSA System CLI Reference Guide...
delete replication-set Description Dissolves a replication set. The replication volumes associated with the replication set are converted to master volumes and any replication snapshots associated with the replication volumes are converted to standard snapshots. Snapshots are converted regardless of the number of snapshots allowed by the system's license.
Parameters schedule The schedule to delete. Example Delete schedule Sched1: # delete schedule Sched1 Success: Command completed successfully. (Sched1) - The schedule was deleted. See also • show schedule-details • show schedules HP P2000 G3 MSA System CLI Reference Guide...
delete snap-pool Description Deletes a snap pool. NOTE: You must disassociate all master volumes from the snap pool before you can delete it. Syntax delete snap-pool snap-pool Parameters snap-pool Name or serial number of the snap pool to delete. For volume syntax, see Command syntax page 21.
Delete three standard snapshots: # delete snapshot s1,s2,s3 Info: Snapshot s1 was deleted. (s1) Info: Snapshot s2 was deleted. (s2) Info: Snapshot s3 was deleted. (s3) See also • delete snapshot-write-data • show snapshots HP P2000 G3 MSA System CLI Reference Guide...
delete snapshot-write-data Description Deletes data written to a snapshot after it was created. Deleting this 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 volume syntax, see Command syntax on page 21.
Example Delete task Task1: # delete task Task1 Success: Command completed successfully. (Task1) - The task was deleted. See also • delete schedule • show schedule-details • show schedules • show task-details • show tasks HP P2000 G3 MSA System CLI Reference Guide...
delete user Description Deletes a user profile. You can delete any user except the default user manage. Syntax delete user [noprompt] name Parameters noprompt Optional in console format; required for XML API format. Suppresses the confirmation prompt, which requires a yes or no response. Specifying this parameter allows the command to proceed without user interaction.
The vdisk 'VD3' has jobs running. Do you want to continue? yes Info: Please wait - vdisks are being deleted. Info: Deleted vdisk VD3. Success: Command completed successfully. See also • show master-volumes • show vdisks HP P2000 G3 MSA System CLI Reference Guide...
delete vdisk-spare Description Deletes specified spares that are assigned to a vdisk. Syntax delete vdisk-spare disks disks vdisk Parameters disks disks IDs of the spares to delete. For disk syntax, see Command syntax on page 21. vdisk Name or serial number of the vdisk to delete the spares from. For disk syntax, see Command syntax on page 21.
21. Example Delete volumes V1 and V2: # delete volumes V1,V2 Info: Volume V1 was deleted. (V1) Info: Volume V2 was deleted. (V2) Success: Command completed successfully. See also • show volumes HP P2000 G3 MSA System CLI Reference Guide...
dequarantine Description Removes a vdisk from quarantine. A vdisk having a fault-tolerant RAID level becomes quarantined if at least one of its disks is detected as missing after the storage system is powered up or while it is operating. Quarantine does not occur for NRAID or RAID-0 vdisks;...
Page 87
... QTDN ... (Quarantined with down disks) ----------------- # dequarantine vdisk VD1 Success: Command completed successfully # show vdisks Name ... Stat ... ----------------- ... FTDN ... (Fault tolerant, down) See also • show vdisks HP P2000 G3 MSA System CLI Reference Guide...
detach replication-volume Description Prepares a secondary volume to be physically removed from a system. When using the replication feature, if you chose to create a replication set's primary and secondary volumes in the primary system, you can perform the initial replication and then physically move the secondary volume's vdisk into the secondary system.
expand snap-pool Description Expands a snap pool. Expansion is restricted to the space available on the vdisk containing the snap pool. If insufficient space is available for expansion on the vdisk, first expand the vdisk by using expand vdisk. Syntax To expand by a specific size: expand snap-pool size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] snap-pool...
See the online help to access this white paper. Start to expand this vdisk? yes Success: Command completed successfully. - Expansion was started on vdisk VD1. See also • show disks • show vdisks HP P2000 G3 MSA System CLI Reference Guide...
expand volume Description Expands a standard volume. Expansion is restricted to the space available on the vdisk containing the volume. If insufficient space is available for expansion on the vdisk, first expand the vdisk by using expand vdisk. To expand a master volume: Delete all of its snapshots by using delete all-snapshots.
Example Export local replication snapshot RepSnap1 to standard snapshot Snap1: # export snapshot name Snap1 RepSnap1 Success: Command completed successfully. (RepSnap1) - The snapshot has been exported. See also • show replication-sets • show snapshots HP P2000 G3 MSA System CLI Reference Guide...
map volume Description Maps specified volumes using settings that override the volumes’ default mapping. When a volume is created, if no mapping settings are specified the volume is not mapped; otherwise, those settings become its default mapping, which specifies the controller host ports and access level that all connected hosts have to the volume, and the LUN presented to all hosts to identify the volume.
Page 95
Volume View [Serial Number (SN) Name (v1) ] Mapping: Ports LUN Access Host-Port-Identifier Nickname Profile ----------------------------------------------------------------- A1,B1 6 read-write 207000c0ff001121 Host1 Standard A1,B1 6 read-write 207000c0ff001122 Host2 Standard not-mapped all other hosts Standard HP P2000 G3 MSA System CLI Reference Guide...
Page 96
Volume View [Serial Number (SN) Name (v2) ] Mapping: Ports LUN Access Host-Port-Identifier Nickname Profile ----------------------------------------------------------------- A1,B1 7 read-write 207000c0ff001121 Host1 Standard A1,B1 7 read-write 207000c0ff001122 Host2 Standard not-mapped all other hosts Standard Success: Command completed successfully. See also • show host-maps •...
Example Show all metadata for objects returned by the show disks command: # meta drives See also • set cli-parameters HP P2000 G3 MSA System CLI Reference Guide...
ping Description Tests communication with a remote host. The remote host is specified by IP address. Ping sends ICMP echo response packets and waits for replies. Syntax ping host-address [count] Parameters host-address The remote host’s IP address in dotted decimal form. count Optional.
# reattach replication-volume rV1 Success: Command completed successfully. - The replication volume reattach has been initiated. See also • detach replication-volume • show replication-sets • show replication-volumes • start vdisk • stop vdisk HP P2000 G3 MSA System CLI Reference Guide...
remote Description Runs a command on a remote system that is associated with the local system. If the command cannot connect to remote controller A, it tries to connect to remote controller B; if unsuccessful, the remote command is not run. Output is displayed in console or XML API format depending on the local system’s setting.
replicate snapshot Description Initiates a replication operation using an existing snapshot as the data source. This command replicates the specified external standard snapshot. If the specified snapshot has not already been replicated on the replication volume, each replication volume in the replication set is requested to replicate the snapshot data. Only snapshot preserved data is replicated;...
Example Replicate volume MV1 and name the replication snapshot RepSnap1: # replicate volume snapshot RepSnap1 MV1 Success: Replication Initiated. See also • show replication-sets • show replication-volumes HP P2000 G3 MSA System CLI Reference Guide 103...
rescan Description This command forces rediscovery of attached disks and enclosures. If both Storage Controllers are online this command also reassigns enclosure IDs based on controller A’s enclosure cabling order. A manual rescan may be needed after system power-up to display enclosures in the proper order. A manual rescan is not required to detect when disks are inserted or removed;...
reset controller-statistics Description Resets performance statistics for controllers. This command resets all controller statistics except Power On Time. To reset this, restart or power cycle a controller. Syntax reset controller-statistics [a|b|both] Parameters a|b|both Optional. Specifies whether to reset statistics for controller A, B, or both. If this parameter is omitted, statistics are reset for both controllers.
reset disk-statistics Description Resets performance statistics for disks. This command resets basic disk statistics but not disk error statistics. To reset these, use the reset disk-error-statistics command. Syntax reset disk-statistics Example Reset statistics for all disks: # reset disk-statistics Success: Command completed successfully. See also •...
Example Reset the host link on port A1: # reset host-link ports A1 Success: Command completed successfully. - Reset Host Link(s) on port(s) a1 from current controller. See also • show ports HP P2000 G3 MSA System CLI Reference Guide 109...
reset host-port-statistics Description Resets performance statistics for controller host ports. Syntax reset host-port-statistics [ports ports] Parameters ports ports Optional. The controller ID and port number of ports to reset statistics for. For port syntax, see Command syntax on page 21. If this parameter is omitted, statistics are reset for all controller host ports.
You MUST unmount the snapshot from all hosts before resetting it. Ready to continue? yes Success: Command completed successfully. - The reset of a snapshot completed. See also • show snapshots HP P2000 G3 MSA System CLI Reference Guide 111...
reset vdisk-statistics Description Resets performance statistics for all or specified vdisks. Syntax reset vdisk-statistics [vdisks] Parameters vdisks Optional. Names or serial numbers of the vdisks to reset statistics for. For vdisk syntax, see Command syntax on page 21. If this parameter is omitted, statistics are reset for all vdisks. Example Reset statistics for vdisks VD1 and MyVdisk: # reset vdisk-statistics VD1,MyVdisk Success: Command completed successfully.
restart Description Restarts the Storage Controller or Management Controller in a controller module. If you restart a Storage Controller, it attempts to shut down with a proper failover sequence, which includes stopping all I/O operations and flushing the write cache to disk, and then the controller restarts.
Logical devices may not be accessible until mappings are reconfigured. Are you sure? yes Success: Command completed successfully. - Device default configuration was restored. See also • restart HP P2000 G3 MSA System CLI Reference Guide 115...
resume replication Description Resumes a suspended replication operation on the specified replication volume. This command must be issued on the system that owns the secondary volume. Syntax resume replication [set replication-set] replication-volume Parameters set replication-set Optional. Name or serial number of the replication set. replication-volume Name or serial number of the replication volume.
You MUST unmount the master volume and the snapshot from all hosts before starting a rollback operation. Ready to continue? yes Success: Command completed successfully. - Rollback was started. See also • show master-volumes • show snapshots HP P2000 G3 MSA System CLI Reference Guide 117...
scrub vdisk Description Analyzes specified vdisks to detect, report, and store information about disk defects. Vdisk-level errors reported include: hard errors, media errors, and bad block replacements (BBRs). Disk-level errors reported include: metadata read errors, SMART events during scrub, bad blocks during scrub, and new disk defects during scrub.
(SAS or SATA). emp-poll-rate rate Optional. Sets the interval at which the storage system polls the EC (EMP) for status changes, from 5–3600 seconds. The default is 5 seconds. HP P2000 G3 MSA System CLI Reference Guide 119...
Page 120
fan-failure enabled|disabled|on|off Optional. Sets whether the cache policy automatically changes to write-through when a fan fails. host-cache-control enabled|disabled|on|off Optional. Sets whether the host can modify the cache setting. The default is disabled. missing-lun-response notready|illegal Optional. Sets the missing-LUN response which enables the host drivers to continue probing for LUNs until they reach the LUN to which they have access.
Page 121
Info: Command completed successfully. - Parameter 'partner-firmware-upgrade' was set to 'enabled'. Success: Command completed successfully. - The settings were changed successfully. See also • scrub vdisk • set job-parameters • set spares • show advanced-settings HP P2000 G3 MSA System CLI Reference Guide 121...
set auto-write-through-trigger Description Sets the trigger conditions that cause the controller to change the cache policy from write-back to write-through. You can set multiple triggers. By default super-cap-failure and auto-write-back are enabled. Alias: set awt. When the cache mode is changed, an event is logged. Syntax set auto-write-through-trigger [controller-failure enabled|disabled|on|off]...
set cache-parameters Description Sets a volume’s cache options. Settings you can change include: • Cache write policy • Cache optimization mode • Cache read-ahead size NOTE: Only change the read-ahead cache settings if you fully understand how the host operating system, application, and adapter move data so that you can adjust the settings accordingly.
The controllers treat non-RAID and RAID- 1 vdisks internally as if they have a stripe size of 64 Kbyte, even though they are not striped. HP P2000 G3 MSA System CLI Reference Guide 125...
set chap-record Description For iSCSI, changes an originator’s CHAP record. You can change the record’s secret, mutual name, and mutual secret values. This command is permitted whether or not CHAP is enabled. Syntax set chap-record name originator-name [secret originator-secret] [mutual-name recipient-name mutual-secret recipient-secret] Parameters name originator-name The originator name, typically in IQN format.
Optional. Specifies whether to halt output after each full screen to wait for keyboard input. Enabled by default. When using XML API format, which is intended for scripting, disable paging. precision # Optional. Sets the number of decimal places (1–10) for display of storage-space sizes. HP P2000 G3 MSA System CLI Reference Guide 127...
Page 128
storage-size-base 2|10 Optional. Alias for base. storage-size-precision # Optional. Alias for precision. storage-size-units auto|MB|GB|TB Optional. Alias for units. temperature-scale celsius|c|fahrenheit|f Optional. Specifies to show temperatures in degrees Fahrenheit or Celsius. timeout # Optional. Sets the timeout value in seconds for the login session. Valid values are 120–43200 seconds (2–720 minutes).
Success: Command completed successfully. Set the system to use NTP with an offset for the Bangalore, India time zone: # set controller-date ntp enabled ntpaddress 69.10.36.3 timezone +5:30 Success: Command completed successfully. HP P2000 G3 MSA System CLI Reference Guide 129...
Page 130
See also • set ntp-parameters • show controller-date • show ntp-status 130 Alphabetical list of commands...
Example Include RAID and cache messages, exclude EMP messages, and leave other message types unchanged: # set debug-log-parameters raid+ cache+ emp- Success: Command completed successfully. - Debug-log parameters were changed. See also • show debug-log-parameters HP P2000 G3 MSA System CLI Reference Guide 131...
set disk-parameters Description Sets parameters that affect disk operation. Two features controlled by these parameters are disk Self-Monitoring Analysis and Reporting Technology (SMART) and drive spin-down (DSD). • Disks equipped with SMART technology can alert the controller of impending disk failure. When SMART is enabled, the system checks for SMART events one minute after a restart and every five minutes thereafter.
Info: Set Email Server Name to: 10.1.1.10 Info: Set Email Domain Name to: mydomain.com Info: Set Email Notification Level to: warn Info: Set Email Sender Name to: RAIDsystem See also • show email-parameters • test HP P2000 G3 MSA System CLI Reference Guide 133...
set enclosure Description Sets an enclosure’s name, location, rack number, and rack position. Set these parameters to values that help you identify and locate the enclosure. A value that contains a space must be enclosed in double quotes. These values are used when user interfaces show enclosure-related data; for example, in output of show enclosures command and in event-log entries related to enclosures.
Re-enable PHY fault isolation for Expander Controller A in the same enclosure: # set expander-fault-isolation encl 1 controller a enabled Success: Command completed successfully. - Expander fault isolation was enabled. See also • set expander-phy • show enclosures • show expander-status HP P2000 G3 MSA System CLI Reference Guide 135...
set expander-phy Description For use by 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 drive|sc-0|sc-1|ingress|egress phy phy-ID enabled|disabled|on|off Parameters encl enclosure-ID The enclosure ID of the enclosure containing the PHY. controller a|b|both The I/O module containing the PHY to enable or disable: A, B, or both.
Remove a manually created host: # set host-name id MyHost Success: Command completed successfully. (MyHost) - The host entry was deleted. See also • create host • delete host • show hosts HP P2000 G3 MSA System CLI Reference Guide 137...
set host-parameters Description Sets controller host-port parameters for communication with attached hosts. You can set parameters for FC and iSCSI ports; there are no parameters for SAS ports. Attempting to change FC loop IDs requires restarting the controllers; otherwise, new settings take effect without restarting the controllers.
Page 139
# set host-parameters fibre-loop-id 14,soft noprompt Info: Changes to FC loop ids will not take effect until the affected Storage Controller is restarted. Success: Command completed successfully. - The host parameters were changed successfully HP P2000 G3 MSA System CLI Reference Guide 139...
Page 140
On a system with FC ports, set the link speed to 4 Gbit/sec for ports A1 and B1; set controller A ports to request loop ID 5 and controller B ports to request loop ID 32; and suppress the confirmation prompt: # set host-parameters speed 4g ports a1,b1 fibre-loop-id 5,32 noprompt Info: Changes to FC loop ids will not take effect until the affected Storage...
Info: Command completed successfully. - Parameter 'partner-firmware-upgrade' was set to 'off'. Success: Command completed successfully. - The settings were changed successfully. See also • scrub vdisk • set advanced-settings • show job-parameters HP P2000 G3 MSA System CLI Reference Guide 143...
set led Description Changes the state of the identification LED on a specified disk or enclosure. For a disk this affects the Fault/UID LED. For an enclosure this affects the UID LED. LEDs are described in the user guide. Syntax To set a disk LED: set led disk ID enable|disable|on|off...
Manually set network port IP values for controller A (disabling 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: Command completed successfully. - Request to set network parameters has been initiated. HP P2000 G3 MSA System CLI Reference Guide 145...
Page 146
See also • show network-parameters 146 Alphabetical list of commands...
Set the system to use NTP with an offset for the Bangalore, India time zone: # set controller-date ntp enabled ntpaddress 69.10.36.3 timezone +5:30 Success: Command completed successfully. See also • set controller-date • show controller-date • show ntp-status HP P2000 G3 MSA System CLI Reference Guide 147...
set password Description Sets a user’s password for system interfaces (such as the CLI). A password can be entered as part of the command, or the command prompts you to enter and re-enter the new password. Syntax set password [password password] [user] Parameters password password Optional.
Example Set attribute priorities for snap pool SnapPool1, raising the priority for standard snapshots and leaving other priorities unchanged: # set priorities only-sync-point 65535 SnapPool1 See also • show priorities • show snap-pools HP P2000 G3 MSA System CLI Reference Guide 149...
set prompt Description Sets the prompt for the current CLI session. Syntax set prompt prompt Parameters prompt The new prompt, 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 a space must be enclosed in double quotes.
Optional. Enables or disables the standard CLI. Example Disable unsecure HTTP connections and enable FTP: # set protocols http disabled ftp enabled Success: Command completed successfully. See also • show protocols HP P2000 G3 MSA System CLI Reference Guide 151...
set remote-system Description Changes remote-system credentials stored on the local system. Do this when the user name or password to access a remote system has been changed on that system Syntax set remote-system [password password] [username username] system Parameters password password Optional.
set replication-primary-volume Description Changes the primary volume for a replication set. You must issue this command to each volume in the replication set. If the volumes in a replication set have different primary-volume settings — for example, if the primary volume was changed while one volume was offline — this results in a primary-volume conflict.
Retry the operation for the time specified in the max-retry-time parameter. • suspend: Suspend the replication operation. priority low|medium|high Optional. Priority of the replication process on the replication volume: low, medium, or high. HP P2000 G3 MSA System CLI Reference Guide 155...
Page 156
remote-address ip=IPs|wwnn=WWNNs|wwpn=WWPNs Optional. Remote addresses associated with the replication volume. Specifies host ports on the remote system by IP address, World Wide Node Name, or World Wide Port Name. An IP address value can include a port number; for example, 10.134.11.10:3260. Multiple values must be separated by commas and no spaces;...
# set schedule schedule-specification "start 2010-01-01 00:01 every 1 days expires 2010-12-31 00:01" task-name Snap Sched1 Success: Command completed successfully. (Sched1) - The schedule was modified. See also • show schedule-details • show schedules • show task-details • show tasks HP P2000 G3 MSA System CLI Reference Guide 157...
set snap-pool-policy Description Sets the recovery policy that determines the action taken when a specified snap pool’s error and critical threshold levels are reached. The policy for the warning threshold is preset to notifyonly. A snap pool’s default error policy is autoexpand and default critical policy is deletesnapshots.
Page 159
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. - The snap-pool policy was changed. See also • set priorities • set snap-pool-threshold • show snap-pools HP P2000 G3 MSA System CLI Reference Guide 159...
set snap-pool-threshold Description Sets the percentages of snap-pool space used that trigger the warning and error threshold policies. Three thresholds are defined: • Warning: The snap pool is moderately full. When this threshold is reached, an event is generated to alert the administrator. •...
Example Enable Critical events only, specify a trap host, and set the community string for read-only access: # set 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 P2000 G3 MSA System CLI Reference Guide 161...
set spares Description Creates or deletes spare disks for redundant (RAID 1, 3, 5, 6, 10, 50) vdisks. A global spare is available to any redundant vdisk with the same disk type. The system can have eight global spares. Each must have enough capacity to replace the smallest disk in any existing vdisk.
A brief description of what the system is used for or how it’s configured. Example 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 P2000 G3 MSA System CLI Reference Guide 163...
set task Description Changes parameters for a TakeSnapshot, ReplicateVolume, or VolumeCopy task. For these types of tasks, you can change parameters other than name, type, or associated volumes. If you change the parameters for a running task, the changes will take effect the next time the task runs. If you want to change parameters for a ResetSnapshot task or the name, type, or associated volumes for another type of task, create a new task to replace the existing one.
Page 165
Success: Command completed successfully. (Replicate) - The task was modified. See also • create task • delete task • set schedule • show schedule-details • show schedules • show task-details • show tasks HP P2000 G3 MSA System CLI Reference Guide 165...
set user Description NOTE: Changes user preferences for the session or permanently. You cannot change the access level of user manage.User changes take effect when the user next logs in. Syntax set user [base 2|10] [interfaces interfaces] [level monitor|manage] [locale English|en|Spanish|es|French|fr|German|de|Italian|it|Japanese|ja |Korean|ko|Dutch|nl|Chinese-simplified|zh-s|Chinese-traditional|zh-t] [password password] [precision #]...
Page 167
Change the password for user JDoe: # set user JDoe password Abc%123 Success: Command completed successfully. - The settings were changed successfully. See also • set password • show users HP P2000 G3 MSA System CLI Reference Guide 167...
set vdisk Description Changes parameters for a specified vdisk. Syntax set vdisk [name new-name] [owner a|b] [spin-down-delay delay] vdisk Parameters name new-name Optional. A new name for the vdisk. For vdisk syntax, see Command syntax on page 21. owner a|b Optional.
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 P2000 G3 MSA System CLI Reference Guide 169...
show advanced-settings Description Shows the settings for advanced system-configuration options. Syntax show advanced-settings Output Vdisk Background Scrub Shows whether disks in vdisks are automatically checked for disk defects to ensure system health. Vdisk Background Scrub Interval Shows the interval between background vdisk scrub finishing and starting again, from 1–360 hours. The default is 24 hours.
Page 171
Partner Notify: Disabled Auto Write Back: Enabled Drive Spin Down Non-Vdisk Enable: Enabled Drive Spin Down Non-Vdisk Delay: 30 Disk Background Scrub: Disabled Basetypes • advanced-settings-table • status See also • set advanced-settings HP P2000 G3 MSA System CLI Reference Guide 171...
show auto-write-through-trigger Description Shows the system’s write-through trigger settings. When a trigger condition occurs and the trigger is enabled, the RAID controller cache mode changes from write-back to write-through. Alias: show awt. Syntax show auto-write-through-trigger Example Show the system’s auto-write-through trigger settings: # show auto-write-through-trigger Auto Write-Through Triggers ---------------------------...
show cache-parameters Description Shows cache settings and status for the system and optionally for a volume. Syntax show cache-parameters [volume] Parameters volume Optional. Name or serial number of the volume to show settings for. For volume syntax, see Command syntax on page 21.
Page 175
Serial Number: SN Name: V1 Cache Write Policy: write-back Cache Optimization: standard Read Ahead Size: Default Basetypes • cache-settings • cache-parameter • status See also • set cache-parameters • show volumes HP P2000 G3 MSA System CLI Reference Guide 175...
show chap-records Description For iSCSI, shows all CHAP records or the record for a specific originator. This command is permitted whether or not CHAP is enabled. Syntax show chap-records [name originator-name] Parameters name originator-name Optional. The originator name, typically in IQN format. If this parameter is omitted, the command displays CHAP records for all originators.
Based on the precision setting, if the selected unit is too large to meaningfully display a size, the system uses a smaller unit for that size. Temperature Scale • Fahrenheit: Temperatures are shown in degrees Fahrenheit. • Celsius: Temperatures are shown in degrees Celsius. HP P2000 G3 MSA System CLI Reference Guide 177...
Page 178
Example Show current CLI settings: # show cli-parameters CLI Parameters -------------- Timeout: 1800 Output Format: console Brief Mode: Disabled Base: 10 Pager: Enabled Locale: English Precision: 1 Units: Auto Temperature Scale: Celsius Basetypes • cli-parameters • status See also • set cli-parameters 178 Alphabetical list of commands...
Enclosure status information from show enclosures • Field-replaceable unit (FRU) information from show frus Basetypes • system • controllers • versions • port • drives • enclosure-list • virtual-disks • enclosures • status HP P2000 G3 MSA System CLI Reference Guide 179...
show controller-date Description Shows the system’s current date and time. Values are shown in Coordinated Universal Time (UTC). 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 UTC. This is shown only if NTP is enabled.
Failed Over No or Yes Fail Over Reason If Failed Over is Yes, a reason for the failover appears; otherwise, Not applicable appears Position Top or Bottom Phy Isolation Enabled or Disabled HP P2000 G3 MSA System CLI Reference Guide 181...
Page 182
Example Show controller information: # show controllers Controllers ----------- Controller ID: A Serial Number: SN Hardware Version: 25 CPLD Version: 8 MAC Address: 00:C0:FF:27:50:24 WWNN: WWNN IP Address: 10.134.11.100 IP Subnet Mask: 255.255.0.0 IP Gateway: 10.134.0.1 Disks: 17 Vdisks: 2 Cache Memory Size (MB): 1024 Host Ports: 4 Disk Channels: 2...
17563 654.3KB 61.4KB controller_B 17564 -------------------------------------------------------------------- Basetypes • controller-statistics • status • reset all-statistics See also • reset controller-statistics • show disk-statistics • show host-port-statistics • show vdisk-statistics • show volume-statistics HP P2000 G3 MSA System CLI Reference Guide 183...
show debug-log-parameters Description For use by or with direction 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 Output • awt: Auto-write-through cache triggers debug messages •...
show disks Description Shows information about all disks in the storage system. If no parameter is specified, the command shows information for all disks. NOTE: In console format, to aid reading, disks are sorted to display in order by enclosure and disk number.
Page 187
Data transfer rate in Gbit/second. A footnote indicates that it is normal behavior for the rate to vary. Some 6-Gbps disks might not consistently support a 6-Gbps transfer rate. If this happens, the P2000 controller automatically adjusts transfers to those disks to 3 Gbps, increasing reliability and reducing error messages with little impact on system performance.
Page 188
Size Disk size Example Show information for all disks: # show disks Location Serial Number Vendor How Used Type Size Rate*(Gb/s) Health Health Reason ----------------------------------------------------------------------------- vendor VDISK 146.8GB vendor AVAIL 146.8GB Degraded The disk has degraded health. Recommended action: Replace the disk. vendor LEFTOVR 146.8GB...
Basetypes • disk-statistics • status See also • reset all-statistics • reset disk-error-statistics • reset disk-statistics • show controller-statistics • show disks • show host-port-statistics • show vdisk-statistics • show volume-statistics HP P2000 G3 MSA System CLI Reference Guide 189...
EMP A CH:ID EMP B CH:ID Midplane Type ------------------------------------------------------------------ Controller vendor model 01:031 1115 00:031 1115 2U24-3G ----------------------------------------------------------------- Basetypes • enclosures • status See also • set enclosure • show sensor-status HP P2000 G3 MSA System CLI Reference Guide 191...
show enclosure-status Description Deprecated; use show enclosures, show frus, or show sensor-status. Shows the status of system enclosures and their components. For each attached enclosure, the command shows general SCSI Enclosure Services (SES) information followed by component-specific information. Syntax show enclosure-status Output General SES fields: Chassis Chassis serial number...
Page 193
01:031 1115 WWPN ------------------------------------------------------------------------------- Type Status FRU P/N FRU S/N Add'l Data ----------------------------------------------------- Temp temp=37 Voltage voltage=11.86V Disk addr=0 ----------------------------------------------------- Basetypes • ses • enclosure-components • status See also • show enclosures HP P2000 G3 MSA System CLI Reference Guide 193...
show events Description Shows events logged by each controller in the storage system. A separate set of event numbers is maintained for each controller. Each event number is prefixed with a letter identifying the controller that logged the event. Events are listed from newest to oldest, based on a timestamp with one-second granularity; therefore the event log sequence matches the actual event sequence within about one second.
Page 195
Show a range of events logged by controller A: # show events from-event a100 to-event a123 Basetypes • events • status See also • clear events • set snmp-parameters • show snmp-parameters HP P2000 G3 MSA System CLI Reference Guide 195...
show expander-status Description For use by or with direction from a service technician. Shows diagnostic information relating to SAS Expander Controller physical channels, known as PHY lanes. For each enclosure, this command shows status information for PHYs in I/O module A and then I/O module B.
LEFT PSU SLOT: Power supply module on the left, as viewed from the back • RIGHT PSU SLOT: Power supply module on the right, as viewed from the back Configuration SN Configuration serial number HP P2000 G3 MSA System CLI Reference Guide 199...
Page 200
FRU Status • Absent: Component is not present • Fault: One or more subcomponents has a fault • OK: All subcomponents are operating normally • Not Available: Status is not available Basetypes • enclosure-fru • status 200 Alphabetical list of commands...
LUN used to access the volume. Access Type of host access to the volume: • read-write: Read and write • read-only: Read only • no-access: No access Ports Controller host ports that the mapping applies to. HP P2000 G3 MSA System CLI Reference Guide 201...
Page 202
Example Show volume mappings for all hosts: # show host-maps Host View [ID (AABBCCDDEEFF0011) Name (Host1) Profile (OpenVMS) ] Mapping: Name Serial Number Access Ports ----------------------------------------------------------------- vd2_v2 SN read-write A1,A2,B1,B2 vd2_v0 SN read-write A1,B1 vd2_v1 SN no-access Host View [ID (1A2B3C4D5E6F8900) Name (Host2) Profile (HP-UX) ] Mapping: Name Serial Number Access...
Primary subnet mask IP address. iSCSI only. Unique Media Access Control (MAC) hardware address, also called the physical address. iSCSI only. Secondary IP address. This field is only displayed during failover. HP P2000 G3 MSA System CLI Reference Guide 203...
Page 204
SIP-Gateway iSCSI only. Secondary gateway IP address. This field is only displayed during failover. SIP-Netmask iSCSI only. Secondary subnet mask IP address. This field is only displayed during failover. MAC(S) iSCSI only. Secondary MAC address. This field is only displayed during failover. Example Show port information for a system with two FC ports: # show host-parameters Ports Media...
Page 205
See also • set host-parameters • show ports HP P2000 G3 MSA System CLI Reference Guide 205...
show host-port-statistics Description Shows performance statistics for each controller host port. Syntax show host-port-statistics [ports ports] Parameters ports ports Optional. The controller ID and port number of ports to show information about. For port syntax, see Command syntax on page 21. If this parameter is omitted, information is shown for all host ports. Output Durable ID Host port ID in the form hostport_controller-ID-and-port-number.
Host Type --------------------------------------------------------------------- 100000A0B8040BAC Standard 100000A0B8040BAD My-host OpenVMS 1111111111111111 testhost HP-UX iqn.1991-05.com.microsoft:myhost.domain Server1 Standard iSCSI --------------------------------------------------------------------- Basetypes • hosts • status See also • create host • delete host • set host-name HP P2000 G3 MSA System CLI Reference Guide 207...
show inquiry Description Shows inquiry data for each controller module. Syntax show inquiry Output • Management Controller firmware version and loader version Storage Controller firmware version and loader version • • Controller module serial number • Media Access Control (MAC) address •...
CHAP: Disabled Jumbo Frames: Disabled iSNS: Disabled iSNS IP: 0.0.0.0 iSNS Alt IP: 0.0.0.0 iSCSI Speed: auto iSCSI IP Version: 4 Basetypes • iscsi-parameters • status See also • set iscsi-parameters HP P2000 G3 MSA System CLI Reference Guide 209...
show job-parameters Description Shows parameters for background vdisk scrub, partner firmware upgrade, and other jobs. Syntax show job-parameters Output Vdisk Background Scrub Shows whether disks in vdisks 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.
VDS Expires • Never. Always enabled and doesn’t expire. Shows whether the VSS (Volume Shadow Copy Service) Hardware Provider is enabled or disabled. VSS Expires • Never. Always enabled and doesn’t expire. HP P2000 G3 MSA System CLI Reference Guide 211...
Page 212
Example Show information about the installed license: # show license License Key: 0004b56810eb357d0f75d65c13c6e846 Maximum Licensable Snapshots: value Base Maximum Snapshots: value Licensed Snapshots: value In-Use Snapshots: value Snapshots Expire: 2 days remaining Volume Copy: Enabled Volume Copy Expires: Never Replication: Enabled Replication Expires: 2 days remaining VDS: Enabled VDS Expires: Never...
Example Show information about all master volumes: # show master-volumes Vdisk Serial Number Name Size Status Status-Reason Snap-pool Name Snapshots Snap Data Rollback ----------------------------------------------------------------------------- 14.9GB Available 1090.5MB 9999.9MB Unavailable SP Not Accessible ----------------------------------------------------------------------------- HP P2000 G3 MSA System CLI Reference Guide 213...
Page 214
Basetypes • master-volumes • status See also • convert master-to-std • create master-volume • delete all-master-volumes • delete master-volume • expand volume • rollback master-volume 214 Alphabetical list of commands...
Example Show NTP status for the system: # show ntp-status NTP Status ---------- NTP Status: activated NTP Server Address: 69.10.36.3 Last Server Contact: 2009-12-04 16:24:42 Basetypes • ntp-status • status See also • set controller-date HP P2000 G3 MSA System CLI Reference Guide 217...
show ports Description Shows information about host ports on both controllers. This command shows the same information as the show host-parameters command. Syntax show ports Output Ports Controller ID and port number Media • FC(P): Fibre Channel Point-to-Point • FC(L): Fibre Channel-Arbitrated Loop •...
Page 219
Ports Media Target ID Status Speed(A) Speed(C) -------------------------------------------------------------- WWPN Disconnected Topo(C) Width -------------- Direct WWPN Disconnected -------------------------------------------------------------- Topo(C) Width -------------- Direct -------------------------------------------------------------- Basetypes • port • status See also • set host-parameters HP P2000 G3 MSA System CLI Reference Guide 219...
show power-supplies Description Shows information about each power supply in the storage system. Syntax show power-supplies Output Serial Number Power supply serial number Name Power supply identifier and location Power supply revision number Model Power supply model number Part Number Power supply part number FRU Shortname Short name of the power-supply FRU...
0xc000 (default) Common Sync Point Snapshot 0x8000 (default) Only Sync Point Snapshot 0xe000 (default) Queued Snapshot 0x2000 (default) ----------------------------------------------- Basetypes • attribute-priorities • status See also • set priorities • show snap-pools HP P2000 G3 MSA System CLI Reference Guide 221...
show protocols Description Shows which management services and protocols are enabled or disabled. Syntax show protocols Example Show the status of service and security protocols: # show protocols Service and Security Protocols ------------------------------ Web Browser Interface (HTTP): Enabled Secure Web Browser Interface (HTTPS): Enabled Command Line Interface (Telnet): Enabled Secure Command Line Interface (SSH): Enabled Storage Management Initiative Specification (SMI-S): Enabled...
----------------- Redundancy Mode: Active-Active ULP Redundancy Status: Redundant Controller A Status: Operational Controller A Serial Number: 00C0FF0A4318 Controller B Status: Operational Controller B Serial Number: 00C0FF0A4326 Basetypes • redundancy • status HP P2000 G3 MSA System CLI Reference Guide 223...
show refresh-counters Description In XML API format, shows when the data represented by the base type 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.
IP Address Controller B: 10.122.1.22 Username: manage Status: Connected Last Connected: 2009-11-10 12:58:15 Basetypes • remote-system • status See also • create remote-system • delete remote-system • remote • set remote-system HP P2000 G3 MSA System CLI Reference Guide 225...
show replication-images Description Shows information about replication images for a specified replication volume. Syntax show replication-images [set replication-set] [replication-volume] Parameters set replication-set Optional. Name or serial number of the replication set. replication-volume Optional. Name or serial number of the replication volume. If the name is not unique within the replication set, the local volume is assumed.
Page 227
Status Progress Start Date/Time Last Update Suspended Est Complete Time ----------------------------------------------------------------------- Complete 2009-01-14 14:52:09 2009-01-14 14:52:33 00:00:24 ----------------------------------------------------------------- Basetypes • replication-volume-summary • status See also • show replication-sets • show replication-volumes HP P2000 G3 MSA System CLI Reference Guide 227...
show replication-sets Description Shows information about replication sets on the local system. You can view information about all replication sets or a specific replication set. Syntax show replication-sets [replication-set] Parameters replication-set Optional. Name or serial number of a replication set or volume for which to display replication-set-level information.
Page 229
• For a local primary or secondary volume, this field shows N/A. Remote Address The address of each host port in the remote system through which the volume is accessible. HP P2000 G3 MSA System CLI Reference Guide 229...
Page 230
Example Show information about all replication sets: # show replication-sets Replication Set [Name (rsvd01_v001) Serial Number (SN) ] Primary Volume: Name Serial Number Status Status-Reason Monitor Location Primary-Volume Primary-Volume-Serial Primary-Volume-Status MaxQueue MaxRetryTime On Error Link Type On Collision Monitor Interval Priority Connection Status Connection Time...
Page 231
Local Data Online 1800 Retry Oldest Medium Not Attempted Connected Ports Remote Address -------------------------------------------------------------- FCPortWWN=207000c0ff000bee FCPortWWN=217000c0ff000bee FCPortWWN=247000c0ff000bee FCPortWWN=257000c0ff000bee Basetypes • replication-set • status See also • show replication-images • show replication-volumes HP P2000 G3 MSA System CLI Reference Guide 231...
show replication-volumes Description Shows information about volumes in replication sets. You can view information about all replication volumes, volumes in a specified replication set, or a specified replication volume. Syntax show replication-volumes [set replication-set] [replication-volume] Parameters set replication-set Optional. Name or serial number of the replication set. replication-volume Optional.
Page 233
• For a local primary or secondary volume, this field shows N/A. Remote Address The address of each host port in the remote system through which the volume is accessible. HP P2000 G3 MSA System CLI Reference Guide 233...
Page 234
Example Show information 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 ----------------------------------------------------------------------------- vd01_v001 Online Remote vd01_v001 Online 1800 Retry...
Name Status Health --------------------------------------------------------------------- Out Port Out Port --------------------------------------------------------------------- Encl Ctlr Name Status Health --------------------------------------------------------------------- In Port Out Port Disconnected In Port Out Port Disconnected --------------------------------------------------------------------- Basetypes • expander-ports • status HP P2000 G3 MSA System CLI Reference Guide 235...
show schedule-details Description Shows information about a specified task schedule. Syntax show schedule-details schedule Parameters schedule Schedule name. Example Show information about task schedule SnapSched: # show schedule-details SnapSched Schedule Details ---------------- Schedule Name: SnapSched Schedule Specification: Start 2009-02-19 23:47:00, Every 3 Minutes Status: Ready Next Time: 2009-02-23 12:59:00 Task To Run: Snap...
Tasks ----- Task Name: bTx_v002_task001 Task Type: ReplicateVolume Status: Ready Task State: Start Error Message: Task Details ------------ Primary Volume Name: bTx_v002 Primary Volume Serial Number: SN Prefix: bTx_v002_01 Mode: new-snapshot HP P2000 G3 MSA System CLI Reference Guide 237...
Page 238
Count: 10 Last Created: bTx_v002_01_R0030 Last Used Snapshot: N/A Snapshot Name Snapshot Serial ------------------------------------------------------ bTx_v002_01_R0021 bTx_v002_01_R0022 bTx_v002_01_R0023 bTx_v002_01_R0024 bTx_v002_01_R0025 bTx_v002_01_R0026 bTx_v002_01_R0027 bTx_v002_01_R0028 bTx_v002_01_R0029 bTx_v002_01_R0030 Basetypes • schedules • status See also • create schedule • delete schedule • show schedule-details 238 Alphabetical list of commands...
2.04 Capacitor Cell 2 Voltage-Ctlr B 2.08 Capacitor Cell 3 Voltage-Ctlr A 2.03 Capacitor Cell 3 Voltage-Ctlr B 2.02 Capacitor Cell 4 Voltage-Ctlr A 2.08 Capacitor Cell 4 Voltage-Ctlr B 2.00 HP P2000 G3 MSA System CLI Reference Guide 239...
Page 240
Capacitor Charge-Ctlr A 100% Capacitor Charge-Ctlr B 100% Overall Unit Status Temperature Loc: upper-IOM A 42 C Temperature Loc: lower-IOM B 38 C Temperature Loc: left-PSU 33 C Temperature Loc: right-PSU 36 C Voltage 12V Loc: upper-IOM A 11.92 Voltage 5V Loc: upper-IOM A 5.08 Voltage 12V Loc: lower-IOM B 11.86...
Output Message stating whether each controller is up (active), down (shut down), or not installed. Example Show the shutdown status of each controller: # show shutdown-status Storage Controller A up Storage Controller B down Basetypes • shutdown-status • status See also • restart • shutdown HP P2000 G3 MSA System CLI Reference Guide 241...
show snap-pools Description Shows information about snap pools owned by a specified controller or both controllers. Syntax show snap-pools [controller a|b|both] Parameters controller a|b|both Optional. Shows snap pools owned by controller A only, by controller B only, or by either controller (both).
Page 243
Basetypes • snap-pools • status See also • create snap-pool • delete snap-pool • expand snap-pool • set snap-pool-policy • set snap-pool-threshold HP P2000 G3 MSA System CLI Reference Guide 243...
show snapshots Description Shows information about snapshots for a specified controller, master volume, or snap pool. If no parameters are specified, information about all snapshots is shown. Syntax show snapshots [controller a|b|both] [master-volume volume] [snap-pool volume] [type standard|replication|all] Parameters controller a|b|both Optional.
Page 245
Replication snapshot(Only sync point)(Current sync point)(Common sync point) vd03 vd03_V1_s001 2011-01-16 10:15:55 Available vd03_V1 spvd03_V1 352.8MB 352.8MB 0x6000 0x0000 Standard snapshot --------------------------------------------------------------------------- Basetypes • snapshots • status See also • show master-volumes • show snap-pools HP P2000 G3 MSA System CLI Reference Guide 245...
show snmp-parameters Description Shows SNMP settings for event notification. Syntax show snmp-parameters Output SNMP Trap Notification Level • crit: Only Critical events are sent as traps • error: Error and Critical events are sent as traps • warn: Warning, Error, and Critical events are sent as traps •...
SCSI Product ID: product-ID Enclosure Count: 2 Health: OK Health Reason: Supported Locales: English, Spanish, French, German, Italian, Japanese, Dutch, Chinese-Simplified, Chinese-Traditional, Korean Basetypes • system • status See also • set system HP P2000 G3 MSA System CLI Reference Guide 247...
show system-parameters Description Shows the current settings for the storage system. Syntax show system-parameters Output ULP Enabled Shows that the system is using Unified LUN Presentation, which can expose all LUNs through all host ports on both controllers. The interconnect information is managed in the controller firmware. ULP appears to the host as an active-active storage system where the host can choose any available path to access a LUN regardless of vdisk ownership.
Number of snapshots to retain with this prefix. When a new snapshot exceeds this limit, the oldest snapshot with the same prefix is deleted. Last Created Name of the last snapshot created by the task, or blank Snapshot Name Name of each snapshot taken, or blank HP P2000 G3 MSA System CLI Reference Guide 249...
Page 250
Snapshot Serial Serial number of each snapshot taken, or blank For a ResetSnapshot task: Task Name Task name Task Type ResetSnapshot Status • Uninitialized: Task is not yet ready to run • Ready: Task is ready to run • Active: Task is running •...
Page 251
Uninitialized: Task is not yet ready to run • Ready: Task is ready to run • Active: Task is running • Error: Task has an error • Invalid: Task is invalid HP P2000 G3 MSA System CLI Reference Guide 251...
Page 252
Task State Current step of the task: • Start • VerifyVolume • CreateName • RepVolume • VerifySnap Error Message Message if an error occurred while processing the task, or blank Primary Volume Name Name of the volume to replicate Primary Volume Serial Number Serial number of the volume to replicate Prefix Label that identifies copies created by this task.
Page 253
Snapshot Serial ------------------------------------------------------ MV_S0001 • tasks Basetypes • status See also • create schedule • create task • delete task • set task • show schedule-details • show schedules • show tasks HP P2000 G3 MSA System CLI Reference Guide 253...
show tasks Description Shows information about all tasks. Syntax show tasks Output For a TakeSnapshot task: Task Name Task name Task Type TakeSnapshot Status • Uninitialized: Task is not yet ready to run • Ready: Task is ready to run •...
Page 255
Error: Task has an error • Invalid: Task is invalid Task State Current step of the task: • Start • VerifyVolume • CreateName • ObtainMap • UnmapVolume • CreateVolume • RemapVolume • VerifyCreatedVolume HP P2000 G3 MSA System CLI Reference Guide 255...
Page 256
Error Message Message if an error occurred while processing the task, or blank Source Volume Name of the volume to be copied Source Volume Serial Serial number of the volume to be copied Destination Vdisk Name of the destination vdisk Destination Vdisk Serial Serial number of the destination vdisk Prefix...
Page 257
Error: Task has an error • Invalid: Task is invalid Task State Current step of the task; always Start Error Message Message if an error occurred while processing the task, or blank HP P2000 G3 MSA System CLI Reference Guide 257...
Page 258
Example Show information about all tasks: # show tasks Tasks ----- Task Name: Snap Task Type: TakeSnapshot Status: Ready Task State: Start Error Message: Task Details ------------ Source Volume: MV Source Volume Serial: SN Prefix: MV Count: 1 Last Created: MV_S0001 Snapshot Name Snapshot Serial ------------------------------------------------------...
Page 259
Task State: Start Error Message: Basetypes • tasks • status See also • create schedule • create task • delete task • set task • show schedule-details • show schedules • show task-details HP P2000 G3 MSA System CLI Reference Guide 259...
show unwritable-cache Description Shows This data cannot be written to disk because it is the percentage of unwritable data in the system. associated with a volume that no longer exists or whose disks are not online. If the data is needed, the volume’s disks must be brought online.
Standard English manage manage,monitor Standard English monitor monitor Standard English Rivera manage,monitor Standard Spanish ---------------------------------------------------------------------- Basetypes • users • status See also • create user • delete user • set user HP P2000 G3 MSA System CLI Reference Guide 261...
show vdisks Description Shows information for all or specified vdisks. Syntax show vdisks [vdisks] Parameters vdisks Optional. Names or serial numbers of the vdisks to show information about. For vdisk syntax, see Command syntax on page 21. Output Name Vdisk name Size Vdisk size Free...
Page 263
RAID0 Enabled - all spinning 900.1GB 900.1GB RAID1 OFFL INIT Disabled ------------------------------------------------------------------------- Basetypes • virtual-disks • status See also • create vdisk • delete vdisks • expand vdisk • set vdisk HP P2000 G3 MSA System CLI Reference Guide 263...
show vdisk-statistics Description Shows performance statistics for all or specified vdisks. Syntax show vdisk-statistics [vdisks] Parameters vdisks Optional. Names or serial numbers of the vdisks to show information about. For vdisk syntax, see Command syntax on page 21. If this parameter is omitted, information is shown for all vdisks. Output Name Vdisk name.
show volumecopy-status Description Shows information about in-progress volume copy operations. While a volume copy is in progress, the destination volume cannot be accessed. Syntax show volumecopy-status [controller a|b|both] Parameters controller a|b|both Optional. Shows volume copy operations for volumes owned by controller A only, by controller B only, or by either controller (both).
Volume View [Serial Number (SN) Name (v2) ] Mapping: Ports Access Host-Port-Identifier Nickname Profile ------------------------------------------------------------------ A1,B1 read-write 207000c0ff001121 Host2 Standard read-only 207000c0ff001122 Host1 Standard not-mapped all other hosts Standard Basetypes • volume-view • status HP P2000 G3 MSA System CLI Reference Guide 267...
Page 268
See also • show host-maps • show hosts • show volumes 268 Alphabetical list of commands...
Example Show volume names and serial numbers: # show volume-names Name Serial Number ------------------------ Data Data_s001 spData vd1_v1 ------------------------ Basetypes • volume-names • status See also • show volume-maps • show volumes HP P2000 G3 MSA System CLI Reference Guide 269...
show volumes Description Shows volume information for all or specified vdisks. Syntax show volumes [vdisk vdisks] [class standard|ptsnap] [type snap-pool|mastervolume|snapshot|standard|primary-volume |secondary-volume|replication-volume] [volumes] Parameters vdisk vdisks Optional. Names or serial numbers of the vdisks containing the volumes to show. For vdisk syntax, Command syntax on page 21.
Page 271
Default snapshot PTSNAP -------------------------------------------------------------------------- Basetypes • volumes • status See also • create volume • delete volumes • expand volume • set volume • show vdisks • show volume-maps HP P2000 G3 MSA System CLI Reference Guide 271...
show volume-statistics Description Shows performance statistics for all or specified volumes. Properties shown only in XML API format are described in XML API basetype properties on page 287. Syntax show volume-statistics [volumes] Parameters volumes Optional. Names or serial numbers of the volumes to show information about. For volume syntax, Command syntax on page 21.
Example Shut down the Storage Controller in controller A: # shutdown a Info: Shutting down SC a... See also • restart • show shutdown-status HP P2000 G3 MSA System CLI Reference Guide 273...
start vdisk Description Restarts a vdisk that was stopped in order to move its disks into this system. Starting a vdisk is part of the process for moving a secondary volume from a primary system into a secondary system. The process to move a secondary volume is: In the system where the secondary volume resides: a.
Example Stop vdisks vd1 and vd2, which respectively contain a secondary volume and its snap pool: # stop vdisk vd1 Success: Command completed successfully. # stop vdisk vd2 Success: Command completed successfully. See also • detach replication-volume • reattach replication-volume • show vdisks • start vdisk HP P2000 G3 MSA System CLI Reference Guide 275...
suspend replication Description Suspends the current replication operation on the specified replication volume. This command must be issued on the system that owns the secondary volume. Once suspended, the replication must be resumed or aborted to allow the replication volume to resume normal operation. Syntax suspend replication [set replication-set]...
These options behave the same as the notification option and remain for backward compatibility only. Example Test email and SNMP notification of events: # test notification Success: Command completed successfully. - The test event was sent. See also • set email-parameters • set snmp-parameters HP P2000 G3 MSA System CLI Reference Guide 277...
trust Description Enables an offline vdisk to be brought online for emergency data recovery. This command must be enabled before each use. CAUTION: This command can cause unstable operation and data loss if used improperly. It is intended for disaster recovery only. CAUTION: Do not use this command on a vdisk having critical status.
Info: The volume was unmapped. (V2) Success: Command completed successfully. - The volume(s) were unmapped. See also • map volume • show host-maps • show hosts • show volume-maps • show volumes HP P2000 G3 MSA System CLI Reference Guide 279...
verify links Description Verifies host-port links. If a remote system is specified, all link paths between the local system and the remote system are tested; otherwise, link paths between controller A and controller B in the local system are tested. The remote system must already have been added by using the create remote-system command.
Page 281
Verify all links between the local system and remote system System2: # verify links remote-system System2 Port Type Links --------------------------------------- iSCSI A1,A2,B1,B2 iSCSI A1,A2,B1,B2 iSCSI A1,A2,B1,B2 iSCSI A1,A2,B1,B2 --------------------------------------- Basetypes • remote-links See also • show remote-systems • verify remote-link HP P2000 G3 MSA System CLI Reference Guide 281...
verify remote-link Description Verifies host-port links between the local system and a specified remote system. All link paths, or only paths having a specified link type, between the two systems are tested. The remote system must already have been added by using the create remote-system command.For replication purposes, this tests the links to be used for replication from one system to another system.
Event Descriptions Reference Guide. Example Verify vdisk vd1: # verify vdisk vd1 Info: Command completed successfully. (vd1) - The verify was started on vdisk vd1. See also • abort verify • show vdisks HP P2000 G3 MSA System CLI Reference Guide 283...
versions Description Shows firmware and hardware version information for each controller module. Alias: show versions. Syntax versions [detail] Parameters detail Optional. Shows information about the versions of firmware and hardware in each controller module. 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...
This parameter applies only when the source volume is a snapshot. • yes: Include modified snapshot data. • no: Exclude modified snapshot data. If this parameter is omitted for a snapshot, modified snapshot data is excluded. HP P2000 G3 MSA System CLI Reference Guide 285...
Page 286
prompt yes|no|expert Optional. Specifies an automatic response to the prompt to unmount/unpresent/unmap the source volume before proceeding: • yes: Allow the 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.
18. • Example output from a command that uses the basetype. Some basetypes are used by multiple commands. • References to embedded or nested basetypes that the output may show. HP P2000 G3 MSA System CLI Reference Guide 287...
advanced-settings-table Properties Table 9 advanced-settings-table properties Name Type Description Shows whether disks in vdisks are automatically checked for disk defects to background- string ensure system health. scrub • Disabled: Background vdisk scrub is disabled. • Enabled: Background vdisk scrub is enabled. This is the default. Numeric equivalents for background-scrub values.
Page 289
Disabled: The super-capacitor failure trigger is disabled. • Enabled: The super-capacitor failure trigger is enabled. This is the default. Numeric equivalents for super-cap-failure values. super-cap- string failure-numeric • 0: Disabled • 4: Enabled HP P2000 G3 MSA System CLI Reference Guide 289...
Page 290
Table 9 advanced-settings-table properties (continued) Name Type Description Shows whether the cache policy will change from write-back to write-through compact-flash- string when CompactFlash memory is not detected during POST, fails during POST, or failure fails during controller operation. • Disabled: The CompactFlash failure trigger is disabled. •...
Retention priority for the corresponding attribute. Priority values are 0–65535. priority-value string Lower-priority snapshots will be deleted before higher-priority snapshots. Example # show priorities vd01_sp001 <OBJECT basetype="attribute-priorities" name="attribute-priorities" oid="1" format="rows"> <PROPERTY name="attribute-name" type="string">Standard Snapshot</PROPERTY> <PROPERTY name="priority-value" type="string">0x6000 (default)</PROPERTY> </OBJECT> HP P2000 G3 MSA System CLI Reference Guide 293...
auto-write-through-trigger Properties Table 1 1 auto-write-through-trigger properties Name Type Description Shows whether the cache policy will change from write-back to write-through controller- string when a controller fails. failure • Disabled: The controller failure trigger is disabled. This is the default. •...
Page 295
<PROPERTY name="auto-write-back" type="string">Enabled</PROPERTY> </OBJECT> HP P2000 G3 MSA System CLI Reference Guide 295...
cache-parameter Properties Table 12 cache-parameter properties Name Type Description If a volume is specified, its serial number. serial-number string If a volume is specified, its name. volume-name string If a volume is specified, its cache write policy. write-policy string • write-back: Write-back caching does not wait for data to be completely written to disk before signaling the host that the write is complete.
cache-settings Properties Table 13 cache-settings properties Name Type Description The operation mode, also called the redundancy mode. operation-mode string • Active-Active ULP: Both controllers are active using ULP (Unified LUN Presentation). • Single Controller: There is only a single controller in the enclosure. Numeric equivalents for operation-mode values.
For mutual CHAP, the secret that the originator uses to authenticate the recipient. osecret string Example # show chap-records <OBJECT basetype="chap-records" name="chap-records" oid="1" format="pairs"> <PROPERTY name="initiator-name" type="string">test1</PROPERTY> <PROPERTY name="initiator-secret" type="string">test1secret!</PROPERTY> <PROPERTY name="oname" type="string"></PROPERTY> <PROPERTY name="osecret" type="string"></PROPERTY> </OBJECT> HP P2000 G3 MSA System CLI Reference Guide 299...
cli-parameters Properties Table 15 cli-parameters properties Name Type Description Time in seconds that the session can be idle before it automatically ends. Valid timeout uint32 values are 120–43200 seconds (2–720 minutes). The default is 1800 seconds (30 minutes). • console: Supports interactive use of the CLI by displaying command output output-format string in easily readable format.
Page 301
1: MB • 2: GB • 3: TB • Fahrenheit: Temperatures are shown in degrees Fahrenheit. temperature- string • Celsius: Temperatures are shown in degrees Celsius. This is the default. scale HP P2000 G3 MSA System CLI Reference Guide 301...
Page 302
Table 15 cli-parameters properties (continued) Name Type Description Numeric equivalents for temperature-scale values. temperature- string scale-numeric • 0: Fahrenheit • 1: Celsius User interface refresh rate. The default is 30 seconds. ui-refresh uint16 The logged-in user's experience level. user-type string •...
• 3: Unknown Indicates whether the controller has failed over to the partner controller. failed-over string • No: The controller is not failed over. • Yes: The controller is failed over. HP P2000 G3 MSA System CLI Reference Guide 307...
Page 308
Table 18 controllers properties (continued) Name Type Description Numeric equivalents for failed-over values. failed-over- string numeric • 0: No • 1: Yes If failed-over is No, Not applicable appears; otherwise, one of the fail-over- string reasons in the next row appears. reason Numeric equivalents for fail-over-reason values.
Page 309
Numeric equivalents for phy-isolation values. phy-isolation- string numeric • 0: Enabled • 1: Disabled Example # show controllers <OBJECT basetype="controllers" name="controllers" oid="1" format="pairs"> <PROPERTY name="durable-id" type="string">controller_a</PROPERTY> <PROPERTY name="controller-id" type="string">A</PROPERTY> <PROPERTY name="controller-id-numeric" type="string">1</PROPERTY> <PROPERTY name="serial-number" type="string">SN</PROPERTY> HP P2000 G3 MSA System CLI Reference Guide 309...
Storage Controller debug log. • Off: Disabled. • On: Enabled. This is the default. Numeric equivalents for ioa values. ioa-numeric string • 0: Off • 1: On HP P2000 G3 MSA System CLI Reference Guide 313...
Page 314
Table 20 debug-log-parameters properties (continued) Name Type Description Shows whether resource-count debug messages for an I/O interface driver are string enabled for inclusion in the Storage Controller debug log. • Off: Disabled. This is the default. • On: Enabled. Numeric equivalents for iob values. iob-numeric string •...
Page 315
Storage Controller debug log. • Off: Disabled. This is the default. • On: Enabled. Numeric equivalents for awt values. awt-numeric string • 0: Off • 1: On HP P2000 G3 MSA System CLI Reference Guide 315...
Page 316
Table 20 debug-log-parameters properties (continued) Name Type Description Shows whether internal debug messages are enabled for inclusion in the res2 string Storage Controller debug log. • Off: Disabled. This is the default. • On: Enabled. Numeric equivalents for res2 values. res2-numeric string •...
disk-statistics Properties Table 21 disk-statistics properties Name Type Description Disk ID in the form disk_enclosure-number.disk-number. durable-id string Disk serial number. serial-number string Data transfer rate calculated over the interval since these statistics were last bytes-per- string requested or reset. This value will be zero if it has not been requested or reset second since a controller restart.
drive-parameters Properties Table 22 drive-parameters properties Name Type Description Shows whether disk SMART is enabled. smart string • Detect-Only: Allows each current disk to retain its individual SMART setting and does not change the settings of new disks added to the system. •...
drives Properties Table 23 drives properties Name Type Description Disk ID in the form disk_enclosure-ID.slot-number. durable-id string Enclosure ID. enclosure-id uint32 Disk slot ID. slot uint32 Disk's enclosure ID and slot ID. location string For internal use only. port uint32 SCSI ID assigned to this disk for the primary channel.
Page 323
Port 2 device ID. fc-p2-device-id uint32 Port 2 WWNN. fc-p2-node-wwn string Port 2 WWPN. fc-p2-port-wwn string Port 2 unit number. fc-p2-unit- uint32 number Numeric code indicating why the disk is down. drive-down-code uint8 HP P2000 G3 MSA System CLI Reference Guide 323...
Page 324
Table 23 drives properties (continued) Name Type Description Current owner, which is either the preferred owner during normal operation or owner string the partner controller when the preferred owner is offline. • A: Controller A. • B: Controller B. Numeric equivalents for owner values. owner-numeric string •...
Table 28 enclosures properties (continued) Name Type Description Numeric equivalents for health values. MC team: health-numeric string • 0: OK • 1: Degraded • 2: Fault • 4: N/A More information about the health value. health-reason string If health is not OK, this indicates whether this component or one of its health-blame string subcomponents is to blame.
Page 335
1: On Example # show enclosures <OBJECT basetype="enclosures" name="enclosures" oid="1" format="rows"> <PROPERTY name="durable-id" type="string">enclosure_0</PROPERTY> <PROPERTY name="enclosure-id" type="uint8">0</PROPERTY> <PROPERTY name="enclosure-wwn" type="string">500c0ff0d8b6cb3c</PROPERTY> <PROPERTY name="name" type="string"></PROPERTY> <PROPERTY name="location" type="string"></PROPERTY> <PROPERTY name="rack-number" type="uint8">0</PROPERTY> <PROPERTY name="rack-position" type="uint8">0</PROPERTY> HP P2000 G3 MSA System CLI Reference Guide 335...
expander-ports Properties Table 30 expander-ports properties Name Type Description Expander port ID. durable-id string Enclosure ID. enclosure-id uint32 • A: Controller A. controller string • B: Controller B. Numeric equivalents for controller values. controller- string numeric • 0: B • 1: A name string...
Page 339
<PROPERTY name="status-numeric" type="string">6</PROPERTY> <PROPERTY name="health" type="string">N/A</PROPERTY> <PROPERTY name="health-numeric" type="string">4</PROPERTY> <PROPERTY name="health-reason" type="string">All PHYs are disconnected</PROPERTY> </OBJECT> HP P2000 G3 MSA System CLI Reference Guide 339...
Properties Table 31 fan properties Name Type Description Fan unit ID in the form fan_enclosure-ID.fan-number. durable-id string Fan unit name in the form Fan loc:position-PSU power-supply-ID, name string where the position is as viewed from the back of the enclosure. Fan unit location in the form Enclosure enclosure-ID - position, location string...
hosts Properties Table 34 hosts properties Name Type Description FC or SAS host port WWN, or iSCSI host initiator node name (typically the host-id string IQN). User-defined name of the host port, or blank. host-name string • Yes: The host was discovered and its entry was automatically created. host-discovered string •...
HP-UX: The host allows LUN 0 to be assigned to a mapping and uses Flat Space Addressing. Example # show host-maps <OBJECT basetype="host-view" name="host-view" oid="1" format="labeled"> <PROPERTY name="id" key="true" type="string">2ffc00c0dd13a447</PROPERTY> <PROPERTY name="hba-nickname" type="string">Lab_server</PROPERTY> <PROPERTY name="host-profile" type="string">Standard</PROPERTY> </OBJECT> Embedded basetypes • host-view-mappings HP P2000 G3 MSA System CLI Reference Guide 345...
host-view-mappings Properties Table 36 host-view-mappings properties Name Type Description Volume name. volume-name string Volume serial number. volume-serial string LUN assigned to the mapping. string Type of access assigned to the mapping. access string • read-write: Host has read and write access to the volume. •...
iscsi-parameters Properties Table 38 iscsi-parameters properties Name Type Description Shows whether Challenge-Handshake Authentication Protocol (CHAP) is chap string enabled. • Enabled: CHAP is enabled. • Disabled: CHAP is disabled. This is the default. Numeric equivalents for chap values. chap-numeric string •...
iscsi-port Properties Table 39 iscsi-port properties Name Type Description iSCSI IP version. ip-version string • 4: iSCSI host port addresses use IPv4 format. This is the default. • 6: iSCSI host port addresses use IPv6 format. Primary IP address. primary-ip- string address Primary gateway IP address.
license Properties Table 41 license properties Name Type Description • key: License is installed and valid. license-key string • not installed: License is invalid or is not installed. Maximum number of snapshots that the highest-level license allows. platform-max- uint32 snapshots Maximum number of snapshots allowed without an installed license.
Page 353
Numeric equivalents for dsd-expiry values. dsd-expiry- string numeric • 0: Never Example # show license <OBJECT basetype="license" name="license" oid="1"> <PROPERTY name="license-key" key="true" type="string">key</PROPERTY> <PROPERTY name="platform-max-snapshots" type="uint32">1024</PROPERTY> <PROPERTY name="base-max-snapshots" type="uint32">0</PROPERTY> <PROPERTY name="max-snapshots" type="uint32">128</PROPERTY> HP P2000 G3 MSA System CLI Reference Guide 353...
master-volumes Properties Table 43 master-volumes properties Name Type Description Vdisk name. virtual-disk- string name Master volume serial number. serial-number string Master volume name. name string Master volume size, formatted to use the current base, precision, and units. size string Unformatted size value in 512-byte blocks. size-numeric string Master volume status.
ntp-status Properties Table 45 ntp-status properties Name Type Description Shows whether use of Network Time Protocol (NTP) is enabled. ntp-status string • activated: NTP is enabled. • deactivated: NTP is disabled. This is the default. • 0.0.0.0: NTP server IP address is not set. ntp-server- string •...
port Properties Table 47 port properties Name Type Description Controller host port ID in the form hostport_controller-ID-and-port- durable-id string number. • A: Controller A. controller string • B: Controller B. Numeric equivalents for controller values. controller- string numeric • 0: B •...
Page 361
Degraded • Fault • Numeric equivalents for health values. health-numeric string • 0: OK • 1: Degraded • 2: Fault • 4: N/A More information about the health value. health-reason string HP P2000 G3 MSA System CLI Reference Guide 361...
Voltage of the 5-volt power supply, in 100th of a volt. dc5v uint32 Voltage of the 3.3-volt power supply, in 100th of a volt. dc33v uint32 • health string • Degraded • Fault • HP P2000 G3 MSA System CLI Reference Guide 363...
Page 364
Table 48 power-supplies properties (continued) Name Type Description Numeric equivalents for health values. health-numeric string • 0: OK • 1: Degraded • 2: Fault • 4: N/A More information about the health value. health-reason string If health is not OK, this indicates whether this component or one of its health-blame string subcomponents is to blame.
redundancy Properties Table 49 redundancy properties Name Type Description • Active-Active ULP: Both controllers are active using ULP (Unified LUN redundancy-mode string Presentation). Data for volumes configured to use write-back cache is automatically mirrored between the two controllers to provide fault tolerance. •...
refresh-counters Properties This basetype displays properties from other basetypes. Table 50 refresh-counters properties Name Type Description (Not Shows when the data represented by the base type was last updated. basetype-name shown) • 0: The data has never been updated and is not cached. •...
remote-addresses Properties Table 51 remote-addresses properties Name Type Description • port-IDs: For a remote primary or secondary volume, the IDs of up to two connected-ports string hosts ports in the local system that are connected to the remote system. If two ports are connected but only one is shown, this indicates that a problem is preventing half the available bandwidth from being used.
remote-system Properties Table 53 remote-system properties Name Type Description Remote system ID. string • Remote system name. system-name string • Uninitialized Name: The default value. • Name of person who administers the remote system. system-contact string • Uninitialized Contact: The default value. •...
replicate-volume-tasks Properties Table 54 replicate-volume-tasks properties Name Type Description Primary volume name. primary-volume- string name Primary volume serial number. primary-volume- string serial A label to identify snapshots created by this task. Snapshot names have the snapshot-prefix string format prefix_s#, where # starts at 001. •...
replication-image-params Properties Table 56 replication-image-params properties Name Type Description Replication image status. status string • N/A: The image information is not valid. • Queued: The image is known to exist in the primary-view volume but replication has not started. • Replicating: The image is being replicated.
replication-set Properties Table 57 replication-set properties Name Type Description Replication set name. name string Replication set serial number. serial-number string Example # show replication-sets <OBJECT basetype="replication-set" name="volume" oid="1" format="labeled"> <PROPERTY name="name" type="string">rsvdTx_iscsi_r</PROPERTY> <PROPERTY name="serial-number" key="true" type="string">SN</PROPERTY> </OBJECT> Embedded basetypes • replication-volume 378 XML API basetype properties...
OK: Communication to the remote volume is successfully occurring on the network. • Failed: Communication to the remote volume has failed because of a communication issue or because the remote volume has gone offline. HP P2000 G3 MSA System CLI Reference Guide 379...
Page 380
Table 58 replication-volume properties (continued) Name Type Description Numeric equivalents for monitor values. monitor-numeric string • 2: OK • other: Failed • Local: The replication volume is in the local system. location string • Remote: The replication volume is in a remote system. Numeric equivalents for location values.
Page 381
Replication set serial number. replication-set string Local replication volume serial number. local-volume- string serial-number Example # show replication-volumes <OBJECT basetype="replication-volume" name="replication-volume" oid="1" format="rows"> <PROPERTY name="name" type="string">vdRx_v001</PROPERTY> <PROPERTY name="serial-number" key="true" type="string">SN</PROPERTY> <PROPERTY name="status" type="string">Online</PROPERTY> HP P2000 G3 MSA System CLI Reference Guide 381...
reset-snapshot-tasks Properties Table 60 reset-snapshot-tasks properties Name Type Description Name of the snapshot to reset. snapshot-name string Serial number of the snapshot to reset. snapshot-serial string Example # show tasks <OBJECT basetype="reset-snapshot-tasks" name="task-reset-snapshot" oid="2" format="pairs"> <PROPERTY name="snapshot-name" type="string">vdRx_v001_s001</PROPERTY> <PROPERTY name="snapshot-serial" type="string">SN</PROPERTY> </OBJECT>...
Type Description • configured- string Direct topology Number of PHY lanes in the SAS port. width string Example # show ports <OBJECT basetype="sas-port" name="port" oid="2" format="rows"> <PROPERTY name="configured-topology">Direct</PROPERTY> <PROPERTY name="width">4</PROPERTY> </OBJECT> HP P2000 G3 MSA System CLI Reference Guide 385...
sas-status-controller-a Properties Table 62 sas-status-controller-a properties Name Type Description Enclosure ID. enclosure-id uint32 • A: Controller A. controller string • B: Controller B. Numeric equivalents for controller values. controller- string numeric • 0: B • 1: A Logical ID of the PHY within a group based on the PHY type. uint32 •...
Page 387
Drive removed: PHY disabled because drive slot is empty. • Unused - disabled by default: PHY is disabled by default because it is not used. • Excessive PHY changes: PHY is disabled because of excessive PHY change counts. HP P2000 G3 MSA System CLI Reference Guide 387...
Page 388
Table 62 sas-status-controller-a properties (continued) Name Type Description Numeric equivalents for elem-reason values. elem-reason- string numeric • 0: (blank) • 32769: Error count interrupts • 32770: Externally disabled • 32771: PHY control • 32772: Not ready • 32773: Firmware reboot •...
security-communications-protocols Properties Table 64 security-communications-protocols properties Name Type Description • Disabled: The standard SMU web server is disabled. wbi-http string • Enabled: The standard SMU web server is enabled. This is the default. Numeric equivalents for wbi-http values. wbi-http- string numeric •...
sensors Properties Table 65 sensors properties Name Type Description Sensor name and location. sensor-name string • For a sensor, its value. value string • For overall unit status, one of the status values below. • OK: The sensor is present and detects no error condition. status string •...
• up: The controller is operational. status string • down: The controller is shut down. Example # show shutdown-status <OBJECT basetype="shutdown-status" name="controller" oid="1" format="packed"> <PROPERTY name="controller" type="string">A</PROPERTY> <PROPERTY name="status" type="string">up</PROPERTY> </OBJECT> HP P2000 G3 MSA System CLI Reference Guide 395...
snap-pools Properties Table 68 snap-pools properties Name Type Description Vdisk name. virtual-disk- string name Snap pool serial number. serial-number string Snap pool name. name string Snap pool size, formatted to use the current base, precision, and units. size string Unformatted size value in 512-byte blocks. size-numeric string Amount of free space in this snap pool, formatted to use the current base,...
Unformatted snap-data value in 512-byte blocks. snap-data- string numeric Amount of preserved and write data that is unique to the snapshot. uniquedata string Unformatted uniquedata value in 512-byte blocks. uniquedata- string numeric HP P2000 G3 MSA System CLI Reference Guide 397...
Page 398
Table 69 snapshots properties (continued) Name Type Description Amount of preserved and write data that is shared between this snapshot and shareddata string other snapshots. Unformatted shareddata value in 512-byte blocks. shareddata- string numeric Retention priority for the snapshot, based on the snapshot attributes and the user- priority-value string defined priority for the snapshot type.
snapshot-with-retention-tasks Properties Table 70 snapshot-with-retention-tasks properties Name Type Description Source volume name. master-volume- string name Source volume serial number. master-volume- string serial A label to identify snapshots created by this task. Snapshot names have the snapshot-prefix string format prefix_s#, where # starts at 001. Number of snapshots to retain with this prefix, from 1 to 32.
snmp-parameters Properties Table 72 snmp-parameters properties Name Type Description Shows whether the Simple Network Management Protocol (SNMP) interface is snmp-enabled string enabled or disabled. • Disabled: SNMP is disabled. This is the default. • Enabled: SNMP is enabled. Numeric equivalents for snmp-enabled values. snmp-enabled- string numeric...
system Properties Table 74 system properties Name Type Description Storage system name. The default is Uninitialized Name. system-name string The name of person who administers the system. The default is system-contact string Uninitialized Contact. The location of the system. The default is Uninitialized Location. system-location string A brief description of what the system is used for or how it's configured.
system-parameters-table Properties Table 75 system-parameters-table properties Name Type Description Shows whether the system is using Unified LUN Presentation (ULP). ulp-enabled string • true: ULP is enabled. Shows whether host profiles are enabled, which determines whether LUN 0 can profiles- string be assigned to volume mappings.
For a ResetSnapshot task: • Start • VerifySnap • UnmapSnap • ResetSnap • For a VolumeCopy task: • Start • VerifyVolume • CreateName • ObtainMap • UnmapVolume • CreateVolume • RemapVolume • VerifyCreatedVolume HP P2000 G3 MSA System CLI Reference Guide 409...
Page 410
Table 76 tasks properties (continued) Name Type Description • For a ReplicateVolume task: • Start • VerifyVolume • CreateName • RepVolume • VerifySnap • For an EnableDSD or DisableDSD task: • Start Message if an error occurred while processing the task, or blank. error-message string For a VolumeCopy task, the serial number of the destination vdisk.
NTP server IP address, or 0.0.0.0 if not set. ntp-address string Example # show controller-date <OBJECT basetype="time-settings-table" name="time-settings-table" oid="1"> <PROPERTY name="date-time" type="string">2010-11-08 11:48:08</PROPERTY> <PROPERTY name="date-time-numeric" type="string">1289216888</PROPERTY> <PROPERTY name="time-zone-offset" type="sint32">0</PROPERTY> <PROPERTY name="ntp-state" type="string">Disabled</PROPERTY> <PROPERTY name="ntp-address" type="string">0.0.0.0</PROPERTY> </OBJECT> HP P2000 G3 MSA System CLI Reference Guide 411...
Total percentage of cache memory used for unwritable data in controller A. unwritable-b- uint8 percentage Example # show unwritable-cache <OBJECT basetype="unwritable-cache" name="unwritable-system-cache" oid="1" format="pairs"> <PROPERTY name="unwritable-a-percentage" type="uint8">0</PROPERTY> <PROPERTY name="unwritable-b-percentage" type="uint8">0</PROPERTY> </OBJECT> HP P2000 G3 MSA System CLI Reference Guide 413...
users Properties Table 80 users properties Name Type Description User name. username string • monitor: View-only access to selected user interfaces. This is the default. roles string • manage: Modify access to selected user interfaces. The user's level of technical expertise: Novice, Standard, Advanced, or user-type string Diagnostic.
vdisk-statistics Properties Table 81 vdisk-statistics properties Name Type Description Vdisk name. name string Vdisk serial number. serial-number string Data transfer rate calculated over the interval since these statistics were last bytes-per- string requested or reset. This value will be zero if it has not been requested or reset second since a controller restart.
virtual-disks Properties Table 83 virtual-disks properties Name Type Description Vdisk name. name string Vdisk capacity, formatted to use the current base, precision, and units. size string Unformatted size value in 512-byte blocks. size-numeric string Amount of free space in the vdisk, formatted to use the current base, precision, freespace string and units.
Page 419
Date and time, in the format year-month-day hour:minutes:seconds create-date string (UTC), when the vdisk was created. Unformatted create-date value. create-date- string numeric Not used. cache-read- string ahead Not used. cache-read- string ahead-numeric HP P2000 G3 MSA System CLI Reference Guide 419...
Page 420
Table 83 virtual-disks properties (continued) Name Type Description Not used. cache-flush- uint32 period Not used. read-ahead- string enabled Not used. read-ahead- string enabled-numeric Not used. write-back- string enabled Not used. write-back- string enabled-numeric Number of read operations since these statistics were last reset or since the number-of-reads uint32 controller was restarted.
Page 421
• Numeric equivalents for health values. health-numeric string • 0: OK • 1: Degraded • 2: Fault • 3: Unknown • 4: N/A More information about the health value. health-reason string HP P2000 G3 MSA System CLI Reference Guide 421...
Page 422
Table 83 virtual-disks properties (continued) Name Type Description If health is not OK, this indicates whether this component or one of its health-blame string subcomponents is to blame. • none: This component and its subcomponents are ok. • self: This component has a problem. •...
Numeric equivalents for cache-optimization values. cache- string optimization- • 0: standard numeric • 1: super-sequential HP P2000 G3 MSA System CLI Reference Guide 427...
Page 428
Table 87 volumes properties (continued) Name Type Description The volume's read-ahead cache setting. read-ahead-size string • Disabled: Read-ahead caching is disabled. • Default: One chunk for the first access in a sequential read and one stripe for all subsequent accesses. •...
Number of read pre-fetch or anticipatory-read operations. read-ahead- uint64 operations Cache size used on behalf of this volume. write-cache- uint16 space Percentage of cache used on behalf of this volume. write-cache- uint32 percent HP P2000 G3 MSA System CLI Reference Guide 431...
volume-view-mappings Properties Table 90 volume-view-mappings properties Name Type Description • Controller host ports that the mapping applies to. ports string • Blank if not mapped or mapped as no-access. • LUN that identifies the volume to a host. string • Blank if not mapped or mapped as no-access.
Volume-mapping settings that specify no access to that volume by hosts. See also default mapping and explicit mapping. master volume A volume that is enabled for snapshots and has an associated snap pool. HP P2000 G3 MSA System CLI Reference Guide 437...
Page 438
Management Controller. The processor (located in a controller module) that is responsible for human-computer interface and computer-computer interface functions, and interacts with the SC. metadata Data in the first sectors of a disk drive that stores all disk, vdisk, and volume specific information including vdisk membership or spare identification, vdisk ownership, volumes and snapshots in the vdisk, host mapping of volumes, and results of the last media scrub.
Page 439
WWNN World Wide Node Name. A globally unique 64-bit number that identifies a node process. WWPN World Wide Port Name. A globally unique 64-bit number that identifies a node port. HP P2000 G3 MSA System CLI Reference Guide 439...
See CHAP volume copy CHAP volume, host, and mapping create record CompactFlash card status delete records show enable/disable CompactFlash failure trigger set record enable/disable show records show setting show setting HP P2000 G3 MSA System CLI Reference Guide 441...
Page 442
configuration show system SMART setting show system show vdisk scrub interval setting controller show vdisk scrub setting notify partner when auto-write-through is triggered document conventions show failover status and reason prerequisite knowledge show ID being accessed (local) related documentation show partner notification setting documentation, HP web site show shutdown status dynamic spares...
Page 443
Subscriber’s choice web site expand technical support roll back data web sites HTTP interface enable/disable HTTP interface to XML API HP P2000 G3 MSA System CLI Reference Guide 443...
Page 444
master volumes power supply failure trigger convert to standard enable/disable create show setting delete precision for storage-space sizes delete all set CLI show set user metadata show CLI clear disk prerequisite knowledge midplane primary volume show abbreviated serial number missing LUN response priorities set snap-pool retention show...
Page 445
HP P2000 G3 MSA System CLI Reference Guide 445...
Page 446
show configuration show role show information show type utility priority show task schedule See schedules tasks create variable parameter values delete vdisk abort scrub show abort verification show details start technical support, HP stop Telnet interface syntax enable/disable trust for emergency data recovery temperature verify enable/disable controller shutdown for high...
Page 447
XML API accessing via HTTP interface basetype list DTD content and version enable/disable brief format enable/disable output examples optimization scripting guidelines show data omitted by brief mode using HP P2000 G3 MSA System CLI Reference Guide 447...