HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide Part number: 500912-002 Second edition: September 2009
Legal and notice information © Copyright 2009 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Microsoft and Windows are U.S.
Contents About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document conventions and symbols . . . . . . .
create volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . create volume-copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . create volume-set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . delete all-master-volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
set snap-pool-threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . set snmp-parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . set spares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . set system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
unmap volume . . . . . . verify vdisk . . . . . . . . versions. . . . . . . . . . . volumecopy . . . . . . . . . . . . .. .. .. .. . . . . .. .. .. .. .. .. .. .. . . . . .. .. .. .. .. .. .. .. . . . . .. .. .. .. . . . . .. .. .. .. .. .. .. .. . . . . .. .. .. .. .. .. .. .. . . . . .. .. .. .. . . . . .. .. .. .. .. .. .. .. . . . . .. .. .. .. .. .. .. .. . . . . .. .. .. .. . . . . .. .. .. .. .. .. .. .. . . . . . . . . ... ... ... ... . . . . . . . . . . . . . . .
Tables 1 2 3 4 5 6 7 Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Default usernames and passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 XML API elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Keyboard shortcuts for command completion, editing, and history . . . . . . .
About this guide This guide provides information about managing an HP StorageWorks 2000 G2 Modular Smart Array storage system by using its command-line interface (CLI). Intended audience This guide is intended for storage system administrators.
CAUTION: NOTE: Indicates that failure to follow directions could result in damage to equipment or data. Provides additional information. HP technical support Telephone numbers for worldwide technical support are listed on the HP support web site: http://www.hp.com/support/.
1 Using the CLI This chapter introduces the HP StorageWorks 2000 G2 Modular Smart Array command-line interface (CLI). Accessing the CLI The CLI software embedded in controller modules enables you to manage a storage system out of band. You can access the CLI in two ways: • By using Telnet, an SSH application, or a terminal emulator on a management host that is remotely connected through a LAN to a controller module’s network port.
Using CLI interactively By default the CLI is an interactive application. When you are logged into the CLI, the CLI waits for a command to be entered and then responds to it. The following example shows interactively starting a Telnet session, logging into the CLI, executing a command to show free (available) disks, and exiting the CLI: $: telnet 172.22.5.
The above shows a Perl script for logging in. cLogin is called at the start of the script to log a user into the CLI. The script uses the command-line parameters specified as the IP address, username, and password. After the user has been logged in, other commands can be sent to the CLI. For scripting support, change the CLI output mode from the default, console, which produces human-readable output, to API, which produces XML output.
Table 3 Element XML API elements (continued) Description and attributes PROPERTY A PROPERTY element provides detail about the attributes of an OBJECT. A property has these attributes: • name. The unique name for the property within the object. • type. The type of data represented by the element data. • size. Typically the maximum size of the output. Usually only important if the console output is displayed in rows. • draw. Whether to show or hide this data in console format. • sort.
The recommended command to enable XML API mode is set cli-parameters api pager off, which displays output without pausing after each screenful of data. The following example shows how output of the show volumes command appears in XML API mode: # show volumes
0 The following example shows XML API output from the create vdisk command: # create vdisk vd-1 disks 2.6,2.7,2.8 level r5
XML API basetypes The following basetypes can be used when calling the meta command to obtain complete metadata for all CLI objects.
In the following example, embedded objects contain media-specific detail for ports, and only name and key properties are shown:
Command syntax Keywords and parameters Command keywords must be entered in lowercase. Parameter values can be entered in uppercase and lowercase. Unless otherwise specified, a parameter value can include any valid UTF-8 characters except backslash (\), comma, double quote ("), and control characters. A parameter value that includes a space must be enclosed in double quotes. Parameters such as names of users and volumes have a maximum length in bytes.
Command completion, editing, and history The CLI supports command completion, command editing, and command history. When entering commands interactively you can abbreviate their names and keywords. For example, you can enter sho cl to run the show cli-parameters command. If you enter too few letters to uniquely identify a keyword, pressing Tab will list commands or keywords that match the entered string and redisplays the string so you can complete it.
To view the information shown in this topic and in Command completion, editing, and history above, enter: help help Size representations Operating systems usually show volume size in base 2. Disk drives usually show size in base 10. Memory size is always shown in base 2. In the CLI, the base for entry and display of storage-space sizes can be set per user or per session; see create user and set cli-parameters. When entering storage-spaces sizes only, either base-2 or base-10 units can be specified.
Using the CLI
2 Categorical list of commands This chapter helps you find a command within a category of functionally related commands. A command might appear in more than one category.
Table 7 Commands by category (continued) Category Commands Scheduled tasks create schedule show schedule-details create task show schedules delete schedule show task-details delete task show tasks set email-parameters show events set snmp-parameters show snmp-parameters show email-parameters test Event notification System clear cache configuration create chap-record and utilities delete chap-records show controller-date show controllers show disk-parameters ping show enclosures reset
3 Alphabetical list of commands This chapter is organized to help you find a command by name.
abort scrub Description Aborts the scrub vdisk operation for specified vdisks. Syntax abort scrub vdisk vdisks Parameters vdisks Names or serial numbers of the vdisks to stop scrubbing.
abort verify Description Aborts the verify vdisk operation for specified vdisks. Syntax abort verify vdisk vdisks Parameters vdisks Names or serial numbers of the vdisks to stop verifying.
abort volumecopy Description Aborts copying a volume. When the abort is complete, the destination volume is deleted. Syntax abort volumecopy volume Parameters volume Name or serial number of the source or destination volume. Example Abort creating destination volume vd1_copy: # abort volumecopy v1_copy Success: Command completed successfully. - The volume copy was aborted.
clear cache Description Clears unwritable cache data from both controllers. This data cannot be written to disk because it is associated with a volume that no longer exists or whose disks are not online. If the data is needed, the volume's disks must be brought online. If the data is not needed it can be cleared, in which case it will be lost and data will differ between the host and disk. Unwritable cache is also called orphan data.
clear disk-metadata Description Clears metadata from “leftover” disks. Each disk contains metadata that the system uses to identify the disk's owning vdisk, if any. If the system cannot locate the vdisk, as when the disk has been moved to a different system, the owning vdisk is shown as Leftover. A leftover disk’s Fault/UID LED is illuminated amber. You must clear the metadata before you can use the disk in a different vdisk or as a spare.
clear events Description For use by or with direction from a service technician. Clears the event log for controller A, B, or both. Syntax clear events [a|b|both] Parameters a|b|both Optional. The controller event log to clear. If this parameter is omitted, both event logs are cleared. Example Clear the event log for controller A: # clear events a Success: Command completed successfully. - Controller A event log was successfully cleared.
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. NOTE: If a rescan is in progress, the clear operation will fail with an error message saying that an EMP does exist. Wait for the rescan to complete and then retry the clear operation.
convert master-to-std Description Converts a specified master volume into a standard volume; that is, it disables the volume from accepting snapshots. If the specified volume has associated snapshots, you must delete the snapshots before converting the volume. Syntax convert master-to-std master-volume Parameters master-volume Name or serial number of the master volume to convert. For syntax, see Command syntax.
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 standard-volume Parameters snap-pool snap-pool Name or serial number of the snap pool to associate with the new master volume. For syntax, see Command syntax.
create chap-record Description For iSCSI, creates a CHAP record to authenticate login requests. When CHAP is enabled, the record enables authentication between the originator (initiator) and recipient (target) of a login request. This command is permitted whether or not CHAP is enabled. The CHAP record can specify one name-secret pair to authenticate the originator only (one-way CHAP) or two pairs to authenticate both the originator and the recipient (mutual CHAP).
create host Description Creates a host entry with an associated nickname. When mapping volumes to hosts the nickname can make a host easy to recognize. Syntax create host id ID nickname [profile standard|openvms|hp-ux] Parameters id ID For FC and SAS, the host node's 16-hex-digit WWPN. For iSCSI, the initiator's IQN. A host ID cannot have more than one entry in the system. nickname A nickname for the host node.
create master-volume Description Creates a volume that is enabled for snapshots. The master volume is created in a specified vdisk and is associated with a specified snap pool. The vdisk and snap pool must be owned by the same controller. Syntax create master-volume vdisk vdisk size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] snap-pool snap-pool [lun LUN] [ovms-uid ID] name Parameters vdisk vdisk Name or serial number of the vdisk to create the volume in. For syntax, see Command syntax.
create schedule Description Schedules a task to run automatically. Syntax create schedule schedule-specification "specification" task-name task-name schedule-name Parameters schedule-specification "specification" Defines when the task will first run, and optionally when it will recur and expire. You can use a comma to separate optional conditions. Dates cannot be in the past. • start mm/dd/yyyy hh:mm [AM|PM] If neither AM nor PM is specified, a 24-hour clock is used.
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 syntax, see Command syntax. size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] Sets the volume size using the current base, as shown by show cli-parameters.
create snapshots Description Creates a snapshot of each specified source volume. The source volume can be a standard volume or a master volume. The first time a snapshot is created of a standard volume, the volume is converted to a master volume and a snap pool is created. The snap pool's size is 20% of the volume size or 10 GB, whichever is larger. Before creating or scheduling snapshots, verify that the vdisk has enough free space to contain the snap pool.
create task Description Creates a task that can be scheduled. You can create a task to take a snapshot of a master volume, to copy a snapshot or a master volume to a new standard volume, or to reset a snapshot. CAUTION: Before scheduling a reset snapshot task, consider that if the snapshot is mounted to a host operating system, the snapshot must be unmounted before the reset is performed; leaving it mounted can cause data corruption.
dest-prefix prefix Optional. A label to identify the volume copy created by this task. Copy names have the format prefix_c001 through prefix_c1023. 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. • yes: Include modified snapshot data. • no: Exclude modified snapshot data.
create user Description Creates a user profile. The system supports 12 user profiles.
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 30–9999, where 9999 means do not timeout. The default is 1800 seconds (30 minutes). type standard|advanced|diagnostic Optional.
create vdisk Description Creates a vdisk using the specified RAID level, disks, and spares. All disks used in a vdisk and its spares must be either SAS or SATA; mixing disk types is not supported.
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: Vdisk created. Create the RAID-50 vdisk VD2 having three RAID-5 sub-vdisks, each having three disks: # create vdisk level r50 disks 1.1-3:1.4-6:1.7-9 VD2 Success: Vdisk created.
create volume Description Creates a volume in a vdisk. You can specify a size and name for the volume, and map it to hosts. Syntax create volume vdisk vdisk size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] [mapping ports.LUN] [access read-write|rw|read-only|ro|no-access] [lun LUN] [ports ports] [ovms-uid ID] name Parameters vdisk vdisk Name or serial number of the vdisk to create the volume in. For syntax, see Command syntax.
create volume-copy See volumecopy.
create volume-set Description Creates multiple volumes in the specified vdisk. The volumes have the same base name, size, and default mapping settings (LUN, access, and ports) Syntax create volume-set vdisk vdisk basename base-name count # size size[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB] [baselun base-LUN] [access read-write|rw|read-only|ro|no-access] [ports ports] Parameters vdisk vdisk Name or serial number of the vdisk to create the volumes in. For syntax, see Command syntax.
delete all-master-volumes Description Deletes all master volumes associated with a snap pool. NOTE: You must delete all snapshots that exist for the master volumes before you can delete the master volumes. Syntax delete all-master-volumes snap-pool volume Parameters snap-pool volume Name or serial number of the snap pool whose master volumes should be deleted. For syntax, see Command syntax.
delete all-snapshots Description Deletes all snapshots of a specified volume. All data associated with the snapshots is deleted and associated space in the snap pool is freed for use. Syntax delete all-snapshots volume volume Parameters volume volume Name or serial number of the volume to delete snapshots of. For syntax, see Command syntax. Example Delete all snapshots associated with master volume MV1: # delete all-snapshots volume MV1 Success: All Snapshots Deleted.
delete chap-records Description For iSCSI, deletes a specified CHAP record or all CHAP records. This command is permitted whether or not CHAP is enabled. Syntax To delete the CHAP record for a specific originator: delete chap-records name originator-name To delete all CHAP records: delete chap-records all Parameters name originator-name The originator name; typically the originator's IQN. all Delete all CHAP records in the database.
delete host Description Deletes a manually created host. Does not delete hosts that were discovered or are mapped. Before you can delete a manually created host that is mapped, you must unmap it. Syntax delete host host Parameters host The host ID or nickname. Example Delete the manually created host MyHost: # delete host MyHost Info: Command completed successfully. - Host MyHost was deleted. Success: Command completed successfully.
delete master-volume Description Deletes a master volume. 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 syntax, see Command syntax. Example Delete master volume MV1: # delete master-volume MV1 Success: Command completed successfully. - The master volume was deleted.
delete schedule Description Deletes a task schedule. Syntax delete schedule schedule Parameters schedule The schedule to delete. Example Delete schedule Sched1: # delete schedule Sched1 Success: Command completed successfully. - The schedule was deleted.
delete snap-pool Description Deletes a snap pool. NOTE: You must disassociate all master volumes from the snap pool before you can delete it. Syntax delete snap-pool snap-pool Parameters snap-pool Name or serial number of the snap pool to delete. For syntax, see Command syntax. Example Delete snap pool SP1: # delete snap-pool SP1 Success: Command completed successfully. - The snap-pool was deleted.
delete snapshot Description Deletes a snapshot. All data uniquely associated with the snapshot is deleted and associated space in the snap pool is freed for use. Syntax delete snapshot [cleanup] snapshot Parameters cleanup Optional. When a master volume's last snapshot is deleted, automatically convert the master volume to a standard volume and delete the snap pool. snapshot Name or serial number of the snapshot to delete. For syntax, see Command syntax.
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 syntax, see Command syntax. Example Delete only modified data from snapshot SS1: # delete snapshot-write-data SS1 Success: Command completed successfully. - Snapshot write data was deleted.
delete task Description Deletes a task. If the task is scheduled, you must delete the schedule first. Syntax delete task task Parameters task The task to delete. Example Delete task Task1: # delete task Task1 Success: Command completed successfully. - The task was deleted.
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. Suppresses the confirmation prompt that requires a yes or no response. name The user to delete. Names are case sensitive. Example Delete user jsmith: # delete user jsmith Are you sure you want to delete user jsmith? yes Success: Command completed successfully. - The user was deleted.
delete vdisk Description Deletes specified vdisks. This disassociates all disks that are assigned to the vdisks, and unmaps the vdisks' volumes. CAUTION: Deleting a vdisk will delete all data on that vdisk. NOTE: You cannot delete a vdisk if it contains a snap pool that is associated with a master volume on another vdisk. Syntax delete vdisk [prompt yes|no] vdisks Parameters prompt yes|no Optional.
delete volume Description Deletes specified volumes. CAUTION: Deleting a volume will delete all data in that volume. Syntax delete volume volumes Parameters volumes Names or serial numbers of the standard, master, snap-pool, or snapshot volumes to delete. For syntax, see Command syntax. Example Delete volumes V1 and V2: # delete volume V1,V2 Info: Command completed successfully. (V1) - Volume V1 was deleted. Info: Command completed successfully. (V2) - Volume V2 was deleted.
dequarantine Description A previously fault-tolerant vdisk becomes quarantined when not all of its disks are detected after a restart or power cycle.
exit Description Log off and exit the CLI session.
expand master-volume See expand volume.
expand snap-pool Description Expands a snap pool. Expansion is restricted to the space available on the vdisk containing the snap pool. If insufficient space is available for expansion on the vdisk, first expand the vdisk by using expand vdisk.
expand vdisk Description Adds disks to a vdisk. The expansion capability for each supported RAID level is: RAID level Expansion capability Maximum disks NRAID Cannot expand. 1 0, 3, 5, 6 Can add 1–4 disks at a time. 16 1 Cannot expand. 2 10 Can add 2 or 4 disks at a time. 16 50 Can expand the vdisk one RAID-5 sub-vdisk at a time. The added RAID-5 sub-vdisk must contain the same number of disks as each original sub-vdisk.
expand volume Description Expands a standard or master 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: 1. Delete all of its snapshots by using delete all-snapshots. 2. Convert it to a standard volume by using convert master-to-std. 3. Expand the standard volume by using expand volume. 4.
map volume Description Maps a volume using settings that override the volume's default mapping. When a volume is created, if no mapping settings are specified the volume is not mapped; otherwise, those settings become its default mapping, which specifies the controller host ports and access level that all connected hosts have to the volume, and the LUN presented to all hosts to identify the volume. The default mapping's LUN is known as the volume's default LUN.
See also • show host-maps • show hosts • show volume-maps • show volumes • unmap volume 70
meta Description For API use, shows all property metadata for objects. This includes data not shown in brief mode. The data is static and never changes. Syntax meta basetypes Parameters basetypes A basetype or a list of basetypes separated by commas (with no spaces) to specify the objects to show metadata for. Basetypes are listed in XML API basetypes.
ping Description Tests communication with a remote host. The remote host is specified by IP address. Ping sends ICMP echo response packets and waits for replies. Syntax ping host-address [count] Parameters host-address The remote host's IP address in dotted decimal form. count Optional. The number of packets to send. The default is 4 packets. Use a small count because the command cannot be interrupted. Example Send two packets to the remote computer at 10.134.50.6: # ping 10.134.50.6 2 Info: Pinging 10.134.
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; the controllers do this automatically.
reset host-link Description Resets specified FC or SAS controller host ports (channels). For an FC host port configured to use FC-AL (loop) topology, a loop initialization primitive (LIP) is issued. For a SAS host port, a COMINIT/COMRESET sequence is issued. Syntax reset host-link ports ports Parameters port ports A controller host port ID, a comma-separated list of IDs, a hyphenated range of IDs, or a combination of these. A port ID is a controller ID and port number, and is not case sensitive.
reset snapshot Description Deletes the data in a snapshot and resets it to the current data in the associated master volume. The snapshot's volume characteristics are not changed. The command prompts you to unmount the snapshot from the host operating system before performing the reset; leaving it mounted can cause data corruption. CAUTION: All data represented by the snapshot as it exists prior to issuing this command is lost.
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. The Management Controller is not restarted so it can provide status information to external interfaces.
restore defaults Description For use by or with direction from a service technician. Restores the manufacturer's default configuration to the controllers. When the command informs you that the configuration has been restored, you must restart the controllers for the changes to take effect. After restarting the controllers, hosts might not be able to access volumes until you re-map them.
rollback master-volume Description Rolls back (reverts) the data on a master volume to the data that exists in a specified snapshot. You can choose whether to include modified write data from the snapshot in the rollback. You must unmount the master volume from the host operating system before using this command. The command will prompt you to ensure the master volume is unmounted before proceeding. CAUTION: All data that differs between the master volume and the snapshot is lost.
scrub vdisk Description Analyzes specified vdisks to detect, report, and store information about disk defects. Vdisk-level errors reported include: hard errors, medium 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. For RAID 3, 5, 6, and 50, scrub checks all parity blocks to find data-parity mismatches.
set advanced-settings Description For API use, sets advanced system configuration options.
partner-firmware-upgrade enabled|disabled|on|off Optional. Sets whether component firmware versions are monitored and will be automatically upgraded on the partner controller. partner-notify enabled|disabled|on|off Optional. Sets whether to notify the partner controller that a trigger condition occurred. Enable this option to have the partner also change to write-through mode for better data protection. Disable this option to allow the partner continue using its current caching mode for better performance.
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.
set cache-parameters Description Sets a volume's cache options or the system's cache redundancy mode. Settings you can change include: • Cache write policy • Cache optimization mode • Cache read-ahead size • Cache redundancy mode 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.
Example Set the cache policy and cache optimization mode for volume V1: # set cache-parameters optimization super-sequential read-ahead-size maximum V1 Success: Command completed successfully. - Cache parameters were changed See also • show cache-parameters • show volumes Cache write policy The cache policy setting for each volume determines when cached data is written to the disks.
Cache redundancy mode In the storage system’s default operating mode, Active-Active, data for volumes configured to use write-back cache is automatically mirrored between the two controllers. Cache redundancy has a slight impact on performance but provides fault tolerance. The operating mode applies per storage system, not per volume.
set chap-record Description For iSCSI, changes an originator's CHAP record. 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 the originator's IQN. secret originator-secret The secret that the recipient uses to authenticate the originator. The secret is case sensitive and can include 12–16 bytes.
set cli-parameters Description Sets options that control CLI behavior. If you are accessing the CLI through the network port, settings apply to the current CLI session only. If you are accessing the CLI through the enclosure's CLI port, settings persist across sessions. The base, locale, precision, temperature scale, timeout, and units settings are read from the user's profile, and can be overridden by using this command.
precision # Optional. Sets the number of decimal places (1–10) for display of storage-space sizes. storage-size-base 2|10 Optional. Alias for base. storage-size-precision # Optional. Alias for precision. storage-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.
Set CLI to show output in console mode: # set cli-parameters console Success: Command completed successfully. - The settings were changed successfully.
set controller-date Description Sets the date and time for each Management Controller and then updates the date and time for each Storage Controller. Syntax set controller-date jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec day hh:mm:ss year time-zone [ntp enabled|disabled|on|off] [ntpaddress IP-address] Parameters jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec The month. day The day number (1–31). hh:mm:ss The hour on a 24-hour clock (0–23), the minutes (0–59), and the seconds (0–59).
set debug-log-parameters Description For use by or with direction from a service technician. Sets the types of debug messages to include in the Storage Controller debug log. If multiple types are specified, use spaces to separate them and enclose the list in double quotes. Syntax set debug-log-parameters message-type+|- [...
set disk-parameters Description Selects a global disk Self-Monitoring Analysis and Reporting Technology (SMART) setting. Disks equipped with this technology can alert the controller of impending disk failures. Changes to the SMART setting take effect after a rescan or a controller restart. Syntax set disk-parameters smart enabled|disabled|on|off|detect-only Parameters smart enabled|disabled|on|off|detect-only Enables or disables SMART monitoring for all disks in the storage system.
set email-parameters Description Sets SMTP parameters for event notification. Syntax set email-parameters server server domain domain email-list email-addresses notification-level none|info|warn|crit [sender sender] Parameters server server The IP address of the SMTP mail server to use for the email messages. domain domain The domain name that, with the sender name, forms the “from” address for remote notification.
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 the show enclosures command and in event-log entries related to enclosures.
set expander-fault-isolation Description For use by or with direction from a service technician. By default, the Expander Controller in each I/O module performs fault-isolation analysis of SAS expander PHY statistics. When one or more error counters for a specific PHY exceed the built-in thresholds, the PHY is disabled to maintain storage system operation.
set expander-phy Description 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 phy-type 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.
set host-name Description Changes a host's nickname and optionally its profile. Syntax set host-name id host [profile standard|openvms|hp-ux] new-nickname Parameters id host The ID or nickname of the host to rename. profile standard|openvms|hp-ux Optional. • standard: The host allows LUN 0 to be assigned to a mapping. This is the default. • openvms: The host does not allow LUN 0 to be assigned to a mapping. • hp-ux: The host allows LUN 0 to be assigned to a mapping and uses Flat Space Addressing.
set host-parameters Description Sets controller host port parameters for communication with attached hosts. The new settings take effect without restarting the controllers. There are parameters for FC and iSCSI ports but not for SAS ports.
fibre-loop-id values Optional. For FC, specifies comma-separated loop ID values to request for host ports when controllers arbitrate during a LIP. Use this option if you want ports to have specific addresses, if your system checks addresses in reverse order (lowest address first), or if an application requires that specific IDs be assigned to recognize the controller. If the loop ID is changed for one port, the same ID is used for other ports in the same controller.
set iscsi-parameters Description For iSCSI, changes system-wide iSCSI parameters. Syntax set iscsi-parameters [chap enabled|disabled|on|off] [jumbo-frame enabled|disabled|on|off] [speed auto|1g] [isns enabled|disabled|on|off] [isns-ip iSNS-IP] [isns-alt-ip iSNS-IP] Parameters chap enabled|disabled|on|off Enables or disables use of Challenge Handshake Authentication Protocol. Disabled by default. jumbo-frame enabled|disabled|on|off Enables or disables support for jumbo frames. Disabled by default.
set job-parameters Description Sets parameters for background scrub, partner firmware upgrade, and other jobs. Syntax set job-parameters [background-scrub enabled|disabled|on|off] [partner-firmware-upgrade enabled|disabled|on|off] [utility-priority low|medium|high] Parameters background-scrub enabled|disabled|on|off Optional. Sets whether vdisks are checked for disk defects to ensure system health. The interval between background scrub finishing and starting again is 24 hours.
set led Description Changes the state of the Unit Identification (UID) LED on a specified disk or enclosure. LEDs are described in the user guide. Syntax To set a disk LED: set led disk ID on|off To set an enclosure LED: set led enclosure ID on|off Parameters disk ID The disk to locate. For syntax, see Command syntax. enclosure ID The enclosure to locate. on|off Specifies to set or unset the LED. Example Identify disk 5 in the first enclosure: # set led disk 1.5 on Success: Command completed successfully.
set network-parameters Description Sets IP values for controller module network ports. IP values can be set dynamically using Dynamic Host Configuration Protocol (DHCP) for both controllers, or manually (statically) for each controller. If DHCP is enabled, manually setting an IP value for either controller disables DHCP for both controllers.
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. A new password for this user. A password is case sensitive, cannot include a comma, double quote, or backslash, and can have a maximum of 19 bytes. user Optional. The user name to set the password for.
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. Example Set the prompt to CLI> followed by a space, and start entering another command: # set prompt "CLI> " Success: Command completed successfully CLI> set ...
set protocols Description Enables or disables management services and protocols. Syntax set protocols [capi enabled|disabled|on|off] [debug enabled|disabled|on|off] [ftp enabled|disabled|on|off] [http enabled|disabled|on|off] [https enabled|disabled|on|off] [service enabled|disabled|on|off] [ses enabled|disabled|on|off] [smis enabled|disabled|on|off] [snmp enabled|disabled|on|off] [ssh enabled|disabled|on|off] [telnet enabled|disabled|on|off] Parameters capi enabled|disabled|on|off Optional.
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 deleteoldestsnapshot and default critical policy is deletesnapshots.
set snap-pool-threshold Description Sets the percentages of snap-pool space used that trigger the warning and error threshold policies. Three threshold levels are defined: • Warning indicates that snap-pool space is moderately full. When exceeded, an event is generated to warn the administrator. • Error indicates that the snap pool is getting full and unless corrective action is taken, snapshot data loss is probable.
set snmp-parameters Description Sets SNMP parameters for event notification. To enable or disable SNMP requests to the MIB use the set protocols command. Syntax set snmp-parameters [enable crit|warn|info|none] [add-trap-host address] [del-trap-host address] [trap-host-list trap-host-list] [read-community string] [write-community string] Parameters enable crit|warn|info|none Optional. Sets the level of trap notification: • crit: Sends critical events only. • warn: Sends all critical events and warnings.
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 dedicated spare is assigned to a redundant vdisk with the same disk type. A vdisk can have four spares. Each must have enough capacity to replace the smallest disk in that vdisk. CAUTION: disks.
set system Description Sets the system’s name, contact person, location, and description. Each value can include a maximum of 79 bytes, using characters except double quote or backslash. A value that contains a space must be enclosed in double quotes. Syntax set system [name value] [contact value] [location value] [info value] Parameters name value A name for the system. contact value A contact person for the system. location value The location of the system. info value Other information about the system.
set user Description Changes user preferences for the session or permanently. You cannot change the access level of user manage. To change a user's password, use set password.
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 use the Celsius scale or Fahrenheit scale for temperature values. timeout # Optional. Sets the timeout value in seconds for the login session. Valid values are 30–9999, where 9999 means do not timeout. The default is 1800 seconds (30 minutes).
set vdisk Description Changes parameters for a specified vdisk. Syntax set vdisk [name new-name] [owner a|b] vdisk Parameters name new-name Optional. A new name for the vdisk. For syntax, see Command syntax. owner a|b Optional. The new owner: controller A or B. CAUTION: Before changing the owning controller for a vdisk, you must stop host I/O to the vdisk’s volumes. Volume mappings are not affected. vdisk Name or serial number of the vdisk to change. For syntax, see Command syntax.
set volume Description Changes a volume's name and OpenVMS UID. Syntax set volume name new-name [ovms-uid ID] volume Parameters name new-name A new name for the volume. For syntax, see Command syntax. ovms-uid ID For a volume to be accessed by an OpenVMS host, assign a volume ID in the range 1–32767 to identify the volume to the host. volume Name or serial number of the volume to change. For syntax, see Command syntax.
show advanced-settings Description For API use, shows the settings for advanced system-configuration options. Syntax show advanced-settings Output Background Scrub Shows whether disks are automatically checked for disk defects to ensure system health. Partner Firmware Upgrade Shows whether component firmware versions are monitored and will be automatically upgraded on the partner controller.
Temperature Exceeded Shows whether the system forces a controller shutdown when a temperature is detected that exceeds system threshold limits. Partner Notify Shows whether the partner controller is notified when a trigger condition occurs. Auto Write Back Shows whether the cache mode automatically changes to write-back after the trigger condition is cleared.
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.
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 syntax, see Command syntax. If this parameter is not specified, only system-wide settings are shown. Output System/controller cache parameters: Operation Mode The operation mode, also called the redundancy mode.
Example Show the cache parameters for the system and for volume V1: # show cache-parameters V1 System Cache Parameters ----------------------Operation Mode: Active-Active ULP Controller A Cache Parameters ----------------------------Write Back Status: Enabled CompactFlash Status: Installed Cache Flush: Enabled Controller B Cache Parameters ----------------------------Write Back Status: Enabled CompactFlash Status: Installed Cache Flush: Enabled Volume Cache Parameters ----------------------Serial Number: 00
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 the originator's IQN. If this parameter is omitted, the command displays CHAP records for all originators.
show cli-parameters Description Shows the current CLI session preferences. Syntax show cli-parameters Output Timeout Timeout value in seconds for the login session. Output Format • console: Output is shown in human-readable format. • api: Output is shown in XML format. Base • 2: Storage sizes are entered and shown in base 2. • 10: Storage sizes are entered and shown in base 10. Pager • enabled: Output halts after each full screen until a key is pressed or all output is shown.
Example Show current CLI settings: # show cli-parameters CLI Parameters -------------Timeout: 1800 Output Format: console Brief Mode: disabled Base: 10 Pager: enabled Disk Mode: enclosure-slot Locale: English Precision: 1 Units: Auto Temperature Scale: Celsius See also • set cli-parameters HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 123
show configuration Description Shows system configuration information.
show controller-date Description Shows the system's current date and time.
show controllers Description Shows information about each controller in the storage system.
Example Show information about a system with a single FC controller: # show controllers Controllers ----------Controller ID: A Serial Number: SN Hardware Version: 25 CPLD Version: 8 MAC Address: 00:C0:FF:27:50:24 WWNN: 500C0FF000013000 IP Address: 10.134.11.100 IP Subnet Mask: 255.255.0.0 IP Gateway: 10.134.0.
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 Example Show debug log parameters: # show debug-log-parameters Host: on Disk: on mem: off ...
show disk-parameters Description Shows disk settings. Syntax show disk-parameters Output SMART Shows whether SMART is enabled or disabled for all disks, or is set to detect-only, which specifies that each new disk inserted in the system retains its current SMART setting. Drive Write Back Cache Shows whether write-back cache for each disk in or added to the system will be enabled or disabled or a rescan or controller restart. Don't Modify means that each disk's current setting will not be modified.
show disks Description Shows information about all disks in the storage system. If no parameter is specified, the command shows information for all disks. Syntax show disks [disks|free|all|encl] [vdisk vdisk] Parameters disks|free|all|encl Optional. Specifies the disks to report information about: • disks: IDs of the disks to show information about. For syntax, see Command syntax. • free: Shows information about all disks that are available. • all: Shows information about all installed disks.
SP Shows which controller a single-ported disk is connected to Status Disk status: Up, Warning, Error, Missing, Unknown, or Disconnected With the encl option: Status Disk status: Up, Warning, Error, Missing, Unknown, or Disconnected Encl Enclosure number where the disk is located Slot Slot number in the enclosure where the disk is located Vendor Disk vendor Model Disk model number Serial Number Disk serial number Size Disk size Example Show information for all disks: # show disks Location Serial Number Vend
show email-parameters Description Shows SMTP parameters for event notification. Syntax show email-parameters Example Show settings for email notification of events: # show email-parameters Email Parameters (SMTP) ----------------------Email Notification: enabled Email Notify Filter: warn Email Address 1: sysadmin@mydomain.com Email Address 2: Email Address 3: Email Address 4: Email Server: 10.1.1.10 Email Domain: mydomain.
show enclosure-status Description 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.
Add'l Data Additional data such as fan speed (RPM), temperature (Celsius), voltage, or slot address Example Show enclosure status for a system with a controller enclosure and an MSA70 drive enclosure: # show enclosure-status Chassis Vendor Product ID CPLD EMP A BUS:ID Rev EMP B BUS:ID Rev WWPN Status Health -------------------------------------------------------------------------3CL816C013 vendor product 8 0:31 1022 1:31 1022 500C0FF00000133C OK OK -----------------------------------------------------------
show enclosures Description Full detail available in API output only. Shows information about the enclosures in the storage system.
show events Description Shows events for an enclosure, including events from each Management Controller and each Storage Controller. 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.
Example Show the last two events: # show events last 2 Show the last three warning and critical events: # show events last 3 error Show all events from 11:59:00 p.m. on Apr 30, 2008 through 11:59:00 a.m.
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. Syntax show expander-status Output Encl Enclosure that contains the SAS expander. Ctlr I/O module that contains the SAS expander. Phy Identifies a PHY's logical location within a group based on the PHY type.
Reason • 0x8001: PHY disabled because of error-count interrupts. • 0x8003: PHY disabled by PHY control page. • 0x8004: PHY is enabled but not ready. Appears for SC-1 PHYs when the partner I/O module is not installed. Appears for Drive, SC-1, or Ingress PHYs when a connection problem exists such as a broken connector. • 0x8006: PHY disabled because drive slot is empty.
show frus Description Shows information for field-replaceable units (FRUs) in all enclosures. Some information reported is for use by service technicians.
show host-maps Description Shows mapping information for volumes that are mapped to all hosts or to a specified host. Syntax show host-maps [host] Parameters host Optional. Specifies the host's nickname or ID. If this parameter is omitted, mapping information for all hosts is shown Output ID • For FC and SAS: Host WWPN. • For iSCSI: iSCSI host initiator's node name (typically the IQN). Name Host port nickname. Profile • Standard: The host allows LUN 0 to be assigned to a mapping.
Example Show volume mappings for all hosts: # show host-maps Host View [ID (AABBCCDDEEFF0011) Name (Host1) Profile (OpenVMS) ] Mapping: Name Serial Number LUN Access Ports ----------------------------------------------------------------vd2_v2 00c0ff28201500485b87a94803000000 1 read-write A2,B1 vd2_v0 00c0ff28201500485b87a94801000000 10 read-write A1 vd2_v1 00c0ff28201500485b87a94802000000 11 read-write A1 Host View [ID (1A2B3C4D5E6F8900) Name (Host2) Profile (HP-UX) ] Mapping: Name Serial Number LUN Access
show host-parameters Description Shows information about host ports on both controllers. Syntax show host-parameters Output Port Host port number Media • FC(L): Fibre Channel-Arbitrated Loop • FC(P): Fibre Channel Point-to-Point • FC(-): Fibre Channel disconnected • SAS: Serial Attached SCSI • iSCSI: Internet SCSI Target ID Enclosure WWN or serial number Status • Up: Port is cabled and has an I/O link. • Disconnected: Either no I/O link is detected or the port is not cabled. Speed (A) FC and SAS only.
Example Show host parameters for a controller with two FC ports: # show host-parameters Port Media Target ID Status Speed(A) Speed(C) Topo(C) PID -----------------------------------------------------------------------A1 FC(L) 207000C0FF000015 OK 2Gb Auto Loop 0 A2 FC(L) 217000C0FF000015 OK 2Gb Auto Loop 1 ------------------------------------------------------------------------ Show host parameters for a controller with four SAS ports: # show host-parameters Port Media Target ID Status Speed(A) Speed(C) Top
show hosts Description Shows hosts that volumes can be mapped to. Host entries are automatically created for hosts that have sent an inquiry command or a report luns command to the system. Hosts typically do this when they boot up or scan for devices. When the command is received, the system saves the host port information; however, the information is retained after a restart only if you have set a nickname for the host.
show iscsi-parameters Description For iSCSI, shows system-wide iSCSI parameters.
show job-parameters Description Shows parameters for background scrub, partner firmware upgrade, and other jobs. Syntax show job-parameters Output Background Scrub Shows whether disks are automatically checked for disk defects to ensure system health. Partner Firmware Upgrade Shows whether component firmware versions are monitored and will be automatically upgraded on the partner controller.
show license Description Shows the status of licensed features in the storage system.
show master-volumes Description Shows information about all master volumes, or ones associated with a specified controller or snap pool. Syntax show master-volumes [controller a|b] [snap-pool volume] Parameters controller a|b Optional. Only includes master volumes owned by the specified controller. snap-pool volume Optional. Only includes master volumes associated with the specified snap pool name or serial number. For syntax, see Command syntax.
See also • convert master-to-std • create master-volume • delete all-master-volumes • delete master-volume • expand volume • rollback master-volume 150
show network-parameters Description Shows the network settings for each RAID controller.
show ntp-status Description Shows the status of the use of Network Time Protocol (NTP) in the system.
show ports Description Shows information about host ports on both controllers. Syntax show ports Output Port Controller ID and port number Media • FC(P): Fibre Channel Point-to-Point • FC(L): Fibre Channel-Arbitrated Loop • FC(-): Not applicable, as when the port is disconnected • SAS: Serial Attached SCSI • iSCSI: Internet SCSI Target ID Enclosure WWN or serial number Status Whether the port is operational, has a problem, or is disconnected Speed (A) Actual host-port link speed, or blank if not applicable.
Show port information for a system with four SAS ports: # show ports Port Media Target ID Status Speed(A) Speed(C) Topo(C) Width --------------------------------------------------------------------------A1 SAS 500C0FFD41011000 Disconnected Direct 4 A2 SAS 500C0FFD41011100 Disconnected Direct 4 A3 SAS 500C0FFD41011200 Disconnected Direct 4 A4 SAS 500C0FFD41011300 Disconnected Direct 4 --------------------------------------------------------------------------- See also • set host-parameters 154
show protocols Description Shows which management services and protocols are enabled or disabled.
show redundancy-mode Description Shows the redundancy status of the system. Syntax show redundancy-mode Output Redundancy Mode The redundancy mode, also called the operation mode. • Active-Active ULP: Both controllers are active using ULP (Unified LUN Provisioning). • Single-Controller: The enclosure contains a single controller using ULP. Redundancy Status • Redundant: Both controllers are operational.
show refresh-counters Description For API use, shows when the data represented by the base type was last updated.
show sas-link-health Description Shows the condition of SAS port connections. Syntax show sas-link-health Output Encl Enclosure ID Ctlr ID of the controller module or expansion module Name • Out Port: Egress (expansion) port on controller module or an expansion module. Can be connected to an ingress port on an expansion module. • In Port: Ingress port on an expansion module. Can be connected to an egress (expansion) port on a controller module or an expansion module.
show schedule-details Description Shows details for a specified task schedule.
show schedules Description Shows details for all task schedules.
show sensor-status Description Shows temperatures and voltages of controller modules and power supplies. These values are reported by environmental sensors in each controller module (Ctlr, IOM) and power supply (PSU). Syntax show sensor-status Output Sensor Name Sensor name and location Value The value of the sensor Status • Absent: Component is not present • Fault: One or more subcomponents has a fault • OK: All subcomponents are operating normally.
Voltage 12V Loc:right-PSU 2 12.02 OK Voltage 5V Loc:right-PSU 2 5.16 OK Voltage 3.3V Loc:right-PSU 2 3.49 OK Current 12V Loc:upper-IOM 3.89 OK Current 12V Loc:lower-IOM 4.95 OK Current 12V Loc:left-PSU 1 6.15 OK Current 5V Loc:left-PSU 1 6.67 OK Current 12V Loc:right-PSU 2 6.15 OK Current 5V Loc:right-PSU 2 7.
show shutdown-status Description Shows whether each Storage Controller is active or shut down.
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). If this parameter is omitted, all snap pools are shown.
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 To show snapshots by controller: show snapshots [controller a|b|both] To show snapshots by master volume: show snapshots [master-volume volume] To show snapshots by snap pool: show snapshots [snap-pool volume] Parameters controller a|b|both Optional.
UniqueData Amount of preserved and write data that is unique to the snapshot SharedData Amount of preserved and write data that is shared between this snapshot and other snapshots Example Show information about snapshots associated with snap pool SP2: # show snapshots snap-pool SP2 Vdisk Serial Number Name Creation Date/Time Status Status-Reason Master Volume Name Snap-pool Name Snap Data UniqueData SharedData ------------------------------------------------------------------------VD1 SN SS1 2008-03-19 13:3
show snmp-parameters Description Shows SNMP settings for event notification. Syntax show snmp-parameters Output SNMP • enabled: SNMP notification is enabled • disabled: SNMP notification is disabled To enable or disable requests to the SNMP agent use the set protocols command.
show system Description Shows information about the system. Syntax show system Example Show system information, including installed languages (supported locales): # show system System Information -----------------System Name: Storage-1 System Contact: J.
show system-parameters Description Shows the current settings for the storage system. Syntax show system-parameters Output ULP Shows that Unified LUN Provisioning is enabled Host Profiles Enabled Shows whether host profiles are enabled, which determines whether LUN 0 can be assigned to volume mappings.
show task-details Description Shows details for all tasks or a specified task. Syntax show task-details [task] Parameters task Optional. Specifies a task name.
For a ResetSnapshot task: Task Name Task name Task Type ResetSnapshot Task Status • Ready: Task is ready to run • Active: Task is currently running Task State Current state of the task: Init, Snap Verified Snapshot Name Name of the snapshot to reset Snapshot Serial Serial number of the snapshot to reset Error Message Any error message associated with this task For a VolumeCopy task: Task Name Task name Task Type VolumeCopy Task Status • Ready: Task is ready to run • Active: Task is currently running Task St
Example Show details for task Snap: # show task-details Snap Tasks ----Task Name: Snap Task Type: TakeSnapshot Task Status: Ready Task State: Init Source Volume Source Volume Serial Prefix Count Last Created ---------------------------------------------------------------VD1 SN VD1 1 VD1_S0001 Snapshot Name Snapshot Serial -----------------------------VD1_S0001 SN See also • create schedule • create task • delete task • show schedules • show tasks 172
show tasks Description Shows details for all tasks. Syntax show tasks Example Show details for the two existing tasks: # show tasks Tasks ----Task Name: Snap Task Type: TakeSnapshot Task Status: Ready Task State: Init Source Volume Source Volume Serial Prefix Count Last Created ---------------------------------------------------------------VD1 SN VD1 1 VD1_S0001 Snapshot Name Snapshot Serial -----------------------------VD1_S0001 SN Task Name: v1_v002_task001 ...
show users Description Shows configured user profiles. Syntax show users [user] Input user Optional. User name to show settings for. Output Username User name Access Level • Monitor: View-only access to selected user interfaces • Manage: Modify access to selected user interfaces User Type Applies to SMU only.
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 syntax, see Command syntax.
Serial Number Vdisk serial number Example Show information about vdisk VD1 only: # show vdisks VD1 Name Size Free Own Pref RAID Disks Spr Chk Status Jobs Serial Number ---------------------------------------------------------------------VD1 587.1GB 116.
show volume-maps Description Shows mapping information for a specified volume or for all volumes. Syntax show volume-maps [volume] Parameters volume Optional. Name or serial number of the volume to show mappings for. For syntax, see Command syntax. If this parameter is omitted, information for all volumes is shown.
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] Parameters controller a|b Optional. Shows volume copy operations for volumes owned by controller A or B only. If this parameter is omitted, all volume copy operations are shown.
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] Parameters vdisk vdisks Optional. Names or serial numbers of the vdisks containing the volumes to show. For syntax, see Command syntax. class standard|ptsnap Optional. Specifies the class of volumes to show. type snap-pool|mastervolume|snapshot|standard Optional. Specifies the type of volumes to show.
Example Show volume information for standard volumes only: # show volumes type standard Vdisk Name Size Serial Number WR Policy Cache Opt Read Ahead Size Type Class Volume Description -------------------------------------------------------------------------VD1 V0 20.
shutdown Description Shuts down the Storage Controller in a controller module. This ensures that a proper failover sequence is used, which includes stopping all I/O operations and writing any data in write cache to disk. If the Storage Controller in each controller module is shut down, hosts cannot access the system's data. Perform a shut down before removing a controller module or powering down the system.
stty Description Sets and shows terminal information. Syntax stty info | hardwrap | rows # | columns # Parameters info Shows the terminal's settings. hardwrap Enables or disables the hard wrapping of output. Terminals usually wrap at the screen width without truncating output, but turning on hard wrapping ensures this. rows # Sets the number of rows that a terminal can display. The terminal usually sets this value; this is an override. The info parameter shows this as screen height.
test Description Sends a message to test event notification. After issuing this command, verify that test message reached the configured destinations. Syntax test email|snmp|notification Parameters email Sends a test message to configured email addresses. snmp Sends a test message to configured SNMP trap hosts. notification Sends a test message to configured email addresses and SNMP trap hosts. Example Test email and SNMP notification of events: # test notification Success: Command completed successfully.
Example Enable the trust command and then trust vdisk VD1: # trust enable Trust Virtual-disk Enabled. # trust vdisk VD1 Are you sure? yes Virtual-disk VD1 has been trusted. See also • show vdisks unmap volume Description Deletes an explicit mapping whose settings override a volume's default mapping. When the explicit mapping is deleted, host access to the volume is controlled by the volume's default mapping (described in help for create volume).
verify vdisk Description Verifies whether vdisk redundancy data is consistent with its user data. For RAID 3, 5, 6, and 50, verify checks all parity blocks to find data-parity mismatches. For RAID 1 and 10, verify compares the primary and secondary disks to find data inconsistencies. Verification can last over an hour, depending on vdisk size, utility priority, and amount of I/O activity.
volumecopy Description Copies a snapshot or a master volume to a new standard volume. The command creates the destination volume you specify, which must be in a vdisk owned by the same controller as the source volume. While the copy operation is in progress, the destination volume's type is shown as standard*; when complete, it changes to standard.
See also • abort volumecopy • create task • show vdisks • show volumecopy-status • show volumes HP StorageWorks 2000 G2 Modular Smart Array CLI Reference Guide 187
Glossary CHAP Challenge-Handshake Authentication Protocol. chunk size The amount of contiguous data that is written to a vdisk member before moving to the next member of the vdisk. dedicated spare A disk that is reserved for use by a specific vdisk to replace a failed disk. default mapping Host-access settings that are configured when a volume is created. dual-port disk A dual-port disk is connected to both controllers so its data path is fault tolerant.
snap pool A volume that stores data that is specific to snapshots of an associated master volume, including copy-on-write data and data written explicitly to the snapshots. A snap pool cannot be mapped. snapshot A “virtual” volume that preserves the state of a master volume’s data as it existed when the snapshot was created. Data associated with a snapshot is recorded in both the master volume and in its associated snap pool. A snapshot can be mapped and written to. SSD Solid-state drive.
Index A access level set user 43, 112 show user 174 array See system audience 9 B base 10 21 base 2 21 base for storage-space sizes set 43 set CLI 87 set user 112 show current 122 C cache clear unwritable data 29 enable/disable auto-write-back 80, 82 set advanced settings 80 set auto-write-through triggers and behaviors 82 set host access to 80 show auto-write-back setting 117 show auto-write-through trigger and behavior settings 118 show flush setting 119 show setting for host access to 116 show write-ba
controller notify partner when auto-write-through is triggered 81, 82 show failover status and reason 126 show ID being accessed (local) 169 show partner notification setting 117 show shutdown status 163 shut down 181 controller failure trigger enable/disable 80, 82 show setting 116 controllers show information 126 show network settings 151 conventions document 9 D date and time set 90 show settings 125 debug interface enable/disable 106 debug log set parameters 91 show parameters 128 dedicated spares set
G J global spares set 110 jumbo frames enable/disable 100 show setting 146 H hardware show versions 185 help obtaining 10 viewing 20 host delete 53 test communication with 72 host access to cache set 80 show setting 116 host channel See host ports host link See host ports host ports reset 74 set gateway address for iSCSI 98 set IP address for iSCSI 98 set loop IDs for FC 99 set netmask address for iSCSI 98 show 143, 153 show health for SAS 158 show number of 169 hosts create 36 set FC connection mode 98
N R network ports set gateway IP address 103 set IP address 103 set IP subnet mask 103 Network Time Protocol See NTP NTP show settings 152 redundancy mode show 156 refresh counters, show 157 related documentation 9 rescan disk channels 73 restore system defaults 77 revert volume data See roll back volume data O S out-of-band interfaces enable/disable 106 output mode API 11 console 11, 13 set CLI 87 show CLI 122 XML 13 SAS expander See expander SAS host port links show health 158 schedules create 38 d
set warning threshold 108 show 164 snapshot delete modified (write) data 58 snapshots create 40 delete 57 delete all 51 reset to current data in master volume 75 show 165 SNMP enable/disable interface 106 set parameters 109 show parameters 167 spares set dedicated and global 110 See also dedicated spare, dynamic spare, and global spare speed set FC host port 98 SSH interface enable/disable 106 Storage Controllers restart 76 Subscriber’s choice, HP 10 super-capacitor failure trigger enable/disable 81, 82 sho
set name 114 set owning controller 114 show 175 show maximum number of 169 show maximum number per controller 169 start manual scrub 79 verification abort vdisk 27 versions show hardware and firmware 185 virtual disk name 19 serial number 19 voltages show component 161 volume abort copy 28 convert standard to master 34 create copy 186 name 19 serial number 19 show copy status 178 syntax 19 unmap 184 volume copy show status 178 volumes change explicit mappings 69 clear unwritable cache data 29 convert master