HP 2000fc Cli Reference Manual
HP 2000fc Cli Reference Manual

HP 2000fc Cli Reference Manual

Modular smart array
Hide thumbs Also See for 2000fc:
Table of Contents

Advertisement

HP StorageWorks
2000 Family Modular Smart Array
CLI reference guide
Part number: 481600-002
Second edition: May 2008

Advertisement

Table of Contents
loading

Summary of Contents for HP 2000fc

  • Page 1 HP StorageWorks 2000 Family Modular Smart Array CLI reference guide Part number: 481600-002 Second edition: May 2008...
  • Page 2 © 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.
  • Page 3: Table Of Contents

    Contents About This Guide ..........11 Intended Audience .
  • Page 4 Command Completion, Editing, and History ......28 Viewing Command Help ..........29 Size of Devices and Logical Units .
  • Page 5 create host-wwn-name ..........52 create iscsi-host .
  • Page 6 expand vdisk ............90 expand volume .
  • Page 7 set led ............138 set network-parameters .
  • Page 8 show host-maps ........... 188 show host-parameters .
  • Page 9 show volume-maps ..........235 show volumes .
  • Page 10 show frus ............257 show protocols .
  • Page 11: About This Guide

    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 ■...
  • Page 12: Document Conventions

    Document Conventions Typeface Meaning Examples AaBbCc123 Book title, new term, or See the user guide emphasized word A virtual disk (vdisk) can ... You must ... Directory or file name, The default file name is store.logs AaBbCc123 value, command, or The default user name is manage on-screen output Type exit...
  • Page 13: Hp Technical Support

    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 ■...
  • Page 14: Subscription Service

    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...
  • Page 15: Using The Cli

    CH A P T E R 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 ■...
  • Page 16: Operation Modes

    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 single- operation mode is known as interactive mode. The following example shows interactively starting a session, logging into telnet...
  • Page 17 The following example shows the Perl Expect script that starts a showfree.exp session, logs into the CLI, executes a command to show free disks, and telnet 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...
  • Page 18 The example below and continuing on the next page shows how to construct a script using a Perl library for communication. telnet use Net::Telnet; $mVer = "v.072006"; $mLine = "=========================================================="; $mStr = "Management Controller System Cloning Utility"; $nLine = "\n"; $cliDumpFile = "get_config_dump.txt";...
  • Page 19: Using The Xml Api

    The example shows a Perl script for logging in. is called at the start of the cLogin 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.
  • Page 20: Dtd

    The following is Revision 1 of the DTD. Elements and attributes are described in the table on the following page. <!ATTLIST OBJECT oid ID #REQUIRED name CDATA #IMPLIED basetype CDATA #IMPLIED > <!--- Property definition --> <!ELEMENT PROPERTY (#PCDATA)> <!ATTLIST PROPERTY display-name CDATA #IMPLIED draw (true|false) #IMPLIED size CDATA #IMPLIED...
  • Page 21 Elements and attributes of the DTD are described in the following table. Element Description and Attributes The RESPONSE is the top level XML object. The request attributes RESPONSE contain the details of the request that was sent. The RESPONSE is a container for objects that are returned as part of the request.
  • Page 22: Example

    Element Description and Attributes 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 and second set to console set cli-parameters console...
  • Page 23 # set cli-parameters api <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <RESPONSE request="cli-parameters"> <OBJECT name="status" oid="1"> <PROPERTY name="success" type="string" size="77" draw="true" display-name= "Success">CL I parameter changed successfully</PROPERTY> <PROPERTY name="return-code" type="int32" size="5" draw="false" display- name="Return C ode">0</PROPERTY> </OBJECT> </RESPONSE> #show schedule-details Sched1 <?xml version="1.0"?> <!DOCTYPE RESPONSE SYSTEM "DHXML.dtd">...
  • Page 24 <PROPERTY name="master-volume-serial" type="string" size="32" draw="true" display-name="Master Volume Serial">00c0ff0a43010048f9ca2d4601000000</PROPERTY> <PROPERTY name="snapshot-prefix" type="string" size="14" draw="true" display-name="Snapshot Prefix">ss</PROPERTY> <PROPERTY name="retention-count" type="string" size="5" draw="true" display-name="Retention Count">3</PROPERTY> <PROPERTY name="last-created" type="string" size="32" draw="true" display- name="Last Snapshot Created">none</PROPERTY> <PROPERTY name="error-message" type="string" size="100" draw="true" display-name="Error Message">none</PROPERTY> </OBJECT> </RESPONSE> HP StorageWorks 2000 Family Modular Smart Array CLI reference guide •...
  • Page 25: Command Syntax

    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 ■...
  • Page 26: Virtual Disk Syntax

    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.
  • Page 27: Host Nickname Syntax

    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. "...
  • Page 28: Command Completion, Editing, And History

    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.
  • Page 29: Viewing Command Help

    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: command # help 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...
  • Page 30: Event Log

    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.
  • Page 31: Command Categories

    CH A P T E R 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.
  • Page 32: Virtual Disks And Disk Drives

    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 ■...
  • Page 33: Snapshots

    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 ■...
  • Page 34: Event Notification

    Event Notification clear event ■ set snmp-parameters ■ show events ■ show snmp-parameters ■ Configuration and Utilities alias ■ clear cache ■ create chap-record ■ delete chap-records ■ ping ■ reset host-channel-link ■ restart ■ set auto-write-through-trigger (alias: set awt) ■...
  • Page 35: Service Utilities

    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 ■...
  • Page 36 HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008...
  • Page 37: Command Descriptions

    CH A P T E R 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. ■...
  • Page 38: Abort Create

    abort create Description Stops the operation for a virtual disk being initialized online or create vdisk 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...
  • Page 39: Abort Scrub

    abort scrub Description Aborts the operation for specified virtual disks. scrub vdisk 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.
  • Page 40: Abort Verify

    abort verify Description Aborts the operation for specified virtual disks. verify vdisk 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.
  • Page 41: Abort Volumecopy

    abort volumecopy Description Aborts copying a volume. When the abort is complete, the destination volume is deleted. Input abort volumecopy volume Parameter Description Specifies the name or serial number of either the source or the volume destination volume. For the syntax to use, see “Virtual Disk Syntax”...
  • Page 42: Alias

    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 Optional.
  • Page 43 Show existing aliases. # alias show events last 3 show disks Success: Command completed successfully Run alias # 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.
  • Page 44: Clear Cache

    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”...
  • Page 45: Clear Disk-Metadata

    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.
  • Page 46: Clear Event

    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.
  • Page 47: Clear Expander-Status

    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 as shown by the command.
  • Page 48: Convert Master-To-Std

    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...
  • Page 49: Convert Std-To-Master

    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.
  • Page 50: Create Chap-Record

    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).
  • Page 51 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.domain Related Commands “delete chap-records” on page 72 ■ “set chap-record”...
  • Page 52: Create Host-Wwn-Name

    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...
  • Page 53: Create Iscsi-Host

    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 Specifies an iSCSI host initiator’s node name. This is typically the name name initiator’s IQN (iSCSI Qualified Name).
  • Page 54: Create Master-Volume

    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...
  • Page 55 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...
  • Page 56: Create Schedule

    create schedule Description Schedules a task to run automatically. Input " " create schedule sname schedule-specification specification task-name tname Parameter Description Specifies a name for the new schedule, using a maximum sname of 32 characters and no quotation mark (") or backslash (\) characters.
  • Page 57 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 schedule Sched1 schedule-specification "start 3/1/2007 00:01 AM, every 1 days, between 12:00 AM and 1:00 AM, expires 1/1/2008 1:00 AM"...
  • Page 58: Create Snap-Pool

    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 Specifies the virtual disk by name or serial number. For the vdisk vdisk syntax to use, see “Virtual Disk Syntax”...
  • Page 59: Create Snapshots

    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. Specifies a comma-separated list of names for the snap-names resulting snapshot volumes.
  • Page 60: Create Task

    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 –...
  • Page 61 Parameter Description Specifies the task. type TakeSnapshot| • TakeSnapshot: Takes a snapshot of a specified ResetSnapshot| master volume. VolumeCopy • 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.
  • Page 62 Parameter Description Optional. Specifies whether to include or exclude modified-snapshot modified write data from the snapshot in the copy. yes|no This parameter applies only when the source volume is a snapshot; it is ignored if the source volume is a master volume. •...
  • Page 63: Create User

    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 "...
  • Page 64 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. Success: New user created Related Commands “delete user”...
  • Page 65: Create Vdisk

    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.
  • Page 66 Parameter Description Optional. Specifies the controller to own the assigned-to a|b|auto virtual disk. To have the system automatically load-balance virtual disks between controllers, use auto or omit this parameter. Optional. Specifies up to four vdisk spares to spare disks assign to a RAID 1, 3, 5, 6, 10, or 50 virtual disk. For the syntax to use, see “Disk Drive Syntax”...
  • Page 67 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.
  • Page 68: Create Volume

    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 Parameter Description Specifies the virtual disk by name or serial number.
  • Page 69 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.
  • Page 70: Delete All-Master-Volumes

    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 Specifies the snap pool volume by its name or serial number. snap-pool volume For the syntax to use, see “Volume Syntax”...
  • Page 71: Delete All-Snapshots

    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...
  • Page 72: Delete Chap-Records

    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...
  • Page 73: Delete Global-Spare

    delete global-spare Description Removes one or more disk drives from the pool of global spares. Input delete global-spare disks disks Parameter Description Specifies the disk drives to remove. For the syntax to use, see “Disk disks disks Drive Syntax” on page 25. Example Remove the global spare having ID 5 in the controller enclosure.
  • Page 74: Delete Host-Wwn-Name

    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 Specifies the HBA’s nickname or 16-hex-digit WWPN. For the host nickname syntax to use, see “Host Nickname Syntax” on page 27. Example Delete the nickname MyHost.
  • Page 75: Delete Iscsi-Host

    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 Specifies an iSCSI host initiator's node name, or an existing nickname. host For the nickname syntax to use, see “Host Nickname Syntax” on page 27.
  • Page 76: Delete Master-Volume

    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 Specifies the volume by its name or serial number. For the syntax to use, volume see “Volume Syntax”...
  • Page 77: Delete Schedule

    delete schedule Description Deletes a specified task schedule. Input delete schedule schedule Parameter Description Specifies the schedule name. schedule Example Delete schedule Sched1. # delete schedule Sched1 Success: Schedule Deleted Related Commands “show schedule-details” on page 210 ■ “show schedules” on page 212 ■...
  • Page 78: Delete Snap-Pool

    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 Specifies the snap pool volume by its name or serial number. For the volume syntax to use, see “Volume Syntax”...
  • Page 79: Delete Snapshot

    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 Specifies the volume by its name or serial number. For the syntax to use, volume “Volume Syntax”...
  • Page 80: Delete Snapshot-Write-Data

    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 Specifies the volume by its name or serial number. For the syntax to use, volume “Volume Syntax”...
  • Page 81: Delete Task

    delete task Description Deletes a specified task. If the task is scheduled, you must delete the schedule first. Input delete task task Parameter Description Specifies the task name. task Example Delete task Task1. # delete task Task1 Success: Task Deleted Related Commands “delete schedule”...
  • Page 82: Delete User

    delete user Description Deletes a user profile. By default a confirmation prompt appears, which requires a response. You can delete any user including the default users. Input delete user name [noprompt] Parameter Description Specifies the user profile to delete. Names are case sensitive. name noprompt Optional.
  • Page 83: Delete Vdisk

    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. Deleting a virtual disk will delete all data on that virtual disk. Caution –...
  • Page 84 Related Commands “show master-volumes” on page 200 ■ “show vdisks” on page 230 ■ HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008...
  • Page 85: Delete Vdisk-Spare

    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 Specifies the vdisk spares to remove. For the syntax to use, see disks disks “Disk Drive Syntax”...
  • Page 86: Delete Volume

    delete volume Description Deletes a volume. Input delete volume volume Parameter Description Specifies the volume to delete. For the syntax to use, see “Volume volume Syntax” on page 26. Example Delete volume V1. # delete volume V1 Success: deleted volume V1 Related Commands “show volumes”...
  • Page 87: Exit

    exit Description Logs off and exits the CLI session. Syntax exit Chapter 3 Command Descriptions...
  • Page 88: Expand Snap-Pool

    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:...
  • Page 89 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...
  • Page 90: Expand Vdisk

    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 Maximum RAID Level Expansion Capability Drives NRAID (non-RAID) Cannot expand. 0, 3, 5, 6 You can add 1–4 drives at a time.
  • Page 91 Example Expand virtual disk VD1 to include the disk drive having ID 11 in the controller enclosure. # expand vdisk VD1 disks 0.11 Related Commands “show disks” on page 174 ■ “show vdisks” on page 230 ■ Chapter 3 Command Descriptions...
  • Page 92: Expand Volume

    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 –...
  • Page 93 Example Expand V1 by 100 Gbyte. # expand volume V1 size 100GB Success: expanded volume V1 Related Commands “expand vdisk” on page 90 ■ “show snap-pools” on page 216 ■ “show vdisks” on page 230 ■ “show volumes” on page 237 ■...
  • Page 94: Map Volume

    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.
  • Page 95 Parameter Description Optional. For FC and SAS, this specifies the host’s nickname host host 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.
  • Page 96 Related Commands “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...
  • Page 97: Ping

    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 Specifies the remote host’s IP address in dotted decimal form. host-address Optional.
  • Page 98: Rescan

    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.
  • Page 99: Reset Host-Channel-Link

    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 Specifies a host port number or a comma-separated list channel channels of host port numbers such as 0,1.
  • Page 100: Reset Snapshot

    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;...
  • Page 101: Restart

    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.
  • Page 102 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.
  • Page 103: Restore Defaults

    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.
  • Page 104: Rollback Master-Volume

    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.
  • Page 105 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.
  • Page 106: Scrub Vdisk

    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.
  • Page 107: Set Auto-Write-Through-Trigger

    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. Input set auto-write-through-trigger [controller-failure enable|disable] [super-cap-failure enable|disable] [compact-flash-failure enable|disable] [power-supply-failure...
  • Page 108 Parameter Description Specify whether to notify the partner controller that partner-notify a trigger condition occurred. Enable this option to enable|disable 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.
  • Page 109: Set Awt

    set awt Alias for . See “set auto-write-through- set auto-write-through-trigger trigger” on page 107. Chapter 3 Command Descriptions...
  • Page 110: Set Cache-Parameters

    set cache-parameters Description Sets cache options for a specific volume, or the cache redundancy mode for a dual- controller storage system. Only change cache settings if you fully understand how your operating Note – system, application, and HBA move data so that you can adjust the settings accordingly.
  • Page 111 Cache Optimization Mode Before creating or modifying a volume, determine the appropriate cache optimization mode. The controller supports optimization super-sequential mode for sequential I/O and optimization mode for random I/O. standard 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.
  • Page 112 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;...
  • Page 113 To set the cache redundancy mode for the storage system: set cache-parameters independent enable|disable Parameter Description Specifies the volume by its name or serial volume number. For the syntax to use, see “Volume Syntax” on page 26. Optional. Sets the cache policy to either: write-policy write-back| write-through •...
  • Page 114 Parameter Description Optional. Controls the use and size of read- read-ahead-size ahead cache: disable|default|maximum| 64KB|128KB|256KB|512KB| • disable: Turns off read-ahead cache. 1MB|2MB|4MB|8MB|16MB|32MB 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.
  • Page 115 Parameter Description Sets the cache redundancy mode for a dual- independent enable|disable controller 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.
  • Page 116: Set Chap-Record

    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 Specifies the originator name, which is typically the name originator- originator's IQN.
  • Page 117 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...
  • Page 118: Set Cli-Parameters

    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.
  • Page 119 Parameter Description Optional. Sets the format in which drive IDs are disk-addressing shown and must be specified. enclosure-slot| channel-id • enclosure-slot: Drives are shown, and must be specified, with the format enclosure- ID.drive-slot-number. This is the default. For example, the first drive in the second enclosure (enclosure ID 1) has address 1.0.
  • Page 120: Set Controller-Date

    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] Parameter Description Specifies the month. jan|feb|mar|apr|may|jun |jul|aug|sep|oct|nov|dec Specifies the day number (1–31).
  • Page 121 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.3 Success: Command completed successfully...
  • Page 122: Set Debug-Log-Parameters

    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 ( "...
  • Page 123 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) •...
  • Page 124: Set Drive-Parameters

    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...
  • Page 125: Set Expander-Fault-Isolation

    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.
  • Page 126 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.
  • Page 127: Set Expander-Phy

    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 Specifies the port WWN (WWPN) of the enclosure wwn enclosure-wwn...
  • Page 128 Example Disable the first egress PHY in both controllers in an enclosure, after determining the PHY index; then verify the PHY’s status. # show expander-status Encl Phy Type Status ------------------------------------- DRIVE <= Index 0 DRIVE DRIVE DRIVE DRIVE DRIVE DRIVE DRIVE DRIVE DRIVE...
  • Page 129: Set Global-Spare

    set global-spare Description Designates spare disk drives that can be used by any virtual disk. Sets the disk drive status to . For the command to succeed, you must specify disk global-spare drives that are large enough to protect existing virtual disks. You can designate a maximum of eight global spares for the system.
  • Page 130: Set Host-Parameters

    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] Parameter Description Optional.
  • Page 131 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.
  • Page 132: Set Host-Port-Interconnects

    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.
  • Page 133: Set Host-Wwn-Name

    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 Specifies an existing 16-hex-digit WWPN or an existing port host host nickname.
  • Page 134: Set Iscsi-Host

    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 Specifies an iSCSI host initiator’s node name or an existing host host nickname. For the nickname syntax to use, see “Host Nickname Syntax”...
  • Page 135: Set Iscsi-Parameters

    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 Enables or disables use of Challenge Handshake chap enabled|disabled Authentication Protocol. Disabled by default. Enables or disables support for jumbo frames.
  • Page 136 Related Commands “show iscsi-parameters” on page 196 ■ HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008...
  • Page 137: Set Job-Parameters

    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] [utility- priority low|medium|high] Parameter Description Optional. Controls whether vdisks are checked background-scrub for disk drive defects to ensure system health. enabled|on|disabled|off Optional.
  • Page 138: Set Led

    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 Specifies a disk drive number. For the syntax to use, see “Disk disk ID Drive Syntax”...
  • Page 139: Set Network-Parameters

    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.
  • Page 140 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.1 controller a Success: Network parameters have been changed Related Commands “show network-parameters” on page 202 ■...
  • Page 141: Set Password

    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.
  • Page 142: Set Prompt

    set prompt Description Sets the prompt for the current CLI session. Input set prompt prompt Parameter Description Specifies the new prompt string, which can include 0–7 characters. A prompt string that includes a space must be enclosed in quotation marks ("). Output Command line with new prompt.
  • Page 143: Set Protocols

    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 Optional. Enables or disables the in-band CAPI capi management interface.
  • Page 144 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. Related Commands “show protocols” on page 207 ■ HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008...
  • Page 145: Set Snap-Pool-Policy

    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 . A snap pool's default error policy is notifyonly and default critical policy is deleteoldestsnapshot...
  • Page 146 Parameter Description Specifies the increment in MB (Mbyte), autoexpansionsize GB (Gbyte), or TB (Tbyte) by which the sizeMB|GB|TB 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);...
  • Page 147: Set Snap-Pool-Threshold

    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.
  • Page 148 Related Commands “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...
  • Page 149: Set Snmp-Parameters

    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 Optional. Sets the level of trap notification: enable crit|warn|info |none • crit: Sends critical events only. • warn: Sends all critical events and warnings. •...
  • Page 150: Set System

    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]...
  • Page 151: Set User

    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 Specifies the user profile to change. Names are case name sensitive.
  • Page 152 Example Change a user’s type and interface access. # set user type advanced interfaces wbi,cli jsmith Success: User-Type set to advanced. Success: Command completed successfully Related Commands “create user” on page 63 ■ “delete user” on page 82 ■ “set password” on page 141 ■...
  • Page 153: Set Vdisk

    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.
  • Page 154: Set Vdisk-Spare

    set vdisk-spare Description Designates spare disk drives that can be used by a specific virtual disk, and sets the disk drive status to . A vdisk spare can be assigned to RAID 1, 3, 5, 6, VDISK SP 10, and 50 virtual disks, and must have enough capacity to replace the smallest disk drive in the virtual disk.
  • Page 155: Set Volume

    set volume Description Changes the name of a volume. Input set volume volume name new-name Parameter Description Specifies the volume by its name or serial number. For the volume 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”...
  • Page 156: Show Auto-Write-Through-Trigger

    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.
  • Page 157: Show Cache-Parameters

    show cache-parameters Description Shows cache settings for the storage system and optionally for a specified volume. Input show cache-parameters [volume] Parameter Description Optional. Specifies the volume by its name or serial number. For the volume syntax to use, see “Volume Syntax” on page 26. If this parameter is not specified, the volume-specific data is not displayed.
  • Page 158 Field Description If a volume is specified, its cache policy, either write-back or Write Mode write-through If a volume is specified, its cache optimization mode, either Optimization standard (random) or super-sequential If a volume is specified, its read-ahead cache setting Read Ahead Size Example On a SAS system, show the cache parameters for the system and for volume V1.
  • Page 159: Show Channels

    show channels Description Shows information about host and expansion ports on both controllers. Input show channels Output Field Description Controller ID Ctlr Port number • Host: Host port Type • Drive: Expansion port • FC(P): Fibre Channel Point-to-Point Media • FC(L): Fibre Channel-Arbitrated Loop •...
  • Page 160 Example Show port information for a dual-controller SAS storage system. # show channels Ctlr Ch Type Media Topo(C) Speed(A) Speed(C) Status PID SID ---------------------------------------------------------------- Host Direct Down N/A N/A Host Direct Down N/A N/A Drive SAS N/A N/A Host Direct Down N/A N/A Host...
  • Page 161 Show port information for a dual-controller iSCSI storage system. # show channels Ctlr Ch Type Media Speed(A) Status IP-Ver PIP ---------------------------------------------------------------- Host iSCSI 1Gb IPv4 10.11.10.4 A8:A5:00:00:00:09 Host iSCSI 1Gb IPv4 10.10.10.5 A8:A5:00:00:00:08 Drive SAS Host iSCSI 1Gb IPv4 10.11.10.2 00:C0:FF:0A:8A:53 Host iSCSI 1Gb...
  • Page 162: Show Chap-Records

    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 Optional. Specifies the originator name, which is name originator-name typically the originator’s IQN.
  • Page 163 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.00c0ffd6000a Mutual CHAP Secret: ABCdef123456 Related Commands “create chap-record” on page 50 ■ “delete chap-records” on page 72 ■...
  • Page 164: Show Cli-Parameters

    show cli-parameters Description Shows the current CLI settings. Input show cli-parameters Output Field Description Timeout value, in seconds, for the login session. Timeout • console: Output is shown in human-readable console Output Format format. • api: Output is shown in XML format. •...
  • Page 165 Example Show current CLI settings. # show cli-parameters Timeout: 1800 Output Format: console Base: 10 Pager: enabled Disk Addressing Mode: enclosure-slot Related Commands “set cli-parameters” on page 118 ■ Chapter 3 Command Descriptions...
  • Page 166: Show Configuration

    show configuration Description Shows system configuration information. Input show configuration Output Category Fields System information See “show system” on page 222. Controller information • Serial Number • Hardware Version • CPLD Version • MAC Address • Node WWN • IP Address •...
  • Page 167 Category Fields Virtual disk information See “show vdisks” on page 230. Enclosure status information, See “show enclosure-status” on page 178. including SCSI Enclosure Services (SES) data Field-replaceable unit (FRU) See “show frus” on page 186. information Chapter 3 Command Descriptions...
  • Page 168: Show Controller-Date

    show controller-date Description Shows the system’s current date and time. Input show controller-date Output Field Description Date and time Controller Date 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.
  • Page 169: Show Debug-Log

    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.
  • Page 170 Parameter Description Optional. Specifies the number of sem-entries semaphore log entries to show. If this parameter is omitted, all semaphore log entries are shown. Specifies to show the MC task status at the task-log time this command is issued. Optional. Specifies the number of task log task-entries entries to show.
  • Page 171 Related Commands “set debug-log-parameters” on page 122 ■ “show debug-log-parameters” on page 172 ■ Chapter 3 Command Descriptions...
  • Page 172: Show Debug-Log-Parameters

    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. Input show debug-log-parameters Output...
  • Page 173 Field Description (Continued) RAID debug messages raid cache Cache debug messages Enclosure Management Processor debug messages Internal Configuration API debug messages capi Internal service interface debug messages bkcfg Internal configuration debug messages Auto-write-through feature debug messages Internal debug messages res2 capi2 Internal Configuration API tracing debug messages Snapshot feature debug messages fruid FRU ID debug messages...
  • Page 174: Show Disks

    show disks Description Shows information about disk drives in the controller enclosure and any attached drive enclosures. The option shows different fields than the other options and encl shows each slot, whether or not a disk is present. If no parameter is specified, the command shows information for all disk drives.
  • Page 175 Field Description • AVAIL: Disk is available for use in a vdisk State • 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: •...
  • Page 176 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 ---------------------------------------------------------------------- KRVN03ZAG4ZPPD AD1A AVAIL SATA 500 KRVN03ZAGA88PD AD1A VDISK SATA 500 KRVN03ZAG4L22D AD1A VDISK VRSC SATA 500 ---------------------------------------------------------------------- Show information about disk drives, where drive 1 is not inserted.
  • Page 177: Show Drive-Parameters

    show drive-parameters Description Shows the SMART setting. Input show drive-parameters Output Field Description Shows whether SMART is enabled or disabled for all disk drives, or is set SMART to detect-only, which specifies that each new drive inserted in the system retain its current SMART setting.
  • Page 178: Show Enclosure-Status

    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. Input show enclosure-status Output General SES fields: Field Description Chassis serial number Chassis Enclosure vendor name Vendor...
  • Page 179 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. Component status: Status • Absent: Component is not present • Fault: One or more subcomponents has a fault •...
  • Page 180 Example Show status information for a single-enclosure system. # show enclosure-status Chassis Vendor Product ID CPLD WWPN Status ------------------------------------------------------------------------------ 3CL625C401 vendor product 2042 27 500C0FF02424013C ------------------------------------------------------------------------------ Type Status FRU P/N FRU S/N Add'l Data ------------------------------------------------------------------------------ 00 OK 481320-001 3CL625PA01 01 OK 481320-001 3CL626PA02 00 OK...
  • Page 181: Show Events

    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.
  • Page 182 Parameter Description Optional. Shows events before and including the to date 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”...
  • Page 183 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.
  • Page 184: Show Expander-Status

    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 Parameter Description Enclosure that contains the SAS expander Encl...
  • Page 185 Example Show the expander status for all enclosures. # show expander-status Encl Phy Type Status ------------------------------------- DRIVE DRIVE DRIVE DRIVE DRIVE DRIVE DRIVE DRIVE DRIVE DRIVE DRIVE DRIVE INTER-EXP INTER-EXP INTER-EXP INTER-EXP EGRESS EGRESS EGRESS EGRESS ------------------------------------- Related Commands “clear expander-status” on page 47 ■...
  • Page 186: Show Frus

    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. Input show frus Output Field Description FRU name: Name • CHASSIS_MIDPLANE: 2U chassis and midplane; the metal enclosure and the circuit board to which power and cooling, controller, expansion, and drive modules connect •...
  • Page 187 Field Description Location of the FRU in the enclosure, as viewed from the FRU Location 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 •...
  • Page 188: Show Host-Maps

    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 Optional. For FC and SAS this specifies the host's nickname or 16-hex- host digit WWPN. For iSCSI this specifies the iSCSI host initiator’s node name (typically the IQN) or nickname.
  • Page 189 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 ------------------------------------------------------------------------ 00c0ff0a43180048517e054501000000 15 A0,B0 On an FC system, show mappings for host Host1. # show host-maps Host1 Host [WWN 100000A0B8040BAC, Name (Host1)] Mapping View: Volume Name...
  • Page 190: Show Host-Parameters

    show host-parameters Description Shows information about host ports on both controllers. Input show host-parameters Output Field Description Controller ID Ctlr Host port number • Host: Host port Type • FC(P): Fibre Channel Point-to-Point Media • FC(L): Fibre Channel-Arbitrated Loop • SAS: Serial Attached SCSI •...
  • Page 191 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 ---------------------------------------------------------------- Host FC(L) Loop Host FC(L) Loop Host FC(L) Loop Host FC(L) Loop ---------------------------------------------------------------- Show host parameters for a dual-controller SAS storage system. # show host-parameters Ctlr Ch Type Media...
  • Page 192 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.b...
  • Page 193: Show Host-Port-Interconnects

    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-port-interconnects Host Port Interconnect: enabled Related Commands “set host-port-interconnects” on page 132 ■...
  • Page 194: Show Host-Wwn-Names

    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 port WWN Host-ID/WWN Nickname assigned to the host WWN Name Example Show host WWNs and nicknames assigned to them. # show host-wwn-names Host-ID/WWN Name...
  • Page 195: Show Iscsi-Hosts

    show iscsi-hosts Description iSCSI only. Shows iSCSI host initiators. Input show iscsi-hosts Output Field Description iSCSI host initiator’s node name, typically the IQN. If Host node name/IQN the host node name exceeds 62 characters and the CLI is in console mode, the node name that is displayed is truncated and a ‘>’...
  • Page 196: Show Iscsi-Parameters

    show iscsi-parameters Description iSCSI only. Shows system-wide iSCSI parameters. Input show iscsi-parameters Output Field Description Whether Challenge-Handshake Authentication Protocol CHAP is enabled or disabled Whether jumbo-frame support is enabled or disabled Jumbo Frames Whether Internet Storage Name Service support is iSNS enabled or disabled Address of the iSNS server...
  • Page 197 Related Commands “set iscsi-parameters” on page 135 ■ Chapter 3 Command Descriptions...
  • Page 198: Show Job-Parameters

    show job-parameters Description Shows parameters for background scrub, partner firmware upgrade, and other jobs. Input show job-parameters Output Field Description Shows whether disks are automatically checked Background Scrub for disk drive defects to ensure system health. Shows whether component firmware versions Partner Firmware Upgrade are monitored and will be automatically upgraded on the partner controller.
  • Page 199: Show License

    show license Description Shows whether a license key is installed and information about licensed features. Input show license Output Field Description • The license key, if a license is installed and valid License Key • not installed, if a license is invalid or is not installed Number of snapshots allowed without an installed Base Max Snapshots...
  • Page 200: Show Master-Volumes

    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 Optional. Only includes master volumes owned by controller controller a|b A or B.
  • Page 201 Field Description Amount of snap-pool space occupied by this master volume Snap Data for its associated snapshots (preserved and write data) Either the percent complete if rollback is in progress, or Rollback “---” if rollback is not in progress Example Show information about master volumes associated with snap pool SP1.
  • Page 202: Show Network-Parameters

    show network-parameters Description Shows the network settings for each RAID controller. Input show network-parameters Output Field Description Controller IP address IP Address Controller gateway Gateway Controller subnet mask Subnet Mask Controller's unique Media Access Control address MAC Address • Manual: Network settings set manually (statically) Addressing Mode •...
  • Page 203 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...
  • Page 204: Show Ntp-Status

    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 ( ). If activated, activated the client task becomes present. Before activation and after successful deactivation the status of the client task is not applicable ( ).
  • Page 205 Example Show NTP status for the system. # show ntp-status NTP Status ---------- Status : activated Client Task Status : present NTP Server Address : 69.10.36.3 Last Server Contact: 2007-12-04 16:24:42 Related Commands “set controller-date” on page 120 ■ Chapter 3 Command Descriptions...
  • Page 206: Show Port-Wwn

    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 Controller ID CTRL Host port number World wide port name WWPN Example Show a SAS system’s port WWNs, which differ in the fourteenth digit. # show port-wwn CTRL CH WWPN -------------------------...
  • Page 207: Show Protocols

    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 protocols Service and Security Protocols ------------------------------ Web Browser Interface (HTTP) : Enabled Secure Web Browser Interface...
  • Page 208: Show Redundancy-Mode

    show redundancy-mode Description Shows the redundancy status of the system. Input show redundancy-mode Output Field Description The redundancy mode, also called the “operation mode.” Redundancy Mode • Active-Active ULP: SAS only. Both controllers are active using ULP (Unified LUN Provisioning), which means 128 LUNs are available for mapping volumes.
  • Page 209 Field Description • Controller module serial number Controller ID Serial Number • Not Available: The controller is down or not installed. Example Show the redundancy status of an operational dual-controller SAS system. # show redundancy-mode System Redundancy ----------------- Redundancy Mode : Active-Active ULP Redundancy Status : Redundant...
  • Page 210: Show Schedule-Details

    show schedule-details Description Shows information about a specified task schedule. Inputt show schedule-details schedule Parameter Description schedule Specifies the schedule name. Output Field Description Schedule name Schedule Name Parameters of the schedule Schedule Specification Ready or Active Schedule Status The next time the task will run Next Time The name of the task to run Task to Run...
  • Page 211 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 schedule-details Sched1 Schedule Details ---------------- Schedule Name: Sched1 Schedule Specification: Start 2/19/2007 23:47:00, Every 3 Minutes Schedule Status: Ready Next Time: 2/23/2007 12:59:00...
  • Page 212: Show Schedules

    show schedules Description Shows configured task schedules. Input show schedules Output Field Description Schedule name Schedule Name Task name Task To Run The next time the task will run; or none if the task will not run Next Time again Example Show configured task schedules for a system.
  • Page 213: Show Sensor-Status

    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 Where the sensor is located Sensor Name The value of the sensor Value • Absent: Component is not present Status •...
  • Page 214 Example Show the status and value of the sensors. # show sensor-status Sensor Name Value Status ---------------------------------------------------- CPU Temperature-Ctlr A CPU Temperature-Ctlr B FPGA Temperature-Ctlr A FPGA Temperature-Ctlr B Onboard Temperature 1-Ctlr A Onboard Temperature 1-Ctlr B Onboard Temperature 2-Ctlr A Onboard Temperature 2-Ctlr B Capacitor Temperature-Ctlr A Capacitor Temperature-Ctlr B...
  • Page 215: Show Shutdown-Status

    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 shutdown-status storage controller A is up storage controller B is up Related Commands “restart”...
  • Page 216: Show Snap-Pools

    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 Optional. Shows snap pools owned by controller A controller a|b|both only, by controller B only, or by either controller (both).
  • Page 217 Example Show information for snap pools owned by either controller. # show snap-pools Vdisk Serial# Name Size Free MasterVols Snapshots ------------------------------------------------------------ 00c0ff6270190000938c1d4701000000 3001.0MB 2990.5MB Threshold %Usage Policy SizeToExpand --------------------------------------------------------- Warning Notify Only Error Auto Expand 1000.3MB Critical Delete Snapshots ------------------------------------------------------------ Related Commands “create snap-pool”...
  • Page 218: Show Snapshots

    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 Optional.
  • Page 219 Field Description Shows “---” for Available status, or a reason for Status-Reason 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) •...
  • Page 220: Show Snmp-Parameters

    show snmp-parameters Description Shows current settings for SNMP notification. Input show snmp-parameters Output Field Description • enabled: SNMP notification is enabled SNMP • disabled: SNMP notification is disabled • Critical: Only critical events are sent as traps SNMP Filter • Warning: All critical events and warnings are sent as traps •...
  • Page 221 Related Commands “set snmp-parameters” on page 149 ■ Chapter 3 Command Descriptions...
  • Page 222: Show System

    show system Description Shows information about the system. Input show system Output System Name ■ System Contact ■ System Location ■ System Info ■ Vendor Name ■ Product ID ■ Product Brand ■ SCSI Vendor ID ■ Enclosure Count ■ Related Commands “set system”...
  • Page 223: Show Task-Details

    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 The status of the task: Ready, Active Task Status The current state of the task: Init, Vol Verified, Task State License Checked, Name Created, Snap Created, Snap Verified...
  • Page 224 Output (ResetSnapshot) Field Description Task name Task Name Task Type ResetSnapshot The status of the task: Ready, Active Task Status The current state of the task: Init, Snap Verified Task State Name of the snapshot to be reset Snapshot Name Serial number of the snapshot to be reset Snapshot Serial Any error message associated with this task...
  • Page 225 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...
  • Page 226 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 ■ HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008...
  • Page 227: Show Tasks

    show tasks Description Shows configured tasks. Input show tasks Output Field Description Task name Task Name Task type: TakeSnapshot, ResetSnapshot, VolumeCopy Task Type Task status: Ready, Active Task Status Example Show configured tasks for the system. # show tasks Task Name Task Type Task Status ------------------------------------------------------------...
  • Page 228: Show Users

    show users Description Shows configured user profiles. Input show users Output Field Description User name Username • Monitor: View-only access to selected user interfaces Access Level • Manage: Modify access to selected user interfaces Applies to the WBI only. User Type •...
  • Page 229 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...
  • Page 230: Show Vdisks

    show vdisks Description Shows information for all or specific virtual disks. Input show vdisks [vdisks] Parameter Description Optional. Specifies the virtual disks by name or serial number. For the vdisks syntax to use, see “Virtual Disk Syntax” on page 26. If this parameter is omitted, information is shown for all virtual disks.
  • Page 231 Field Description • CRIT: The vdisk is online, however some drives are down and the Stat 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 •...
  • Page 232: Show Versions

    show versions Alias for . See “versions” on page 247. versions HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008...
  • Page 233: Show Volumecopy-Status

    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 Optional. Shows volume copy operations for volumes owned controller a|b by controller A or controller B only.
  • Page 234 Example Show information about volume copies in progress for controller A. # show volumecopy-status controller a VC Volume Name Serial# Vdisk Source Volume Progress Status Status-Reason ---------------------------------------------------------------- MV1-copy 00c0ff6270050000509b0f4702000000 VD1_V1 Unavailable VC In Progress ---------------------------------------------------------------- Related Commands “abort volumecopy” on page 41 ■...
  • Page 235: Show Volume-Maps

    show volume-maps Description Shows mapping information for a specified volume or for all volumes. Input show volume-maps [volume] Parameter Description Optional. Specifies the volume by its name or serial number. For the volume syntax to use, see “Volume Syntax” on page 26. If this parameter is omitted, information for all volumes is shown.
  • Page 236 Example On a SAS system, show the mappings for volume V1. # show volume-maps V1 Volume [SN 00c0ff0a43180048517e054501000000, Name (V1)] mapping view: 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.
  • Page 237: Show Volumes

    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 Optional. Specifies the virtual disks by name or vdisk vdisks serial number. For the syntax to use, see “Virtual Disk Syntax”...
  • Page 238 Field Description • standard: Standard volume Type • 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.
  • Page 239 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...
  • Page 240: Shutdown

    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.
  • Page 241: Stty

    stty Description Sets and shows terminal information. Input stty info | hardwrap | rows # | columns # Parameter Description Shows current information about the terminal info Toggles the hard wrapping of output. Terminals usually wrap at the hardwrap screen width without truncating output, but turning on hard wrapping ensures this.
  • Page 242: Trust

    trust Description Enables an offline virtual disk to be brought online for emergency data collection only. It must be enabled before each use. This command can cause unstable operation and data loss if used Caution – improperly. It is intended for disaster recovery only. command re-synchronizes the time and date stamp and any other trust metadata on a bad disk drive.
  • Page 243 Input To enable the trust command: trust enable To trust a virtual disk: trust vdisk vdisk Parameter Description Enables the trust command before use enable Specifies the virtual disks by name or serial number. For the vdisk vdisk syntax to use, see “Virtual Disk Syntax” on page 26. Example Enable the trust command and then trust virtual disk VD1.
  • Page 244: Unmap Volume

    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...
  • Page 245 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...
  • Page 246: Verify Vdisk

    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.
  • Page 247: Versions

    versions Description Shows the hardware and software versions for each controller module. Alias: show versions Input versions Output Storage Controller CPU Type ■ Storage Controller Firmware ■ Storage Controller Memory ■ Storage Controller Loader ■ Management Controller Firmware ■ Management Controller Loader ■...
  • Page 248: Volumecopy

    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 ;...
  • Page 249 Parameter Description Optional. Specifies whether to include or exclude modified-snapshot modified write data from the snapshot in the copy. This yes|no parameter applies only when the source volume is a snapshot; it is ignored if the source volume is a master volume.
  • Page 250 HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008...
  • Page 251: Troubleshooting Using The Cli

    CH A P T E R Troubleshooting Using the CLI This appendix briefly describes CLI commands that are useful for troubleshooting storage system problems, and it includes other troubleshooting topics. Topics covered in this appendix include: “Viewing Command Help” on page 252 ■...
  • Page 252: Viewing Command Help

    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: command # help command To view information about the syntax to use for specifying disk drives, virtual disks, volumes, and volume mapping, type: # help syntax clear cache...
  • Page 253: Ping

    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.
  • Page 254: Restore Defaults

    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 –...
  • Page 255: Set Expander-Fault-Isolation

    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.
  • Page 256: Set Protocols

    set protocols Enables or disables one or more of the following management services and protocols. , for standard access to SMU http ■ , for secure access to SMU https ■ , for standard access to the CLI telnet ■ , for secure access to the CLI ■...
  • Page 257: Show Enclosure-Status

    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.
  • Page 258: Show Protocols

    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.
  • Page 259: Problems Scheduling Tasks

    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: , and TakeSnapshot ResetSnapshot 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.
  • Page 260: Errors Associated With Scheduling Tasks

    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.
  • Page 261: Glossary

    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.
  • Page 262 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.
  • Page 263 controller enclosure An enclosure that contains disk drives and one or two controller modules. See controller module. 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;...
  • Page 264 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;...
  • Page 265 enclosure management processor (EMP) 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. Ethernet adapter An adapter that connects an intelligent device to an Ethernet network. Usually called an Ethernet network interface card, or Ethernet NIC.
  • Page 266 fault-tolerant virtual disk 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).
  • Page 267 host bus adapter (HBA) 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.
  • Page 268 I/O module (IOM) See controller module and expansion module. Internet Protocol. ISCSI Qualified Name. iSCSI Internet Small Computer System Interface. iSNS Internet Storage Name Service. JBOD Just a Bunch of Disks. A drive enclosure that is directly attached to a host.
  • Page 269 management host A workstation with direct or network connections to a storage system’s management ports and that is used to manage the system. management information base (MIB) A database of managed objects accessed by network management protocols. An SNMP MIB is a set of parameters that an SNMP management station can query or set in the SNMP agent of a network device (for example, a router).
  • Page 270 out-of-band management Method of accessing and managing a system using the RS-232 or Ethernet connection. ownership 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.
  • Page 271 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.
  • Page 272 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 For use with CHAP, a password that is shared between an initiator and a target to enable authentication.
  • Page 273 standard volume A volume that is not enabled for snapshots. standby See spare. state 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.
  • Page 274 Unified LUN Provisioning. A MSA2012sa storage system feature that makes all volumes in the system accessible to hosts through all host ports on both controllers. ULP incorporates Asymmetric Logical Unit Access (ALUA) extensions. Universal Time. A modern time system related to the conventional Greenwich Mean Time (GMT) used for time zones.
  • Page 275 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) A globally unique 64-bit identifier assigned to each Fibre Channel node...
  • Page 276 HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008...
  • Page 277: Index

    Index show records, 162 show setting, 196 aliases, manage, 42 chunk size, set, 66 array, See system command syntax, 25 help, 252 base for calculations operation modes, 16 set, 118 troubleshooting commands, 251 show setting, 164 ways to access, 15 CLI parameters set, 118 cache...
  • Page 278 show, 168 event log description, 30 controller redundancy mode, showing, 258 events clear, 46 show, 181 events, showing, 257 date, controller set, 120 exit CLI session, 87 show, 168 expander fault isolation, enabling or disabling, 255 debug log expander PHYs, enabling or disabling, 255 viewing, 256 expander status debug log parameters...
  • Page 279 show, 206 illuminating enclosure Unit Locator, 255 show nickname, 194 license information, show, 199 host, map volume to, 94 link speed, FC host host, test communication with, 97 set, 130 show setting, 159 link speed, iSCSI host set, 135 ICPM. See independent cache performance mode show, 196 independent cache performance mode LIP, issue to reset host channels, 99...
  • Page 280 shutdown status, show, 215 single-command mode, 16 paging of output set, 118 size of devices and logical units, 29 show setting, 164 snap pool parameter syntax, 25 create, 58 delete, 78 parity expand, 88 abort verification, 40 set capacity thresholds, 147 verify virtual disk, 246 set recovery policy, 145 password, set for user interfaces, 141...
  • Page 281 timeout for session volume set, 118 convert master to standard, 48 show setting, 164 convert standard to master, 49 copy status, 233 topology, show FC, 159 create, 68 triggers for automatic write-through delete, 86 set, 107 expand, 92 show settings, 156 map during create, 68 trust an offline virtual disk for emergency data map to hosts, 94...
  • Page 282 HP StorageWorks 2000 Family Modular Smart Array CLI reference guide • May 2008...

This manual is also suitable for:

Storageworks 2000 series

Table of Contents