HP StorageWorks 2000 Family Modular Smart Array CLI reference guide Part number: 481600-002 Second edition: May 2008
Legal and notice information © Copyright 2008 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Contents About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Completion, Editing, and History Viewing Command Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Size of Devices and Logical Units Event Log 2. CLI and Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Virtual Disks and Disk Drives Volumes and Mapping . . . . . . . . . . . . . . . . .
create host-wwn-name create iscsi-host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 create master-volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 create schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 create snap-pool . .
expand vdisk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 expand volume map volume ping rescan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 .
set led . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 set network-parameters set password set prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
show host-maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 show host-parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 show host-port-interconnects show host-wwn-names show iscsi-hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
show volume-maps show volumes shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 stty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 trust . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
show frus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 show protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 show redundancy-mode trust . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
About This Guide Intended Audience This guide is intended for use by system administrators who are experienced with the following: ■ Direct attach storage (DAS) or storage area network (SAN) management ■ Network administration ■ Storage system configuration Prerequisites Prerequisites for installing and configuring this product include familiarity with: ■ Servers and computer networks ■ Fibre Channel, iSCSI, Serial Attached SCSI (SAS), and Ethernet protocols 11
Document Conventions 12 Typeface Meaning Examples AaBbCc123 Book title, new term, or emphasized word See the user guide A virtual disk (vdisk) can ... You must ... AaBbCc123 Directory or file name, value, command, or on-screen output The default file name is store.
HP Technical Support Telephone numbers for worldwide technical support are listed on the HP support website: http://www.hp.com/support/. Collect the following information before calling: Technical support registration number (if applicable) ■ Product serial numbers ■ Product model names and numbers ■ Applicable error messages ■ Operating system type and revision level ■ Detailed, specific questions ■ For continuous quality improvement, calls may be recorded or monitored.
Subscription Service HP strongly recommends that customers sign up online using the Subscriber's choice website: http://www.hp.com/go/e-updates. Subscribing to this service provides you with e-mail updates on the latest product enhancements, newest versions of drivers, and firmware documentation updates as well as instant access to numerous other product resources. HP Websites For other product information, see the following HP websites: ■ ■ ■ ■ ■ http://www.hp.com http://www.hp.com/go/storage http://www.
CH A P T E R 1 Using the CLI This chapter introduces the HP StorageWorks MSA2000 Family command-line interface (CLI) and includes the following topics: ■ “Accessing the CLI” on page 15 ■ “Operation Modes” on page 16 ■ “Command Syntax” on page 25 ■ “Command Completion, Editing, and History” on page 28 ■ “Viewing Command Help” on page 29 ■ “Size of Devices and Logical Units” on page 29 ■ “Event Log” on page 30 Accessing the CLI The CLI software embedded in controller modules enables you to configure, monito
Operation Modes 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. This singleoperation mode is known as interactive mode. 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 following example shows the Perl Expect script showfree.exp that starts a telnet session, logs into the CLI, executes a command to show free disks, and exits the CLI: #!/usr/bin/expect set login [lindex $argv 1] set password [lindex $argv 2] set host [lindex $argv 3] set command [lindex $argv 4] spawn telnet $host expect "Login:" send "$login\r" expect "Password:" send "$password\r" send "$command\r" send "exit" expect eof The following shows a possible result of executing this script: $:./showfree.
The example below and continuing on the next page shows how to construct a script using a Perl library for telnet communication. use Net::Telnet; $mVer = "v.072006"; $mLine = "=========================================================="; $mStr = "Management Controller System Cloning Utility"; $nLine = "\n"; $cliDumpFile = "get_config_dump.
The example 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. Once the user has been logged in, other commands can be sent to the CLI. The command below provides better scripting support. The first argument sets the output format to XML, which allows easier parsing.
DTD The following is Revision 1 of the DTD. Elements and attributes are described in the table on the following page.
Elements and attributes of the DTD are described in the following table. Element Description and Attributes RESPONSE The RESPONSE is the top level XML object. The request attributes contain the details of the request that was sent. The RESPONSE is a container for objects that are returned as part of the request. All commands have a status object as part of the RESPONSE which provides a message and return code. A return code of 0 indicates that the command was successful.
Element Description and Attributes ASC The association element provides a simple association description between two objects in the response. • A • B Example The following example shows the output of the show schedule-details command with the output first set to console and second set to api.
# set cli-parameters api #show schedule-details Sched1 PAGE 24
00c0ff0a43010048f9ca2d4601000000 ss 3 none
Command Syntax This section describes syntax rules for CLI commands. ■ “Keywords and Parameters” on page 25 ■ “Disk Drive Syntax” on page 25 ■ “Virtual Disk Syntax” on page 26 ■ “Volume Syntax” on page 26 ■ “Volume Mapping Syntax” on page 27 ■ “Host Nickname Syntax” on page 27 Keywords and Parameters Command keywords must be entered in lowercase. Parameter values can be entered in uppercase and lowercase.
Virtual Disk Syntax You can specify virtual disks by using: ■ Virtual disk name. A user-defined, case-sensitive name that can include a maximum of 17 characters, but not comma, quotation mark ("), or backslash. A name that includes a space must be enclosed in quotation marks. To use a name that the CLI could interpret as an optional parameter, you must specify that parameter before the name parameter. ■ ■ Virtual disk serial number.
Host Nickname Syntax You can specify a nickname for a host-side port. A nickname is a case-sensitive name that can include a maximum of 15 characters, but not comma, quotation mark ("), or backslash. A name that includes a space must be enclosed in quotation marks. For example, MyHost. Volume Mapping Syntax You can specify the controller host ports and LUN to use in a volume mapping by using the syntax ports.LUN.
Command Completion, Editing, and History The CLI supports command completion, command editing, and command history. When using command completion, if you enter too few letters to uniquely identify a keyword, the CLI lists keywords that match the entered string and redisplays the string so you can complete it. The history contains all commands entered in the active CLI session. You can recall a command from the history, edit it, and run it.
Viewing Command Help To view brief descriptions of all commands that are available to the user level you logged in as, type: # help To view help for a specific command, type either: # help command # command ? To view information about the syntax to use for specifying disk drives, virtual disks, volumes, and volume mapping, type: # help syntax Size of Devices and Logical Units The size of disk drives and logical units such as virtual disks and volumes are presented in base 2 (binary) format, not base 10 (
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 enclosure. Each event has one of the following levels, in decreasing severity: ■ Critical. Events that might affect data integrity or system stability. ■ Warning. Events that do not affect data integrity. ■ Informational. Events that show the change of state or configuration changes.
CH A P T E R 2 Command Categories Commands in this guide are organized alphabetically to make it easy to find a command by name. This chapter helps you find a command within a logical grouping, based on the command’s function. A command might be listed in more than one category. For more information about each command, see Chapter 3.
Virtual Disks and Disk Drives ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ abort create abort scrub abort verify clear disk-metadata create vdisk delete global-spare delete vdisk delete vdisk-spare expand vdisk rescan scrub vdisk set expander-fault-isolation set led set vdisk set vdisk-spare show disks show vdisks trust verify vdisk Volumes and Mapping ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ 32 create host-wwn-name create iscsi-host create volume delete host-wwn-name delete iscsi-host delete volume expand volume m
■ ■ show volume-maps unmap volume Snapshots ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ convert master-to-std convert std-to-master create master-volume create snap-pool create snapshots delete all-master-volumes delete all-snapshots delete master-volume delete snap-pool delete snapshot delete snapshot-write-data expand snap-pool reset snapshot rollback master-volume set snap-pool-policy set snap-pool-threshold show master-volumes show snap-pools show snapshots Volume Copy (Clone) ■ ■ ■ abort volumecopy show
Event Notification ■ ■ ■ ■ clear event set snmp-parameters show events show snmp-parameters Configuration and Utilities ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ 34 alias clear cache create chap-record delete chap-records ping reset host-channel-link restart set auto-write-through-trigger (alias: set awt) set chap-record set controller-date set drive-parameters set expander-fault-isolation set expander-phy set host-parameters set host-port-interconnects set iscsi-parameters set j
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ show iscsi-parameters show job-parameters show license show network-parameters show ntp-status show protocols show redundancy-mode show shutdown-status show sensor-status show system shutdown stty versions (alias: show versions) Service Utilities ■ ■ ■ ■ ■ clear expander-status restore defaults set debug-log-parameters show debug-log show debug-log-parameters Chapter 2 Command Categories 35
HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008
CH A P T E R 3 Command Descriptions This chapter describes the commands in alphabetical order. Each command topic includes one or more of the following sections: ■ Description. The command’s purpose and notes about its usage. ■ Input. The command’s syntax and descriptions of its parameters. ■ Output. A description of information that is displayed by the command. ■ Examples. One or more examples of the command’s usage, if the command has parameters or detailed output. ■ Error Messages.
abort create Description Stops the create vdisk operation for a virtual disk being initialized online or offline. This command does not revert the system to the state it was in before starting to create the virtual disk; instead, the virtual disk is left in an offline state (status OFFL). Input abort create vdisk vdisk Parameter Description vdisk Specifies the virtual disk by name or serial number. For the syntax to use, see “Virtual Disk Syntax” on page 26. Example Abort creating virtual disk VD1.
abort scrub Description Aborts the scrub vdisk operation for specified virtual disks. Input abort scrub vdisk vdisks Parameter Description vdisk vdisks Specifies the virtual disks by name or serial number. For the syntax to use, see “Virtual Disk Syntax” on page 26. Example Abort scrubbing virtual disk VD1.
abort verify Description Aborts the verify vdisk operation for specified virtual disks. Input abort verify vdisk vdisks Parameter Description vdisk vdisks Specifies the virtual disks by name or serial number. For the syntax to use, see “Virtual Disk Syntax” on page 26. Example Abort verifying virtual disk VD1.
abort volumecopy Description Aborts copying a volume. When the abort is complete, the destination volume is deleted. Input abort volumecopy volume Parameter Description volume Specifies the name or serial number of either the source or the destination volume. For the syntax to use, see “Virtual Disk Syntax” on page 26. Example Abort creating destination volume Copy. # abort volumecopy Copy Success: Volume Copy Aborted.
alias Description Shows, creates, or deletes aliases for the current CLI session. An alias is usually a short string that is substituted for a longer string. If both parameters are omitted, existing aliases are shown. Input alias [alias] [command-string] Parameter Description alias Optional. Specifies the string to substitute for the command string. An alias that includes a space must be enclosed in quotation marks (").
Show existing aliases. # alias se3 show events last 3 sd show disks Success: Command completed successfully Run alias se3. # se3 WED OCT 10 16:53:52 2007 [23] #B73748: product SN#00C0FF627005 Controller B INFORMATIONAL: Vdisk creation started. Vdisk: VD3, SN: 00c0ff6 2701900009f030d4700000000, 2 drive RAID1, Online Init WED OCT 10 16:42:17 2007 [207] #B73747: product SN#00C0FF627005 Controller B INFORMATIONAL: Vdisk scrub complete, no errors found.
clear cache Description Clears unwritable data in both controllers’ cache for a specified volume, or unneeded orphaned data for volumes that are no longer online or that no longer exist. Input clear cache [volume volume] Parameter Description volume volume Optional. Specifies the volume by its name or serial number. For the syntax to use, see “Volume Syntax” on page 26.
clear disk-metadata Description Clears metadata from “leftover” disk drives. Each disk drive contains metadata that the system uses to identify the drive’s owning virtual disk, if any. If the system cannot locate the virtual disk, as when the drive has been moved to a different system, the owning virtual disk is shown as Leftover. You must clear the metadata before you can use the drive in a different virtual disk or as a spare.
clear event Description Clears the event log for controller A, controller B, or both. Input clear event [a|b|both] Parameter Description a|b|both Optional. Specifies whether to clear the event log for controller A, B, or both. If this parameter is omitted, both event logs are cleared. Example Clear the event log for controller A.
clear expander-status Description Note – This command should be used only by service technicians, or with the advice of 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. Input clear expander-status [enclosure id] Parameter Description enclosure id Optional.
convert master-to-std Description Converts a specified master volume into a standard volume; that is, it disables the volume from accepting snapshots. You must delete all snapshots that exist for the master volume before converting it to a standard volume; otherwise, the command will fail. Input convert master-to-std volume Parameter Description volume Specifies the volume by its name or serial number. For the syntax to use, see “Volume Syntax” on page 26.
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 on different virtual disks. Input convert std-to-master volume snap-pool volume Parameter Description volume Specifies the master volume by its name or serial number. For the syntax to use, see “Volume Syntax” on page 26.
create chap-record Description iSCSI only. Creates a record to enable authentication between the originator (initiator) and recipient (target) of a login request when CHAP is enabled. 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).
Example Create a one-way CHAP record to enable a storage system to authenticate a host initiator having IQN iqn.1991.05.com.microsoft-swlab-qle. # create chap-record name iqn.1991-05.com.microsoft:myHost.domain secret 123456abcDEF Success: created CHAP record for iqn.1991-05.com.microsoft:myHost.
create host-wwn-name Description FC and SAS only. Creates an entry for a host world wide port name (WWPN) and associates a nickname with the entry. This enables you to specify the nickname instead of the WWPN when mapping volumes to hosts. Input create host-wwn-name wwn wwpn name Parameter Description wwn wwpn Specifies a 16-hex-digit WWPN that corresponds to an HBA. name Specifies a nickname for the HBA. For the syntax to use, see “Host Nickname Syntax” on page 27.
create iscsi-host Description iSCSI only. Associates a nickname with an iSCSI host initiator’s node name. You can then use the nickname when mapping volumes to hosts. Input create iscsi-host name name nickname Parameter Description name name Specifies an iSCSI host initiator’s node name. This is typically the initiator’s IQN (iSCSI Qualified Name). This must not be an existing node name, as displayed with the show iscsi-hosts command; it must be one that you get from some other source of information.
create master-volume Description Creates a volume on a specified virtual disk, enables the volume for snapshots, and associates it with an existing snap pool. The volume and snap pool must be owned by the same controller. Input create master-volume vdisk vdisk size sizeMB|GB|TB snap-pool volume [lun LUN] name Parameter Description vdisk vdisk Specifies the virtual disk by name or serial number. For the syntax to use, see “Virtual Disk Syntax” on page 26.
Related Commands ■ ■ ■ ■ “delete master-volume” on page 76 “show master-volumes” on page 200 “show snap-pools” on page 216 “show vdisks” on page 230 Chapter 3 Command Descriptions 55
create schedule Description Schedules a task to run automatically. Input create schedule sname schedule-specification "specification" task-name tname 56 Parameter Description sname Specifies a name for the new schedule, using a maximum of 32 characters and no quotation mark (") or backslash (\) characters. Names are case sensitive. schedulespecification "specification" Specifies when the task will run the first time, optional conditions defining when the task will recur and expire.
Example Create schedule Sched1 that runs Task1 for the first time on March 1, 2007; runs daily between midnight and 1:00 AM; and runs for the last time in the morning of January 1, 2008.
create snap-pool Description Creates a snap pool volume to use for snapshot data. A snap pool is an internal volume only and cannot be assigned a LUN. Input create snap-pool vdisk vdisk size sizeMB|GB|TB name Parameter Description vdisk vdisk Specifies the virtual disk by name or serial number. For the syntax to use, see “Virtual Disk Syntax” on page 26. size sizeMB|GB|TB Specifies the volume size in MB (Mbyte), GB (Gbyte), or TB (Tbyte).
create snapshots Description Creates a named snapshot of each specified master volume. Input create snapshots master-volumes volumes snap-names Parameter Description master-volumes volumes Specifies a comma-separated list of volumes by their names or serial numbers. For the syntax to use, see “Volume Syntax” on page 26. snap-names Specifies a comma-separated list of names for the resulting snapshot volumes. For the syntax to use, see “Volume Syntax” on page 26.
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.
Parameter Description type TakeSnapshot| ResetSnapshot| VolumeCopy Specifies the task. • TakeSnapshot: Takes a snapshot of a specified master volume. • ResetSnapshot: Deletes the data in the snapshot and resets it to the current data in the associated master volume. The snapshot’s name and other volume characteristics are not changed. • VolumeCopy: Copies a snapshot or a master volume to a new standard volume.
Parameter Description 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. If this parameter is omitted for a snapshot, modified snapshot data is excluded.
create user Description Creates a new user profile. When you enter the command, the system prompts you to enter a case-sensitive password, which can include a maximum of 19 characters except backslash (\), quotation mark ("), or spaces. The system supports 13 user profiles. Input create user name [level monitor|manage] [type standard|advanced |diagnostic] [interfaces interfaces] Parameter Description name Unique name that can include a maximum of 19 alphanumeric characters. Names are case sensitive.
Example Create an advanced manage user who can use the web and FTP interfaces. # create user level manage interfaces wbi,ftp jsmith Enter Password for new user jsmith:***** Re-enter Password:***** Info: User Type not specified, defaulting to Advanced.
create vdisk Description Creates a virtual disk using the specified RAID level, disk drives, and optional vdisk spares. All disks used in a virtual disk and its spares must be either SAS or SATA; mixing disk types is not supported. The following table specifies the number of disks supported for each virtual disk type, as determined by its RAID level.
Parameter Description assigned-to a|b|auto Optional. Specifies the controller to own the virtual disk. To have the system automatically load-balance virtual disks between controllers, use auto or omit this parameter. spare disks Optional. Specifies up to four vdisk spares to assign to a RAID 1, 3, 5, 6, 10, or 50 virtual disk. For the syntax to use, see “Disk Drive Syntax” on page 25. chunk-size 16k|32k|64k Optional. Specifies the chunk size in Kbyte. The default is 64k.
Example Create the RAID-1 virtual disk VD1 using two disk drives in the controller enclosure. # create vdisk level raid1 disks 1,3 VD1 Success: Vdisk created. Create the RAID-50 virtual disk VD2 having three RAID-5 sub-vdisks, each having three disk drives. # create vdisk level r50 disks 1-3:4-6:7-9 VD2 Success: Vdisk created.
create volume Description Creates a volume on a virtual disk. This command enables you to specify a size and name for the volume, and map it to hosts. Input create volume vdisk vdisk size sizeMB|GB|TB [mapping mapping] name 68 Parameter Description vdisk vdisk Specifies the virtual disk by name or serial number. For the syntax to use, see “Virtual Disk Syntax” on page 26. size sizeMB|GB|TB Specifies the volume size in MB (Mbyte), GB (Gbyte), or TB (Tbyte).
Example On a SAS system, create the 10-Gbyte volume V1 on virtual disk VD1, and map it to ports A0 and B0 using LUN 12. # create volume vdisk VD1 size 10GB mapping a0,b0.12 V1 Success: volume created and mapped successfully On an FC or iSCSI system, create the 10-Gbyte volume V1 on virtual disk VD1, and map it to ports 0 and 1 using LUN 12. The ports are on the controller that owns the virtual disk. # create volume vdisk VD1 size 10GB mapping 0-1.
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. Input delete all-master-volumes snap-pool volume Parameter Description snap-pool volume Specifies the snap pool volume by its name or serial number. For the syntax to use, see “Volume Syntax” on page 26. Example Delete all master volumes associated with snap pool SP1.
delete all-snapshots Description Deletes all snapshots associated with a specified volume, which can be a snap pool or master volume. All data associated with the snapshots is deleted and associated space in the snap pool is freed for use. Input delete all-snapshots volume volume Parameter Description volume volume Specifies the volume by its name or serial number. For the syntax to use, see “Volume Syntax” on page 26. Example Delete all snapshots associated with master volume MV1.
delete chap-records Description iSCSI only. Deletes a specific originator’s CHAP record or all CHAP records. This command is permitted whether or not CHAP is enabled. Input To delete the CHAP record for a specific originator: delete chap-records name originator-name delete chap-records all To delete all CHAP records: Parameter Description name originator-name Specifies the originator name, which is typically the originator’s IQN. The name is case sensitive and can include a maximum of 223 characters.
delete global-spare Description Removes one or more disk drives from the pool of global spares. Input delete global-spare disks disks Parameter Description disks disks Specifies the disk drives to remove. For the syntax to use, see “Disk Drive Syntax” on page 25. Example Remove the global spare having ID 5 in the controller enclosure. # delete global-spare disks 0.5 Info: Disk 0.5 unconfigured as a Global Spare.
delete host-wwn-name Description FC and SAS only. Deletes the nickname associated with a host world wide port name (WWPN). Input delete host-wwn-name host Parameter Description host Specifies the HBA’s nickname or 16-hex-digit WWPN. For the nickname syntax to use, see “Host Nickname Syntax” on page 27. Example Delete the nickname MyHost.
delete iscsi-host Description iSCSI only. Deletes the nickname associated with an iSCSI host initiator’s node name. Input delete iscsi-host host Parameter Description host Specifies an iSCSI host initiator's node name, or an existing nickname. For the nickname syntax to use, see “Host Nickname Syntax” on page 27. Example Delete the iSCSI host initiator nickname myHost.
delete master-volume Description Deletes a master volume. Alias of delete volume. Note – You must delete all snapshots that exist for the master volume before you can delete it. Input delete master-volume volume Parameter Description volume Specifies the volume by its name or serial number. For the syntax to use, see “Volume Syntax” on page 26. Example Delete master volume MV1. # delete master-volume MV1 Success: Master Volume Deleted.
delete schedule Description Deletes a specified task schedule. Input delete schedule schedule Parameter Description schedule Specifies the schedule name. Example Delete schedule Sched1.
delete snap-pool Description Deletes a snap pool. Note – You must disassociate all master volumes from the snap pool before you can delete it. Input delete snap-pool volume Parameter Description volume Specifies the snap pool volume by its name or serial number. For the syntax to use, see “Volume Syntax” on page 26. Example Delete snap pool SP1. # delete snap-pool SP1 Success: Snap-pool Deleted.
delete snapshot Description Deletes a snapshot volume. All data uniquely associated with the snapshot is deleted and associated space in the snap pool is freed for use. Input delete snapshot volume Parameter Description volume Specifies the volume by its name or serial number. For the syntax to use, “Volume Syntax” on page 26. Example Delete snapshot SS1. # delete snapshot SS1 Success: Snapshot Deleted.
delete snapshot-write-data Description Deletes the modified portion of a snapshot volume. This reverts the snapshot to the state when it was first taken. Input delete snapshot-write-data volume Parameter Description volume Specifies the volume by its name or serial number. For the syntax to use, “Volume Syntax” on page 26. Example Delete modified data from snapshot SS1. # delete snapshot-write-data SS1 Success: Snapshot Write Data Deleted.
delete task Description Deletes a specified task. If the task is scheduled, you must delete the schedule first. Input delete task task Parameter Description task Specifies the task name. Example Delete task Task1.
delete user Description Deletes a user profile. By default a confirmation prompt appears, which requires a yes or no response. You can delete any user including the default users. Input delete user name [noprompt] Parameter Description name Specifies the user profile to delete. Names are case sensitive. noprompt Optional. Suppresses the confirmation prompt. Example Delete user jsmith. # delete user jsmith Are you sure? yes Success: User jsmith deleted.
delete vdisk Description Deletes one or more virtual disks, disassociates all disk drives that are assigned to the virtual disks, and unmaps all volumes of the virtual disks from all host ports. Caution – Deleting a virtual disk will delete all data on that virtual disk. Note – You cannot delete a virtual disk that contains a snap pool associated with a master volume on another virtual disk. You cannot delete a virtual disk that is reconstructing.
Related Commands ■ ■ 84 “show master-volumes” on page 200 “show vdisks” on page 230 HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008
delete vdisk-spare Description Removes one or more spare disk drives that are assigned to a specified virtual disk. Input delete vdisk-spare disks disks vdisk Parameter Description disks disks Specifies the vdisk spares to remove. For the syntax to use, see “Disk Drive Syntax” on page 25. vdisk Specifies the virtual disk to remove the spare from. For the syntax to use, see “Virtual Disk Syntax” on page 26. Example Remove the vdisk spare having ID 5 in the controller enclosure from virtual disk VD1.
delete volume Description Deletes a volume. Input delete volume volume Parameter Description volume Specifies the volume to delete. For the syntax to use, see “Volume Syntax” on page 26. Example Delete volume V1.
exit Description Logs off and exits the CLI session.
expand snap-pool Description Expands a snap-pool volume by a specified size. Expansion is restricted to the available space on the virtual disk that hosts the volume. If insufficient space is available for expansion on the virtual disk, first expand the virtual disk by using expand vdisk. Input To expand a volume by a specific size: expand volume volume size sizeMB|GB|TB To expand a volume to the maximum size: expand volume volume size max Parameter Description volume Specifies the volume to expand.
Related Commands ■ ■ ■ ■ “expand vdisk” on page 90 “show snap-pools” on page 216 “show vdisks” on page 230 “show volumes” on page 237 Chapter 3 Command Descriptions 89
expand vdisk Description Adds disk drives to a virtual disk. The expansion capability for each supported RAID level is as follows. Table 3-2 Virtual Disk Expansion by RAID Level RAID Level Expansion Capability Maximum Drives NRAID (non-RAID) Cannot expand. 1 0, 3, 5, 6 You can add 1–4 drives at a time. 16 1 Cannot expand. 2 10 You can add 2 or 4 drives at a time. 16 50 You can expand the virtual disk, one RAID 5 sub-vdisk at a time.
Example Expand virtual disk VD1 to include the disk drive having ID 11 in the controller enclosure. # expand vdisk VD1 disks 0.
expand volume Description Expands a standard volume or snap-pool volume by a specified size. Expansion is restricted to the available space on the virtual disk that hosts the volume. If insufficient space is available for expansion on the virtual disk, first expand the virtual disk by using expand vdisk. Note – To expand a master volume: Delete all of its snapshots by using delete all-snapshots. Convert it to a standard volume by using convert master-to-std.
Example Expand V1 by 100 Gbyte.
map volume Description Creates a mapping whose settings override a volume’s default mapping. When a volume is created, it has a default mapping that 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. By default, this mapping presents no LUN and allows no access for all hosts through all ports. The default mapping’s LUN value is referred to as the volume’s default LUN.
Parameter Description host host Optional. For FC and SAS, this specifies the host’s nickname or 16-hex-digit WWPN. For iSCSI, this specifies the iSCSI host initiator’s node name (typically the IQN) or nickname. For the nickname syntax to use, see “Host Nickname Syntax” on page 27. If this parameter is omitted, the mapping applies to the all-hosts mapping and applies to all hosts that are not explicitly mapped. access read-write|rw| read-only|ro| none Optional.
Related Commands ■ ■ ■ ■ ■ ■ 96 “show host-maps” on page 188 “show host-wwn-names” on page 194 “show iscsi-hosts” on page 195 “show volume-maps” on page 235 “show volumes” on page 237 “unmap volume” on page 244 HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008
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. Input ping host-address [count] Parameter Description host-address Specifies the remote host’s IP address in dotted decimal form. count Optional. Specifies the number of packets to send. The default is 4 packets. You should use a small count because the command cannot be interrupted. Example Send two packets to the remote computer at 10.0.0.
rescan Description This command forces rediscovery of attached disk drives and enclosures. If both Storage Controllers are online, it also forces re-evaluation of the enclosure IDs of attached drive enclosures, so that IDs are assigned 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 drives are inserted or removed; the controllers do this automatically.
reset host-channel-link Description FC only. For a system using loop (FC-AL) topology, this command issues a loop initialization primitive (LIP) for specified controller ports. Input reset host-channel-link channel channels [controller a|b|both] Parameter Description channel channels Specifies a host port number or a comma-separated list of host port numbers such as 0,1. controller a|b|both Optional. Specifies whether to issue the LIP from controller A, controller B, or both.
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 either or both controller modules. 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 Controllers are not restarted so they can provide status information to external interfaces.
Example Restart the Management Controller in controller A, which you are logged in to. # restart mc a During the restart process you will briefly lose communication with the specified management Controller(s). Continue? yes Info: Restarting Local MC A... From controller A, restart the Storage Controller in controller B. # restart sc b Success: SC B restarted.
restore defaults Description Note – This command should only be used by service technicians, or with the advice of 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.
Example Roll back master volume MV1 to snapshot SS1. # rollback master-volume MV1 snapshot SS1 Leaving the master volume mounted when starting a rollback operation will result in data corruption. The master volume must be unmounted prior to beginning the rollback operation. The master volume can be remounted once the rollback has started. Not unmounting the volume prior to beginning the rollback operation will result in data corruption.
scrub vdisk Description For specified RAID 3, 5, 6, and 50 virtual disks, this command verifies all parity blocks. For specified RAID 1 and 10 virtual disks, this command compares the primary and secondary drives. In addition, this command scrubs virtual disk metadata, and stripe and NRAID virtual disks. When the scrub is complete, an event is logged specifying the number of errors found. Input scrub vdisk vdisks Parameter Description vdisks Specifies the virtual disks by name or serial number.
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. By default, automatic write-back is enabled. Alias: set awt When the cache mode is changed, an event is logged.
Parameter Description partner-notify enable|disable Specify 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. The default is Disabled. auto-write-back enable|disable Specify whether the cache mode automatically changes to write-back after the trigger condition is cleared.
set awt Alias for set auto-write-through-trigger. See “set auto-write-throughtrigger” on page 107.
set cache-parameters Description Sets cache options for a specific volume, or the cache redundancy mode for a dualcontroller storage system. Note – Only change cache settings if you fully understand how your operating system, application, and HBA move data so that you can adjust the settings accordingly. Be prepared to monitor system performance using the virtual disk statistics and adjust read-ahead size until you find the optimal size for your application.
Cache Optimization Mode Before creating or modifying a volume, determine the appropriate cache optimization mode. The controller supports super-sequential optimization mode for sequential I/O and standard optimization mode for random I/O. The cache optimization mode setting for each volume optimizes the cache block size used by the controller: ■ For sequential optimization, the cache block size is 128 Kbyte. ■ For random optimization, the cache block size is 32 Kbyte.
Independent Cache Performance 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. You can disable cache redundancy, which permits independent cache operation for each controller; this is called independent cache performance mode (ICPM).
To set the cache redundancy mode for the storage system: set cache-parameters independent enable|disable Parameter Description volume Specifies the volume by its name or serial number. For the syntax to use, see “Volume Syntax” on page 26. write-policy write-back| write-through Optional. Sets the cache policy to either: • 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.
Parameter Description read-ahead-size disable|default|maximum| 64KB|128KB|256KB|512KB| 1MB|2MB|4MB|8MB|16MB|32MB Optional. Controls the use and size of readahead cache: • disable: Turns off read-ahead cache. This is useful if the host is triggering read ahead for what are random accesses. This can happen if the host breaks up the random I/O into two smaller reads, triggering read ahead. You can use the volume statistics read histogram to determine what size accesses the host is doing.
Parameter Description independent enable|disable Sets the cache redundancy mode for a dualcontroller storage system. enable sets the storage system’s operation mode to Independent Cache Performance Mode. When this mode is enabled, controller failover is disabled and write-back cache is not mirrored to the partner controller. This results in improved write performance but at a risk of loss of unwritten data if a controller failure occurs while there is data in the controller’s cache memory.
set chap-record Description iSCSI only. Changes the CHAP record for a specific originator. This command is permitted whether or not CHAP is enabled. Input set chap-record name originator-name [secret originator-secret] [mutual-name recipient-name] [mutual-secret recipient-secret] Parameter Description name originatorname Specifies the originator name, which is typically the originator's IQN. The name is case sensitive and can include a maximum of 223 characters. secret originator-secret Optional.
Related Commands ■ ■ ■ ■ ■ “create chap-record” on page 50 “delete chap-records” on page 72 “show chap-records” on page 162 “show host-parameters” on page 190 “show iscsi-parameters” on page 196 Chapter 3 Command Descriptions 117
set cli-parameters Description Sets the CLI timeout, the output characteristics of the show commands, and the way that the system handles some errors. If you are accessing the CLI through the Ethernet 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.
Parameter Description disk-addressing enclosure-slot| channel-id Optional. Sets the format in which drive IDs are shown and must be specified. • enclosure-slot: Drives are shown, and must be specified, with the format enclosureID.drive-slot-number. This is the default. For example, the first drive in the second enclosure (enclosure ID 1) has address 1.0. • channel-id: Drives are shown, and must be specified, by SCSI ID. For example, the first drive in the second enclosure has address 16.
set controller-date Description Sets the date and time of the Management Controller and then updates the date and time for each RAID controller. Input 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] [ntpaddress IP-address] 120 Parameter Description jan|feb|mar|apr|may|jun |jul|aug|sep|oct|nov|dec Specifies the month. day Specifies the day number (1–31).
Example Set the controller date to 1:45 PM on September 22, 2007 in the U.S. Mountain time zone (GMT -07:00). # set controller-date sep 22 13:45:0 2007 -7 Success: Command completed successfully Enable NTP using a specified time-zone offset and NTP server address. # set controller-date sep 22 13:45:0 2007 -7 ntp enabled ntpaddress 69.10.36.
set debug-log-parameters Description Note – This command should only be used by service technicians, or with the advice of 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 quotation marks ("). Input set debug-log-parameters message-type+|- [...
Parameter Description • ioa: iSCSI and SAS only. I/O interface driver debug messages (standard) • iob: iSCSI and SAS only. I/O interface driver debug messages (resource counts) • ioc: iSCSI and SAS only. I/O interface driver debug messages (upper layer, verbose) • iod: iSCSI and SAS only.
set drive-parameters Description Selects a global disk Self-Monitoring Analysis and Reporting Technology (SMART) setting. Disk drives equipped with this technology can alert the controller of impending drive failures. Changes to the SMART setting take effect after a rescan or a controller reboot. Input set drive-parameters smart enabled|disabled|detect-only Parameter Description smart enabled| disabled|detect-only Enables or disables SMART monitoring for all disk drives in the storage system.
set expander-fault-isolation Description Note – This command should be used only by service technicians, or with the advice of 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.
Example Disable PHY fault isolation for Expander Controller A in an enclosure. # set expander-fault-isolation wwn 500C0FF00A408A3C controller a disable Success: Disabled expander fault isolation. Re-enable PHY fault isolation for Expander Controller A in the same enclosure. # set expander-fault-isolation wwn 500C0FF00A408A3C controller a enable Success: Enabled expander fault isolation.
set expander-phy Description Note – This command should be used only by service technicians, or with the advice of a service technician. Disables (isolates) or enables a specific PHY. Input set expander-phy wwn enclosure-wwn controller a|b|both index phy-index enable|disable Parameter Description wwn enclosure-wwn Specifies the port WWN (WWPN) of the enclosure containing the PHY to enable or disable. To determine the WWPN, use the show enclosure-status command.
Example Disable the first egress PHY in both controllers in an enclosure, after determining the PHY index; then verify the PHY’s status.
set global-spare Description Designates spare disk drives that can be used by any virtual disk. Sets the disk drive status to global-spare. For the command to succeed, you must specify disk drives that are large enough to protect existing virtual disks. You can designate a maximum of eight global spares for the system. Input set global-spare disks disks Parameter Description disks disks Specifies the disk drives. For the syntax to use, see “Disk Drive Syntax” on page 25.
set host-parameters Description FC and iSCSI only. Sets parameters for communication between controllers and hosts. The new settings take effect without restarting the controllers. Input set host-parameters [controller a|b|both] [speed speed] [channel #|all] [fibre-connection-mode loop|point-to-point] [IP address] [netmask address] [gateway address] [noprompt] 130 Parameter Description controller a|b|both Optional. Specifies whether to apply the settings to controller A, B, or both.
Example For an FC storage system, set the link speed to 2 Gbit/sec for controller A port 1 and for controller B port 0. # set host-parameters controller a speed 2g channel 1 WARNING: You have requested a change on host channel parameters. This change will take effect immediately. If the link speed is changed, your current link may go down.
set host-port-interconnects Description FC direct-attach mode only. Enables or disables the internal connection between controller host port pairs. In a dual-controller system, each host port on controller A is connected to a peer host port on controller B. When the connection between peer host ports is enabled, it forms an FC-AL loop. This command affects the connections between all host port pairs.
set host-wwn-name Description FC and SAS only. Sets the nickname of an HBA entry for a host world wide port name (WWPN). Input set host-wwn-name host host new-nickname Parameter Description host host Specifies an existing 16-hex-digit WWPN or an existing port nickname. For the nickname syntax to use, see “Host Nickname Syntax” on page 27. new-nickname Specifies a new nickname for the port. For the nickname syntax to use, see “Host Nickname Syntax” on page 27.
set iscsi-host Description iSCSI only. Sets the nickname associated with an iSCSI host initiator’s node name. Input set iscsi-host host host new-nickname Parameter Description host host Specifies an iSCSI host initiator’s node name or an existing nickname. For the nickname syntax to use, see “Host Nickname Syntax” on page 27. new-nickname Specifies a new nickname for the iSCSI host initiator. For the nickname syntax to use, see “Host Nickname Syntax” on page 27.
set iscsi-parameters Description iSCSI only. Changes system-wide iSCSI parameters. Input set iscsi-parameters [chap enabled|disabled] [jumbo-frame enabled|disabled] [speed auto|1g] [isns enabled|disabled] [isns-ip iSNS-IP] [isns-alt-ip iSNS-IP] Parameter Description chap enabled|disabled Enables or disables use of Challenge Handshake Authentication Protocol. Disabled by default. jumbo-frame enabled|disabled Enables or disables support for jumbo frames. Disabled by default.
Related Commands ■ 136 “show iscsi-parameters” on page 196 HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008
set job-parameters Description Sets parameters for background scrub, partner firmware upgrade, and other jobs. Input set job-parameters [background-scrub enabled|on|disabled|off] [partner-firmware-upgrade enabled|on|disabled|off] [utilitypriority low|medium|high] Parameter Description background-scrub enabled|on|disabled|off Optional. Controls whether vdisks are checked for disk drive defects to ensure system health. partner-firmware-upgrade enabled|on|disabled|off Optional.
set led Description Changes the state of drive module or enclosure LEDs to help you locate devices. For LED descriptions, see the user guide. Input set led disk|enclosure ID on|off Parameter Description disk ID Specifies a disk drive number. For the syntax to use, see “Disk Drive Syntax” on page 25. enclosure ID Specifies the enclosure number, where 0 represents the controller enclosure and the number increments for each attached drive enclosure. on|off Specifies to set or unset the LED.
set network-parameters Description Sets IP values for controller module Ethernet management ports. IP values can be set dynamically using Dynamic Host Configuration Protocol (DHCP) for both controllers, or manually (statically) for each controller. If DCHP is enabled, manually setting an IP value for either controller disables DHCP for both controllers.
Manually set Ethernet management 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.
set password Description Sets a user's password for system interfaces (such as the CLI). The command prompts you to enter and re-enter the new password. A password can include a maximum of 19 characters except backslash (\), quotation mark ("), or spaces. The password is case sensitive. Input set password [user] Parameter Description user Optional. Specifies the login name of the user to set the password for. If this argument is omitted, this command affects the logged-in user's password.
set prompt Description Sets the prompt for the current CLI session. Input set prompt prompt Parameter Description prompt Specifies the new prompt string, which can include 0–7 characters. A string that includes a space must be enclosed in quotation marks ("). Output Command line with new prompt. Example Set the prompt to CLI> followed by a space .
set protocols Description Enables or disables management services and protocols. Input set protocols [capi enabled|disabled] [debug enabled|disabled] [ftp enabled|disabled] [http enabled|disabled] [https enabled|disabled] [service enabled|disabled] [ses enabled|disabled] [smis enabled|disabled] [snmp enabled|disabled] [ssh enabled|disabled] [telnet enabled|disabled] Parameter Description capi enabled|disabled Optional. Enables or disables the in-band CAPI management interface.
Example Disable unsecure HTTP connections and enable FTP. # set protocols http disabled ftp enabled Info: Setting HTTP to disabled Info: Setting FTP to enabled Success: Committed Out-Of-Band protocol changes.
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.
Parameter Description autoexpansionsize sizeMB|GB|TB Specifies the increment in MB (Mbyte), GB (Gbyte), or TB (Tbyte) by which the snap pool will be automatically expanded when the threshold level is reached. The size uses base 10 (multiples of 1000) or base 2 (multiples of 1024); to see the current base setting, use show cli-parameters. Example Set the error policy to autoexpand and the automatic expansion size to 10 GB for snap pool SP1.
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. This first threshold indicates that snap-pool space is moderately full. When exceeded, an event is generated to warn the administrator. ■ Error. This second threshold indicates that the snap pool is getting full and unless corrective action is taken, snapshot data loss is probable.
Related Commands ■ ■ 148 “set snap-pool-policy” on page 145 “show snap-pools” on page 216 HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008
set snmp-parameters Description Configures SNMP notification of events. Input set snmp-parameters [enable crit|warn|info|none] [add-trap-host address] [del-trap-host address] [read-community string] [write-community string] Parameter Description enable crit|warn|info |none Optional. Sets the level of trap notification: • crit: Sends critical events only. • warn: Sends all critical events and warnings. • info: Sends all events.
set system Description Sets the name, contact person, location, and description for a system. Each value can include a maximum of 79 characters except quotation mark (") or backslash (\). If the value contains a space, enclose the value in quotation marks. Input set system [name value] [contact value] [location value] [info value] Parameter Description name value Specifies the system’s name. contact value Specifies the system’s contact person. location value Specifies the system’s location.
set user Description Changes a user’s level, type, and interface access. To change a user’s password, use set password. Input set user name [level monitor|manage] [type standard|advanced |diagnostic] [interfaces interfaces] Parameter Description name Specifies the user profile to change. Names are case sensitive. level monitor|manage Optional. Specifies whether the user has monitor (view-only) or manage (modify) access for user interfaces. The default is monitor.
Example Change a user’s type and interface access. # set user type advanced interfaces wbi,cli jsmith Success: User-Type set to advanced.
set vdisk Description Sets the name and owning controller for an existing virtual disk. Caution – If you change the ownership of a virtual disk whose volumes are mapped to hosts, the assigned LUNs become invalid and hosts lose access to the volumes. After changing ownership, you must reassign the LUNs and, depending on the host operating system, either rescan or restart to detect the LUN changes.
set vdisk-spare Description Designates spare disk drives that can be used by a specific virtual disk, and sets the disk drive status to VDISK SP. A vdisk spare can be assigned to RAID 1, 3, 5, 6, 10, and 50 virtual disks, and must have enough capacity to replace the smallest disk drive in the virtual disk. Input set vdisk-spare disks disks vdisk Parameter Description disks disks Specifies up to four disk drives. For the syntax to use, see “Disk Drive Syntax” on page 25.
set volume Description Changes the name of a volume. Input set volume volume name new-name Parameter Description volume Specifies the volume by its name or serial number. For the syntax to use, see “Volume Syntax” on page 26. name new-name Specifies a new name for the volume. For the syntax to use, see “Volume Syntax” on page 26. Example Rename volume V1 to V2.
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 Input show auto-write-through-trigger Output Shows whether each trigger is enabled or disabled. Example Show the system’s trigger settings.
show cache-parameters Description Shows cache settings for the storage system and optionally for a specified volume. Input show cache-parameters [volume] Parameter Description volume Optional. Specifies the volume by its name or serial number. For the syntax to use, see “Volume Syntax” on page 26. If this parameter is not specified, the volume-specific data is not displayed. Output Field Description Operation Mode The operation mode, also called the “redundancy mode.” • Active-Active ULP: SAS only.
Field Description Write Mode If a volume is specified, its cache policy, either write-back or write-through Optimization If a volume is specified, its cache optimization mode, either standard (random) or super-sequential Read Ahead Size If a volume is specified, its read-ahead cache setting Example On a SAS system, show the cache parameters for the system and for volume V1.
show channels Description Shows information about host and expansion ports on both controllers. Input show channels Output Field Description Ctlr Controller ID Ch Port number Type • Host: Host port • Drive: Expansion port Media • • • • • Topo (C) FC or SAS only. Configured topology Speed (A) Actual host-port link speed. Blank if not applicable Speed (C) FC or SAS only.
Example Show port information for a dual-controller SAS storage system.
Show port information for a dual-controller iSCSI storage system. # show channels Ctlr Ch Type Media Speed(A) Status IP-Ver PIP MAC ---------------------------------------------------------------A 0 Host iSCSI 1Gb Up IPv4 10.11.10.4 A8:A5:00:00:00:09 A 1 Host iSCSI 1Gb Up IPv4 10.10.10.5 A8:A5:00:00:00:08 A 0 Drive SAS Up N/A N/A N/A B 0 Host iSCSI 1Gb Up IPv4 10.11.10.2 00:C0:FF:0A:8A:53 B 1 Host iSCSI 1Gb Up IPv4 10.10.10.
show chap-records Description iSCSI only. Shows the CHAP records for a specific originator, or all CHAP records if no originator is specified. This command is permitted whether or not CHAP is enabled. Input show chap-records [name originator-name] Parameter Description name originator-name Optional. Specifies the originator name, which is typically the originator’s IQN. The name is case sensitive and can include a maximum of 223 characters.
Example Show the CHAP record for a specific host initiator. # show chap-records name iqn.1991-05.com.microsoft:myHost.domain CHAP Record(s) -------------Name: iqn.1991-05.com.microsoft:myHost.domain Secret: 123456abcDEF Mutual CHAP Name: iqn.1995-03.com.acme:01.storage.
show cli-parameters Description Shows the current CLI settings. Input show cli-parameters Output 164 Field Description Timeout Timeout value, in seconds, for the login session. Output Format • console: Output is shown in human-readable console format. • api: Output is shown in XML format. Base • 2: Capacities are shown in base 2, which uses 1024 as a divisor. • 10: Capacities are shown in base 10, which uses 1000 as a divisor.
Example Show current CLI settings.
show configuration Description Shows system configuration information. Input show configuration Output Category Fields System information See “show system” on page 222.
Category Fields Virtual disk information See “show vdisks” on page 230. Enclosure status information, including SCSI Enclosure Services (SES) data See “show enclosure-status” on page 178. Field-replaceable unit (FRU) information See “show frus” on page 186.
show controller-date Description Shows the system’s current date and time. Input show controller-date Output Field Description Controller Date Date and time Example Show the system date and time on an FC or iSCSI system. # show controller-date Controller Date: FRI APR 25 10:09:28 2008 Show the system date and time on a SAS system.
show debug-log Description Note – This command should only be used by service technicians, or with the advice of a service technician. Shows the debug logs for the Storage Controller (SC), the Management Controller (MC), the semaphore trace, task logs, or all of them. If no parameters are specified, all logs are shown.
Parameter Description sem-entries Optional. Specifies the number of semaphore log entries to show. If this parameter is omitted, all semaphore log entries are shown. task-log Specifies to show the MC task status at the time this command is issued. task-entries Optional. Specifies the number of task log entries to show. If this parameter is omitted, all task log entries are shown. all Optional. Specifies to show all logs.
Related Commands ■ ■ “set debug-log-parameters” on page 122 “show debug-log-parameters” on page 172 Chapter 3 Command Descriptions 171
show debug-log-parameters Description Note – This command should only be used by service technicians, or with the advice of a service technician. Shows which debug message types are enabled (on) or disabled (off) for inclusion in the Storage Controller debug log.
Field Description (Continued) raid RAID debug messages cache Cache debug messages emp Enclosure Management Processor debug messages capi Internal Configuration API debug messages mui Internal service interface debug messages bkcfg Internal configuration debug messages awt Auto-write-through feature debug messages res2 Internal debug messages capi2 Internal Configuration API tracing debug messages dms Snapshot feature debug messages fruid FRU ID debug messages Example Show debug log p
show disks Description Shows information about disk drives in the controller enclosure and any attached drive enclosures. The encl option shows different fields than the other options and shows each slot, whether or not a disk is present. If no parameter is specified, the command shows information for all disk drives. Input show disks [disks|free|all|encl|vdisk vdisk] Parameter Description disks|free|all|encl |vdisk vdisk Optional.
Field Description State • • • • • AVAIL: Disk is available for use in a vdisk GLOBAL SP: Global spare LEFTOVR: Disk contains metadata but is not part of a vdisk VDISK: Disk is part of a vdisk VDISK SP: Disk is a spare assigned to a vdisk Any jobs running on the disk or its vdisk follow the state value: • DRSC: The disk is being scrubbed • EXPD: The vdisk is being expanded • INIT: The vdisk is being initialized • LOWF: A low-level format is in progress • RCON: The vdisk is being reconstructed • VRFY: Th
Example Show information for disk drives 0, 1, and 4 in the first enclosure. # show disks 0.0-1,0.4 ID Serial# Vendor Rev. State Type Size(GB) Rate(Gb/s) SP ---------------------------------------------------------------------0 KRVN03ZAG4ZPPD ATA AD1A AVAIL SATA 500 3.0 1 KRVN03ZAGA88PD ATA AD1A VDISK SATA 500 3.0 4 KRVN03ZAG4L22D ATA AD1A VDISK VRSC SATA 500 3.0 ---------------------------------------------------------------------- Show information about disk drives, where drive 1 is not inserted.
show drive-parameters Description Shows the SMART setting. Input show drive-parameters Output Field Description SMART Shows whether SMART is enabled or disabled for all disk drives, or is set to detect-only, which specifies that each new drive inserted in the system retain its current SMART setting. Example Show drive parameter settings.
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.
Field Description # Unit ID For the location of each fan and power supply, see Figure 3-1. For the location of each disk slot, see Figure 3-2. Status Component status: • Absent: Component is not present • Fault: One or more subcomponents has a fault • OK: All subcomponents are operating normally. Temperature status OK indicates that the sensor is working properly, not that the temperature is within an acceptable range.
Example Show status information for a single-enclosure 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 module. Each event number is prefixed with a letter identifying the controller module 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.
Parameter Description to date Optional. Shows events before and including the specified date and time. Use the format MMDDYYhhmmss, where hh is the hour on a 24-hour clock. For example, 043006235900 represents Apr 30 2006 at 11:59:00 p.m. This parameter can be used with either “from” parameter. from-event ID Optional. Shows events including and after the specified event ID. If this number is smaller than the ID of the oldest event, events are shown from the oldest available event.
Field Description Severity • CRITICAL: Events that might affect data integrity or system stability. • WARNING: Events that do not affect data integrity. • INFORMATIONAL: Events that show the change of state or configuration changes. Message Event-specific message giving details about the event; for example, LAN configuration parameters have been set Example Show the last two events. # show events last 2 Show the last three warning and critical events.
show expander-status Description Shows diagnostic information relating to SAS expander 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. Input show expander-status Output 184 Parameter Description Encl Enclosure that contains the SAS expander Phy Identifies a PHY's logical location within a group based on the PHY type. Logical IDs are 0–11 for disk PHYs and 0–3 for inter-expander, egress, and ingress PHYs.
Example Show the expander status for all enclosures.
show frus Description Shows information for all field-replaceable units (FRUs) in the controller enclosure and in any attached drive enclosures. Some information reported is for use by service technicians.
Field Description FRU Location Location of the FRU in the enclosure, as viewed from the back: • MID-PLANE SLOT: Chassis midplane • UPPER IOM SLOT: Controller or expansion module A • LOWER IOM SLOT: Controller or expansion module B • LEFT PSU SLOT: Power-and-cooling module 0 • RIGHT PSU SLOT: Power-and-cooling module 1 Configuration SN A customer-specific configuration serial number FRU Status Component status: • Absent: Component is not present • Fault: One or more subcomponents has a fault • OK: All
show host-maps Description Shows mapping information for volumes that are mapped to a specified host or to all hosts. Input show host-maps [host] Parameter Description host Optional. For FC and SAS this specifies the host's nickname or 16-hexdigit WWPN. For iSCSI this specifies the iSCSI host initiator’s node name (typically the IQN) or nickname. For the nickname syntax to use, see “Host Nickname Syntax” on page 27. If this parameter is omitted, mapped volumes for all hosts are shown.
Example On a SAS system, show mappings for host Host1. # show host-maps Host1 Host [WWN 100000A0B8040BAC, Name (Host1)] Mapping View: Volume Name Volume SN LUN Access Channels -----------------------------------------------------------------------V1 00c0ff0a43180048517e054501000000 15 rw A0,B0 On an FC system, show mappings for host Host1.
show host-parameters Description Shows information about host ports on both controllers. Input show host-parameters Output 190 Field Description Ctlr Controller ID Ch Host port number Type • Host: Host port Media • • • • Topo (C) FC or SAS only. Configured topology Speed (A) FC or SAS only. Actual link speed:. Blank if not applicable. Speed (C) FC or SAS only.
Example Show host parameters for a dual-controller FC storage system. # show host-parameters Ctlr Ch Type Media Topo(C) Speed(A) Speed(C) Status PID SID ---------------------------------------------------------------A 0 Host FC(L) Loop 2G 2G Up 0 A 1 Host FC(L) Loop 2G 2G Up 2 B 0 Host FC(L) Loop 2G 2G Up 0 B 1 Host FC(L) Loop 2G 2G Up 1 ---------------------------------------------------------------- Show host parameters for a dual-controller SAS storage system.
Show host parameters for a dual-controller iSCSI storage system. # show host-parameters Host Parameters --------------Ctlr: A Ch: 0 Type: Host Media: iSCSI Status: Up IP-Ver: IPv4 PIP: 10.11.10.4 PIP-Netmask: 255.255.255.0 PIP-Gateway: 0.0.0.0 PIP-Service-Port: 3260 Port-Name: iqn.1995-03.com.acme:01.storage.00c0ffd6000a.a Target Alias: MySystem.a ... Ctlr: B ... Port-Name: iqn.1995-03.com.acme:01.storage.00c0ffd6000a.b Target Alias: MySystem.
show host-port-interconnects Description FC only. Shows the status of the internal connection between controller host port pairs. Input show host-port-interconnects Example Show the status of the host port interconnect.
show host-wwn-names Description FC and SAS only. Shows the current list of host world wide names (WWNs). Input show host-wwn-names Output Field Description Host-ID/WWN Host port WWN Name Nickname assigned to the host WWN Example Show host WWNs and nicknames assigned to them.
show iscsi-hosts Description iSCSI only. Shows iSCSI host initiators. Input show iscsi-hosts Output Field Description Host node name/IQN iSCSI host initiator’s node name, typically the IQN. If the host node name exceeds 62 characters and the CLI is in console mode, the node name that is displayed is truncated and a ‘>’ is displayed at the end of the string. If you need to see the full node name, use show hostmaps or use the CLI’s api mode to view the output in XML format.
show iscsi-parameters Description iSCSI only. Shows system-wide iSCSI parameters.
Related Commands ■ “set iscsi-parameters” on page 135 Chapter 3 Command Descriptions 197
show job-parameters Description Shows parameters for background scrub, partner firmware upgrade, and other jobs. Input show job-parameters Output Field Description Background Scrub Shows whether disks are automatically checked for disk drive 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 whether a license key is installed and information about licensed features.
show master-volumes Description Shows information about master volumes associated with a specified controller or snap pool. If no parameters are specified, information about all master volumes is shown. Input show master-volumes [controller a|b] [snap-pool volume] Parameter Description controller a|b Optional. Only includes master volumes owned by controller A or B. snap-pool volume Optional. Only includes master volumes associated with a specified snap pool volume name or serial number.
Field Description Snap Data Amount of snap-pool space occupied by this master volume for its associated snapshots (preserved and write data) Rollback Either the percent complete if rollback is in progress, or “---” if rollback is not in progress Example Show information about master volumes associated with snap pool SP1.
show network-parameters Description Shows the network settings for each RAID controller. Input show network-parameters Output Field Description IP Address Controller IP address Gateway Controller gateway Subnet Mask Controller subnet mask MAC Address Controller's unique Media Access Control address Addressing Mode • Manual: Network settings set manually (statically) • DHCP: DHCP used to set network parameters Example Show network parameters for a storage system using DHCP.
Show network parameters for a storage system using manual addressing. # show network-parameters Network Parameters Controller A ------------------------------IP Address : 172.22.1.200 Gateway : 172.22.1.1 Subnet Mask : 255.255.255.0 MAC Address : 00:C0:FF:0A:43:18 Addressing Mode: Manual Network Parameters Controller B ------------------------------IP Address : 172.22.1.201 Gateway : 172.22.1.1 Subnet Mask : 255.255.255.
show ntp-status Description Shows the status of the use of Network Time Protocol (NTP) in the system. Input show ntp-status Output The output first indicates whether use of NTP is enabled (activated). If activated, the client task becomes present. Before activation and after successful deactivation the status of the client task is not applicable (n/a). The configured IP address of an NTP server, if any, is displayed.
Example Show NTP status for the system. # show ntp-status NTP Status ---------Status : Client Task Status : NTP Server Address : Last Server Contact: activated present 69.10.36.
show port-wwn Description FC and SAS only. Shows the world wide port name (WWPN) for each host port. Input show port-wwn Output Field Description CTRL Controller ID CH Host port number WWPN World wide port name Example Show a SAS system’s port WWNs, which differ in the fourteenth digit.
show protocols Description Shows which management services and protocols are enabled or disabled. Input show protocols Output Status of each protocol. Example Show the status of service and security protocols.
show redundancy-mode Description Shows the redundancy status of the system. Input show redundancy-mode Output 208 Field Description Redundancy Mode The redundancy mode, also called the “operation mode.” • Active-Active ULP: SAS only. Both controllers are active using ULP (Unified LUN Provisioning), which means 128 LUNs are available for mapping volumes. • Active-Active: FC and iSCSI only. Both controllers are active, and each has 128 LUNs for mapping volumes owned by that controller only.
Field Description Controller ID Serial Number • Controller module serial number • Not Available: The controller is down or not installed. Example Show the redundancy status of an operational dual-controller SAS system.
show schedule-details Description Shows information about a specified task schedule. Inputt show schedule-details schedule Parameter Description schedule Specifies the schedule name.
Example Show details for task schedule Sched1 which should run task T1. The task will run at 12:59. When the task was scheduled to run the previous time, an error occurred.
show schedules Description Shows configured task schedules. Input show schedules Output Field Description Schedule Name Schedule name Task To Run Task name Next Time The next time the task will run; or none if the task will not run again Example Show configured task schedules for a system.
show sensor-status Description Shows the status and current values reported by environmental sensors in each controller module and power module. Input show sensor-status Output Field Description Sensor Name Where the sensor is located 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.
Example Show the status and value of the sensors.
show shutdown-status Description Shows whether the RAID (storage) controllers are shut down. Input show shutdown-status Output Message stating whether each controller is up (operating) or down (shut down). Example Show the shutdown status for each controller.
show snap-pools Description Shows information about snap pools owned by a specified controller or both controllers. Input show snap-pools [controller a|b|both] Parameter Description 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.
Example Show information for snap pools owned by either controller. # show snap-pools Vdisk Serial# Name Size Free MasterVols Snapshots -----------------------------------------------------------R5 00c0ff6270190000938c1d4701000000 SP1 3001.0MB 2990.5MB 1 0 Threshold %Usage Policy SizeToExpand --------------------------------------------------------Warning 75% Notify Only N/A Error 90% Auto Expand 1000.
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. Input show snapshots [controller a|b|both] | [master-volume volume] | [snap-pool volume] Parameter Description controller a|b|both Optional. Only includes snapshots owned by controller A only, controller B only, or by either controller (both). master-volume volume Optional.
Field Description Status-Reason Shows “---” for Available status, or a reason for Unavailable status: • MV Not Accessible (master volume is not accessible) • MV Not Found (master volume is not found) • SP Not Accessible (snap pool is not accessible) • SP Not Found (snap pool is not found) • SS Pending (snapshot is pending) • VC-MD In Progress (volume-copy with modified data is in progress) • RB-MD In Progress (rollback with modified data is in progress) • Unknown Master Volume Name Name of associated m
show snmp-parameters Description Shows current settings for SNMP notification.
Related Commands ■ “set snmp-parameters” on page 149 Chapter 3 Command Descriptions 221
show system Description Shows information about the system.
show task-details Description Shows details of a configured task. Input show task-details task Output (TakeSnapshot) Field Description Task Name Task name Task Type TakeSnapshot Task Status The status of the task: Ready, Active Task State The current state of the task: Init, Vol Verified, License Checked, Name Created, Snap Created, Snap Verified Master Volume Name Master volume name Master Volume Serial Volume serial number Snapshot Prefix Label identifying the snapshot.
Output (ResetSnapshot) Field Description Task Name Task name Task Type ResetSnapshot Task Status The status of the task: Ready, Active Task State The current state of the task: Init, Snap Verified Snapshot Name Name of the snapshot to be reset Snapshot Serial Serial number of the snapshot to be reset Error Message Any error message associated with this task Output (VolumeCopy) 224 Field Description Task Name Task name Task Type VolumeCopy Task Status The status of the task: Ready, A
Example Show the details of the volume copy task C1. # show task-details C1 Task Details -----------Task Name: C1 Task Type: VolumeCopy Task Status: Ready Task State: Init Source Volume Name: VD1_V1 Source Volume Serial: 00c0ffd2710700481a8fcf4501000000 Destination Vdisk Name: VD2 Destination Vdisk Serial: 00c0ffd270280048b68ecf4500000000 Destination Volume Prefix: Copy Include Modified Data: false Last Copy Created: none Error Message: none Show the details of the take snapshot task T1.
Related Commands ■ “create schedule” on page 56 ■ “create task” on page 60 ■ “delete task” on page 81 ■ “show schedule-details” on page 210 ■ “show tasks” on page 227 226 HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008
show tasks Description Shows configured tasks. Input show tasks Output Field Description Task Name Task name Task Type Task type: TakeSnapshot, ResetSnapshot, VolumeCopy Task Status Task status: Ready, Active Example Show configured tasks for the system.
show users Description Shows configured user profiles. Input show users Output Field Description Username User name Access Level • Monitor: View-only access to selected user interfaces • Manage: Modify access to selected user interfaces User Type Applies to the WBI only.
Related Commands ■ ■ ■ ■ “create user” on page 63 “delete user” on page 82 “set user” on page 151 “show users” on page 228 Chapter 3 Command Descriptions 229
show vdisks Description Shows information for all or specific virtual disks. Input show vdisks [vdisks] Parameter Description vdisks Optional. Specifies the virtual disks by name or serial number. For the syntax to use, see “Virtual Disk Syntax” on page 26. If this parameter is omitted, information is shown for all virtual disks.
Field Description Stat • CRIT: The vdisk is online, however some drives are down and the vdisk is not fault tolerant • FTDN: The vdisk is online and fault tolerant, however some of the drives are down • FTOL: The vdisk is online and fault tolerant • OFFL: The vdisk is offline either because of initialization or because drives are down and data may be lost • QRCR: The vdisk is in a critical state and has been quarantined because some drives are missing • QROF: The vdisk is offline and has been quarantined
show versions Alias for versions. See “versions” on page 247.
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. Input show volumecopy-status [controller a|b] Parameter Description controller a|b Optional. Shows volume copy operations for volumes owned by controller A or controller B only. If this parameter is omitted, all volume copy operations are shown.
Example Show information about volume copies in progress for controller A.
show volume-maps Description Shows mapping information for a specified volume or for all volumes. Input show volume-maps [volume] Parameter Description volume Optional. Specifies the volume by its name or serial number. For the syntax to use, see “Volume Syntax” on page 26. If this parameter is omitted, information for all volumes is shown. Output Field Description SN Volume serial number. Name Volume name. CH Host ports that the volume is mapped on. ID FC and iSCSI only.
Example On a SAS system, show the mappings for volume V1. # show volume-maps V1 Volume [SN 00c0ff0a43180048517e054501000000, Name (V1)] mapping view: CH LUN Access Host-Port-Identifier Nickname -----------------------------------------------------------------------A1,B1 5 rw 0123456789AAABBB Host1 A0,B0 6 ro 0123456789AAACCC Host2 Success: Command completed successfully On an FC system, show the mappings for volume V1.
show volumes Description Shows volume information for all or specified virtual disks. Input show volumes [vdisk vdisks] [class standard|ptsnap] [type snap-pool|mastervolume|snapshot|standard] Parameter Description vdisk vdisks Optional. Specifies the virtual disks by name or serial number. For the syntax to use, see “Virtual Disk Syntax” on page 26. class standard|ptsnap Optional. Specifies the class of volumes to show. type snap-pool| mastervolume| snapshot|standard Optional.
Field Description Type • standard: Standard volume • standard*: Destination of an in-progress volume copy and cannot be mounted until the copy is complete • snap-pool: Snap-pool volume • mastervol: Master volume • snapshot: Snapshot volume • unknown: Unknown Example Show volume information for standard volumes only. # show volumes type standard Vdisk Volume Name Size WR Policy Class Volume Serial Number Cache Opt Type ----------------------------------------------------------VD1 V1 10.
Related Commands ■ ■ ■ ■ ■ ■ “create volume” on page 68 “delete volume” on page 86 “expand volume” on page 92 “set volume” on page 155 “show vdisks” on page 230 “show volume-maps” on page 235 Chapter 3 Command Descriptions 239
shutdown Description Cleanly shuts down the RAID controller in either or both controller modules. This ensures that any data in the controller's write-back cache is written to disk. When both RAID controllers are shut down, hosts cannot access the system's data. Perform a shut down before removing a controller module or powering down the system. Caution – You can continue to use the CLI when either or both RAID controllers are shut down, but information shown might be invalid.
stty Description Sets and shows terminal information. Input stty info | hardwrap | rows # | columns # Parameter Description info Shows current information about the terminal hardwrap Toggles the hard wrapping of output. Terminals usually wrap at the screen width without truncating output, but turning on hard wrapping ensures this. rows # Specifies 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.
trust Description Enables an offline virtual disk to be brought online for emergency data collection only. It 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. The trust command re-synchronizes the time and date stamp and any other metadata on a bad disk drive. This makes the disk drive an active member of the virtual disk again.
Input To enable the trust command: trust enable To trust a virtual disk: trust vdisk vdisk Parameter Description enable Enables the trust command before use vdisk vdisk Specifies the virtual disks by name or serial number. For the syntax to use, see “Virtual Disk Syntax” on page 26. Example Enable the trust command and then trust virtual disk VD1. # trust enable Trust Virtual-disk Enabled. # trust vdisk VD1 Are you sure? yes Virtual-disk VD1 has been trusted.
unmap volume Description Removes an explicit mapping whose settings override a volume’s default mapping. When the explicit mapping is removed, host access to the volume is controlled by the volume’s default mapping (described in “map volume” on page 94). Input unmap volume volume [host host] Parameter Description volume Specifies the volume by its name or serial number. For the syntax to use, see “Volume Syntax” on page 26. host host Optional.
Related Commands ■ ■ ■ ■ ■ “map volume” on page 94 “show host-maps” on page 188 “show host-wwn-names” on page 194 “show volumes” on page 237 “show volume-maps” on page 235 Chapter 3 Command Descriptions 245
verify vdisk Description For specified RAID 3, 5, 6, and 50 virtual disks, this command verifies all parity blocks. For specified RAID 1 and 10 virtual disks, this command compares the primary and secondary drives. The verification process ensures that the redundancy data in the virtual disk is consistent with the user data in the virtual disk. The number of inconsistencies found is noted in the “Vdisk verification complete” event (event code 21) in the event log.
versions Description Shows the hardware and software versions for each controller module.
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 virtual disk 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.
Parameter Description 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. If this parameter is omitted for a snapshot, modified snapshot data is excluded. volume2 Specifies a name for the volume to create on the destination vdisk.
HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008
CH A P T E R 4 Troubleshooting Using the CLI This appendix briefly describes CLI commands that are useful for troubleshooting storage system problems, and it includes other troubleshooting topics.
Viewing Command Help To view brief descriptions of all commands that are available to the user level you logged in as, type: # help To view help for a specific command, type either: # help command # command ? To view information about the syntax to use for specifying disk drives, virtual disks, volumes, and volume mapping, type: # help syntax clear cache Clears any unwritable cache in both RAID controllers for a specified volume, or any orphaned data for volumes that no longer exist.
ping Tests communication with a remote host. The remote host is specified by IP address. Ping sends ICMP echo response packets and waits for replies. For details see “ping” on page 97. rescan When installing a system with drive enclosures attached, the enclosure IDs might not agree with the physical cabling order. This is because the controller might have been previously attached to some of the same enclosures and it attempts to preserve the previous enclosure IDs if possible.
Note – If an iSCSI storage system is connected to a Microsoft Windows host, the following event is recorded in the Windows event log: Initiator failed to connect to the target. For details see “restart” on page 101. restore defaults Note – This command should only be used by service technicians, or with the advice of a service technician. Restores the manufacturer's default configuration to the controllers.
set expander-fault-isolation When fault isolation is enabled, the Expander Controller will isolate PHYs that fail to meet certain criteria. When fault isolation is disabled, the errors are noted in the logs but the PHYs are not isolated. Note – This command should be used only by service technicians, or with the advice of a service technician. For details see “set expander-fault-isolation” on page 125. set expander-phy The Expander Controller will enable or disable (isolate) the a specific PHY.
set protocols Enables or disables one or more of the following management services and protocols.
show enclosure-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. For details see “show enclosure-status” on page 178. show events 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 module.
show protocols Shows which management services and protocols are enabled or disabled. For details see “show protocols” on page 207. show redundancy-mode Shows the redundancy status of the system. For details see “show redundancy-mode” on page 208. trust Enables an offline virtual disk to be brought online for emergency data collection only. It 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.
Problems Scheduling Tasks There are two parts to scheduling tasks: you must create the task and then create the schedule to run the task. Create the Task There are three tasks you can create: TakeSnapshot, ResetSnapshot, and VolumeCopy. Perform the operation directly to ensure the command syntax is correct. For example, if you want to schedule taking a snapshot, first issue a command to take the snapshot and verify that it runs. Then create a task that will take the snapshot when scheduled.
Errors Associated with Scheduling Tasks The following table describes error messages associated with scheduling tasks. Table 4-1 Errors Associated with Scheduling Tasks Error Message Solution Task Already Exists Select a different name for the task. Unknown Task Type The task type is misspelled. Valid task types are: TakeSnapshot, ResetSnapshot and VolumeCopy. Schedule Already Exists Select a different name for the schedule.
Glossary The glossary defines terms and acronyms used in MSA2000 Family storage system documentation. Definitions obtained from the Storage Networking Industry Association (SNIA) Dictionary are indicated with “(SNIA)” at the end. For the complete SNIA Dictionary, go to www.snia.org/education/dictionary. active-active Synonym for dual active components or controllers.
cache The location in which data is stored temporarily. There are a variety of cache types. Read cache holds data in anticipation that it will be requested. Write cache holds data written by a client until it can be stored on other (typically slower) storage media such as disk or tape. (SNIA) See also write-back cache, write-through cache.
controller enclosure controller module copy-on-write (COW) An enclosure that contains disk drives and one or two controller modules. See controller module. A FRU that contains: a Storage Controller processor; a Management Controller processor; a SAS expander and Expander Controller processor; management interfaces; a LAN subsystem; cache protected by a capacitor pack and Compact Flash memory; host, expansion, management, and service ports; and midplane connectivity.
data mirroring Data written to one disk drive is simultaneously written to another disk drive. If one disk fails, the other disk can be used to run the virtual disk and reconstruct the failed disk. The primary advantage of disk mirroring is 100 percent data redundancy: since the disk is mirrored, it does not matter if one of the disks fails; both disks contain the same data at all times and either can act as the operational disk.
enclosure management processor (EMP) Ethernet adapter Expander Controller (EC) expansion module fabric fabric switch An Expander Controller subsystem that provides data about an enclosure’s environmental conditions such as temperature, power supply and fan status, and the presence or absence of disk drives. An adapter that connects an intelligent device to an Ethernet network. Usually called an Ethernet network interface card, or Ethernet NIC.
fault-tolerant virtual disk FC FC-AL Fibre Channel (FC) Fibre ChannelArbitrated Loop (FC-AL) field-replaceable unit (FRU) FRU 266 A virtual disk that provides protection of data in the event of a single disk drive failure by employing RAID 1, 3, 5, 6, 10, or 50. RAID 6 also provides protection against the failure of two drives. See Fibre Channel (FC). See Fibre Channel-Arbitrated Loop (FC-AL).
host bus adapter (HBA) host port host port interconnect hot swap in-band management An adapter that connects a host I/O bus to a computer’s memory system. Host bus adapter is the preferred term in SCSI contexts. Adapter and NIC are the preferred terms in Fibre Channel contexts. The term NIC is used in networking contexts such as Ethernet and token ring. (SNIA) A host-interface port on a controller module or an expansion module.
I/O module (IOM) IP IQN iSCSI iSNS JBOD jumbo frame Kbyte (KB) LAN leftover drive local area network (LAN) logical unit number (LUN) See controller module and expansion module. Internet Protocol. ISCSI Qualified Name. Internet Small Computer System Interface. Internet Storage Name Service. Just a Bunch of Disks. A drive enclosure that is directly attached to a host. In an iSCSI network, a frame that can contain 9000 bytes for large data transfers. A normal frame can contain 1500 bytes. Kilobyte.
management host management information base (MIB) master volume Mbyte MC metadata MIB network interface card (NIC) Network Time Protocol (NTP) NIC node WWN Non-RAID NTP originator A workstation with direct or network connections to a storage system’s management ports and that is used to manage the system. A database of managed objects accessed by network management protocols.
out-of-band management ownership PHY PID point-to-point port bypass circuit (PBC) port WWN power-and-cooling module In an active-active configuration, one controller has ownership of the following resources: virtual disks and vdisk spares. When a controller fails, the other controller assumes temporary ownership of its resources. Hardware component that converts between digital and analog in the signal path between the Storage Controller, Expander Controller, disk drives, and SAS ports.
RAS Reliability, availability, and serviceability. These headings refer to a variety of features and initiatives all designed to maximize equipment uptime and mean time between failures, minimize downtime and the length of time necessary to repair failures, and eliminate or decrease single points of failure in favor of redundancy.
SCSI Enclosure Services (SES) An ANSI X3T10 standard for management of environmental factors such as temperature, power, voltage, etc. (SNIA) In MSA2000 Family storage systems, SES data is managed by the Expander Controller and EMP. secret SFP Small form-factor pluggable connector, used in FC controller module host ports. An SFP is a FRU. SID Secondary controller identifier number. SMART Self-Monitoring Analysis and Reporting Technology.
standard volume standby state Storage Area Network (SAN) Storage Controller (SC) storage system A volume that is not enabled for snapshots. See spare. The current operational status of a disk drive, a virtual disk, or controller. A controller module stores the states of drives, virtual disks, and the controller in its nonvolatile memory. This information is retained across power interruptions.
ULP UT Universal Time. A modern time system related to the conventional Greenwich Mean Time (GMT) used for time zones. UPS Uninterruptible Power Supply. vdisk Abbreviation for virtual disk. vdisk spare A disk drive that is marked as a spare to support automatic data rebuilding after a disk drive associated with a virtual disk fails.
world wide name (WWN) A unique 64-bit number assigned by a recognized naming authority (often via block assignment to a manufacturer) that identifies a node process or node port. (SNIA) MSA2000 Family storage systems derive WWNs from the serial numbers of controller modules and expansion modules. world wide node name (WWNN) world wide port name (WWPN) write policy write-back cache A globally unique 64-bit identifier assigned to each Fibre Channel node process.
HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008
Index A aliases, manage, 42 array, See system B base for calculations set, 118 show setting, 164 C cache clearing, 252 cache optimization mode description, 111 set, 110 show setting, 157 cache parameters set, 110 show settings, 157 cache policy description, 110 set, 110 set write-through triggers, 107 show setting, 157 show write-through trigger settings, 156 cache read-ahead size description, 111 cache, clear, 44 Challenge-Authentication Handshake Protocol, See CHAP channels issue LIP to reset link, 99 s
show, 168 controller redundancy mode, showing, 258 D date, controller set, 120 show, 168 debug log viewing, 256 debug log parameters setting, 254 viewing, 256 debug log parameters, show settings, 172 debug logs, show, 169 debug parameters, set, 122 default configuration settings, restore, 103 default configuration settings, restoring, 254 default LUN, 94 default mapping, 94 disk drive abort search for defects, 39 add to virtual disk, 90 locate, 138 scan for changes, 98 search for defects, 106 show, 174 syn
show, 206 show nickname, 194 host, map volume to, 94 host, test communication with, 97 I ICPM.
P paging of output set, 118 show setting, 164 parameter syntax, 25 parity abort verification, 40 verify virtual disk, 246 password, set for user interfaces, 141 ping host to test communication, 97 pinging a remote host, 253 port interconnects, See host port interconnects port WWNs, show, 206 priority for all jobs set, 137 show, 198 prompt, set CLI, 142 protocols enable/disable, 143 show status, 207 protocols, service and security enabling or disabling, 256 showing status of, 258 R redundancy mode, show, 20
timeout for session set, 118 show setting, 164 topology, show FC, 159 triggers for automatic write-through set, 107 show settings, 156 trust an offline virtual disk for emergency data collection, 242 trusting an offline virtual disk, 258 U ULP, 157, 208 users create, 63 delete, 82 modify, 151 show, 228 V vdisk spare delete, 83, 85 set, 154 vdisk, See also virtual disk versions, show hardware and software, 247 virtual disk abort creation of, 38 abort scrub, 39 abort verification, 40 add disk drives, 90 bri
HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008