HP Modular Smart Array 500 Starter Kit Guida Utente

HP StorageWorks2300 Modular Smart ArrayCLI reference guidePart number: 500912-001First edition: January 2009

10CAUTION: Indicates that failure to follow directions could result in damage to equipment or data.NOTE: Provides additional information.HP technical

100set snap-pool-policyDescription Sets the recovery policy that determines the action taken when a specified snap pool's error and critical thre

HP StorageWorks 2300 Modular Smart Array CLI reference guide 101set snap-pool-thresholdDescription Sets the percentages of snap-pool space used that t

102set snmp-parametersDescription Sets SNMP parameters for event notification.Syntaxset snmp-parameters [enable crit|warn|info|none] [add-trap-host ad

HP StorageWorks 2300 Modular Smart Array CLI reference guide 103set sparesDescription Designates spare disks for use by redundant (RAID 1, 3, 5, 6, 10

104set systemDescription Sets the system’s name, contact person, location, description, and locale. Each value can include a maximum of 79 bytes, usin

HP StorageWorks 2300 Modular Smart Array CLI reference guide 105set userDescription Changes user preferences for the session or permanently. You canno

106type standard|advanced|diagnosticOptional. Specifies the user's level of technical expertise, to control access to functions in the WBI.• stan

HP StorageWorks 2300 Modular Smart Array CLI reference guide 107set vdiskDescription Changes a vdisk's name and owning controller.NOTE: Before ch

108set volumeDescription Changes a volume's name.Syntaxset volume volume name new-name [ovms-uid ID]Parameters volumeName or serial number of the

HP StorageWorks 2300 Modular Smart Array CLI reference guide 109show advanced-settingsDescription For API use, shows the settings for advanced system-

HP StorageWorks 2300 Modular Smart Array CLI reference guide 111 Using the CLIThis chapter introduces the HP StorageWorks 2300 Modular Smart Array com

110Temperature ExceededShows whether the system forces a controller shutdown if a temperature is detected that exceeds system threshold limits.Partner

HP StorageWorks 2300 Modular Smart Array CLI reference guide 111show auto-write-through-triggershow awtSee show auto-write-through-trigger.Description

112show cache-parametersDescription Shows cache settings and status for the system and optionally for a volume.Syntaxshow cache-parameters [volume]Par

HP StorageWorks 2300 Modular Smart Array CLI reference guide 113Example Show the cache parameters for the system and for volume V1:# show cache-parame

114show cli-parametersDescription Shows the current CLI session preferences.Syntaxshow cli-parametersOutput TimeoutTimeout value in seconds for the lo

HP StorageWorks 2300 Modular Smart Array CLI reference guide 115See also • set cli-parameters

116show configurationDescription Shows system configuration information.Syntaxshow configurationOutput • System information from show system• Controll

HP StorageWorks 2300 Modular Smart Array CLI reference guide 117show controller-dateDescription Shows the system's current date and time.Syntaxsh

118show controllersDescription Shows information about each controller in the storage system.Syntaxshow controllersOutput Controller IDSerial NumberHa

HP StorageWorks 2300 Modular Smart Array CLI reference guide 119Example Show information about a system with a single FC controller:# show controllers

12 Using the CLIUsing CLI scriptsCLI commands can be scripted using a Telnet client like Expect or a Perl library.The following example shows the Perl

120show debug-log-parametersDescription This command is for use by or with direction from a service technician.Shows which debug message types are ena

HP StorageWorks 2300 Modular Smart Array CLI reference guide 121show disk-parametersDescription Shows disk settings.Syntaxshow disk-parametersExample

122show disksDescription Shows information about all disks in the storage system. If no parameter is specified, the command shows information for all

HP StorageWorks 2300 Modular Smart Array CLI reference guide 123Rate(Gb/s)Data transfer speed in Gbit/secondSPShows which controller a single-ported d

124show email-parametersDescription Shows SMTP parameters for event notification.Syntaxshow email-parametersExample Show settings for email notificati

HP StorageWorks 2300 Modular Smart Array CLI reference guide 125show enclosure-statusDescription Shows the status of system enclosures and their compo

126Add'l DataAdditional data such as temperature (Celsius), voltage, or slot addressExample Show enclosure status:# show enclosure-statusChassis

HP StorageWorks 2300 Modular Smart Array CLI reference guide 127show enclosuresDescription Full detail available in API output only. Shows information

128show eventsDescription Shows events for an enclosure, including events from each Management Controller and each Storage Controller. A separate set

HP StorageWorks 2300 Modular Smart Array CLI reference guide 129Example Show the last two events:# show events last 2Show the last three warning and c

HP StorageWorks 2300 Modular Smart Array CLI reference guide 13The following example shows how to construct a script using a Perl library for Telnet c

130show expander-statusDescription This command is for use by or with direction from a service technician.Shows diagnostic information relating to SAS

HP StorageWorks 2300 Modular Smart Array CLI reference guide 131Example Show the expander status for all enclosures:# show expander-statusEncl Phy Ty

132show frusDescription Shows information for field-replaceable units (FRUs) in all enclosures. Some information reported is for use by service techni

HP StorageWorks 2300 Modular Smart Array CLI reference guide 133show host-mapsDescription Shows mapping information for volumes that are mapped to all

134Example Show volume mappings for all hosts:# show host-mapsHost View [ID (AABBCCDDEEFF0011) Name (Host1) Profile (OpenVMS) ] Mapping: Name Se

HP StorageWorks 2300 Modular Smart Array CLI reference guide 135show host-parametersDescription Shows information about host ports on both controllers

136show hostsDescription Shows hosts that volumes can be mapped to. Host entries are automatically created for hosts that have sent an inquiry command

HP StorageWorks 2300 Modular Smart Array CLI reference guide 137show job-parametersDescription Shows parameters for background scrub, partner firmware

138show licenseDescription Shows the status of licensed features in the storage system.Syntaxshow licenseParametersOutput License Key• The license key

HP StorageWorks 2300 Modular Smart Array CLI reference guide 139show master-volumesDescription Shows information about all master volumes, or ones ass

14 Using the CLIUsing the XML APIYou can use an XML parser such as XML::Parser in Perl to process the XML output and store this information as objects

140See also • convert master-to-std• create master-volume• delete all-master-volumes• delete master-volume• expand volume• rollback master-volume

HP StorageWorks 2300 Modular Smart Array CLI reference guide 141show network-parametersDescription Shows the network settings for each RAID controller

142show ntp-statusDescription Shows the status of the use of Network Time Protocol (NTP) in the system.Syntaxshow ntp-statusOutput Status• activated:

HP StorageWorks 2300 Modular Smart Array CLI reference guide 143show portsDescription Shows information about host and expansion ports on both control

144show protocolsDescription Shows which management services and protocols are enabled or disabled.Syntaxshow protocolsExample Show the status of serv

HP StorageWorks 2300 Modular Smart Array CLI reference guide 145show redundancy-modeDescription Shows the redundancy status of the system.Syntaxshow r

146show refresh-countersDescription For API use, shows when the data represented by the base type was last updated.Syntaxshow refresh-counters

HP StorageWorks 2300 Modular Smart Array CLI reference guide 147show sas-link-healthDescription Shows the condition of SAS port connections.Syntaxshow

148show schedule-detailsDescription Shows information about a specified task schedule.Syntaxshow schedule-details scheduleParameters scheduleSpecifies

HP StorageWorks 2300 Modular Smart Array CLI reference guide 149show schedulesDescription Shows configured task schedules.Syntaxshow schedulesOutput S

HP StorageWorks 2300 Modular Smart Array CLI reference guide 15Scripting guidelinesWhen writing scripts to parse XML API output, use an XML library to

150show sensor-statusDescription Shows temperatures and voltages of controller modules and power supplies. These values are reported by environmental

HP StorageWorks 2300 Modular Smart Array CLI reference guide 151Voltage 12V Loc:right-PSU 2 12.02 OKVoltage 5V Loc:right-PSU 2 5.16

152show shutdown-statusDescription Shows whether each Storage Controller is active or shut down.Syntaxshow shutdown-statusExample Show the shutdown st

HP StorageWorks 2300 Modular Smart Array CLI reference guide 153show snap-poolsDescription Shows information about snap pools owned by a specified con

154show snapshotsDescription Shows information about snapshots for a specified controller, master volume, or snap pool. If no parameters are specified

HP StorageWorks 2300 Modular Smart Array CLI reference guide 155UniqueDataAmount of preserved and write data that is unique to the snapshotSharedDataA

156show snmp-parametersDescription Shows SNMP settings for event notification.Syntaxshow snmp-parametersOutput SNMP• enabled: SNMP notification is ena

HP StorageWorks 2300 Modular Smart Array CLI reference guide 157show systemDescription Shows information about the system.Syntaxshow systemExample Sho

158show system-parametersDescription Shows the current settings for the storage system.Syntaxshow system-parametersOutput ULPShows that Unified LUN Pr

HP StorageWorks 2300 Modular Smart Array CLI reference guide 159show task-detailsDescription Shows details of all tasks or a specified task.Syntaxshow

16 Using the CLI <PROPERTY name="cache-optimization" type="enumeration" size="12" draw="true" sort=&qu

160For a ResetSnapshot task:Task NameTask nameTask TypeResetSnapshotTask Status• Ready: Task is ready to run• Active: Task is currently runningTask St

HP StorageWorks 2300 Modular Smart Array CLI reference guide 161Example Show details for task Snap:# show task-details SnapTasks-----Task Name: SnapTa

162show tasksDescription Shows configured tasks.Syntaxshow tasksExample Show configured users:# show tasksTask Name Task Type

HP StorageWorks 2300 Modular Smart Array CLI reference guide 163show usersDescription Shows configured user profiles.Syntaxshow usersOutput UsernameUs

164show vdisksDescription Shows information for all or specified vdisks.Syntaxshow vdisks [vdisks]Parameters vdisksOptional. Names or serial numbers o

HP StorageWorks 2300 Modular Smart Array CLI reference guide 165Example Show information about vdisk VD1 only:# show vdisks VD1Name Size Free O

166show volume-mapsDescription Shows mapping information for a specified volume or for all volumes.Syntaxshow volume-maps [volume]Parameters volumeOpt

HP StorageWorks 2300 Modular Smart Array CLI reference guide 167show volumecopy-statusDescription Shows information about in-progress volume copy oper

168show volumesDescription Shows volume information for all or specified vdisks.Syntaxshow volumes [vdisk vdisks] [class standard|ptsnap] [type snap-p

HP StorageWorks 2300 Modular Smart Array CLI reference guide 169Volume Description• For OpenVMS, a numeric value (set with create volume or set volume

HP StorageWorks 2300 Modular Smart Array CLI reference guide 17XML API DTDThe following DTD provides the structure of all documents returned by the CL

170shutdownDescription Shuts down the Storage Controller in a controller module. This ensures that a proper failover sequence is used, which includes

HP StorageWorks 2300 Modular Smart Array CLI reference guide 171sttyDescription Sets and shows terminal information.Syntaxstty info | hardwrap | rows

172testDescription Sends a message to test event notification. After issuing this command, verify that test message reached the configured destination

HP StorageWorks 2300 Modular Smart Array CLI reference guide 173trustDescription Enables an offline vdisk to be brought online for emergency data coll

174unmap volumeDescription Deletes an explicit mapping whose settings override a volume's default mapping. When the explicit mapping is deleted,

HP StorageWorks 2300 Modular Smart Array CLI reference guide 175verify vdiskDescription Verifies whether vdisk redundancy data is consistent with its

176versionsDescription Shows the hardware and software versions for each controller module. Alias: show versions.SyntaxversionsExample Show versions f

HP StorageWorks 2300 Modular Smart Array CLI reference guide 177volumecopyDescription Copies a snapshot or a master volume to a new standard volume. T

178See also • abort volumecopy• create task• show vdisks• show volumecopy-status• show volumes

HP StorageWorks 2300 Modular Smart Array CLI reference guide 179Glossarychunk size The amount of contiguous data that is written to a vdisk member bef

18 Using the CLI A IDREF #REQUIRED B IDREF #REQUIRED >XML API basetypesThe following basetypes can be used when calling the meta command to

180volume copy Licensed capability to create a copy, or clone, a volume.ULP Unified LUN Presentation. A RAID controller feature that enables a host to

HP StorageWorks 2300 Modular Smart Array CLI reference guide 181IndexAaccess levelset user 42, 105show user 163arraySee systemaudience 9Bbase 10 22bas

182Ddate and timeset 84show settings 117debug interfaceenable/disable 99debug logset parameters 85show parameters 120dedicated sparesset 103default LU

HP StorageWorks 2300 Modular Smart Array CLI reference guide 183HPstorage web site 10Subscriber’s choice web site 10technical support 10HTTP interface

184scrubabort vdisk 26enable/disable automatic 94enable/disable background 76show background setting 109start manual vdisk 75SCSI MODE SELECT commands

HP StorageWorks 2300 Modular Smart Array CLI reference guide 185show access level 163show locale 163show management-interface access 163show type 163u

186

HP StorageWorks 2300 Modular Smart Array CLI reference guide 19In the following example, embedded objects contain media-specific detail for ports, and

Legal and notice information© Copyright 2009 Hewlett-Packard Development Company, L.P.The information contained herein is subject to change without no

20 Using the CLICommand syntaxKeywords and parametersCommand keywords must be entered in lowercase. Parameter values can be entered in uppercase and l

HP StorageWorks 2300 Modular Smart Array CLI reference guide 21Command completion, editing, and historyThe CLI supports command completion, command ed

22 Using the CLISize representationsOperating systems usually show volume size in base 2. Disk drives usually show size in base 10. Memory size is alw

HP StorageWorks 2300 Modular Smart Array CLI reference guide 232 Categorical list of commandsThis chapter helps you find a command within a category o

24 Categorical list of commandsScheduled tasks create schedulecreate taskdelete scheduledelete taskshow schedule-detailsshow schedulesshow task-detail

HP StorageWorks 2300 Modular Smart Array CLI reference guide 253 Alphabetical list of commandsThis chapter is organized to help you find a command by

26 Alphabetical list of commandsabort scrubDescription Aborts the scrub vdisk operation for specified vdisks.Syntaxabort scrub vdisk vdisksParameters

HP StorageWorks 2300 Modular Smart Array CLI reference guide 27abort verifyDescription Aborts the verify vdisk operation for specified vdisks.Syntaxab

28 Alphabetical list of commandsabort volumecopyDescription Aborts copying a volume. When the abort is complete, the destination volume is deleted.Syn

HP StorageWorks 2300 Modular Smart Array CLI reference guide 29clear cacheDescription Clears unwritable data in both controllers' cache for a spe

HP StorageWorks 2300 Modular Smart Array CLI reference guide 3About this guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

30 Alphabetical list of commandsclear disk-metadataDescription Clears metadata from “leftover” disks. Each disk contains metadata that the system uses

HP StorageWorks 2300 Modular Smart Array CLI reference guide 31clear eventsDescription This command is for use by or with direction from a service tec

32 Alphabetical list of commandsclear expander-statusDescription This command is for use by or with direction from a service technician.Clears the cou

HP StorageWorks 2300 Modular Smart Array CLI reference guide 33convert master-to-stdDescription Converts a specified master volume into a standard vol

34 Alphabetical list of commandsconvert std-to-masterDescription Converts a standard volume to a master volume; that is, it enables the volume for sna

HP StorageWorks 2300 Modular Smart Array CLI reference guide 35create hostDescription Creates a host entry with an associated nickname. When mapping v

36 Alphabetical list of commandscreate master-volumeDescription Creates a volume that is enabled for snapshots. The volume is created in a specified v

HP StorageWorks 2300 Modular Smart Array CLI reference guide 37create scheduleDescription Schedules a task to run automatically.Syntaxcreate schedule

38 Alphabetical list of commandscreate snap-poolDescription Creates a snap pool to use for snapshot data. A snap pool is an internal volume and cannot

HP StorageWorks 2300 Modular Smart Array CLI reference guide 39create snapshotsDescription Creates a snapshot of each specified source volume. The sou

4delete all-master-volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48del

40 Alphabetical list of commandscreate taskDescription Creates a task that can be scheduled. You can create a task to take a snapshot of a master volu

HP StorageWorks 2300 Modular Smart Array CLI reference guide 41dest-vdisk vdiskName or serial number of the destination vdisk for the volume copy. For

42 Alphabetical list of commandscreate userDescription Creates a user profile. The system supports 12 user profiles.Syntaxcreate user name [base 2|10]

HP StorageWorks 2300 Modular Smart Array CLI reference guide 43timeout #Optional. Sets the timeout value in seconds for the login session. Valid value

44 Alphabetical list of commandscreate vdiskDescription Creates a vdisk using the specified RAID level, disks, and spares. All disks used in a vdisk a

HP StorageWorks 2300 Modular Smart Array CLI reference guide 45See also • set vdisk• show disks• show vdisks

46 Alphabetical list of commandscreate volumeDescription Creates a volume in a vdisk. You can specify a size and name for the volume, and map it to ho

HP StorageWorks 2300 Modular Smart Array CLI reference guide 47create volume-setDescription Creates multiple volumes in the specified vdisk. The volum

48 Alphabetical list of commandsdelete all-master-volumesDescription Deletes all master volumes associated with a snap pool. NOTE: You must delete all

HP StorageWorks 2300 Modular Smart Array CLI reference guide 49delete all-snapshotsDescription Deletes all snapshots of a specified volume. All data a

HP StorageWorks 2300 Modular Smart Array CLI reference guide 5set volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

50 Alphabetical list of commandsdelete hostDescription Deletes a manually created host. Does not delete hosts that were discovered or are mapped.Synta

HP StorageWorks 2300 Modular Smart Array CLI reference guide 51delete master-volumeDescription Deletes a master volume. Alias of delete volume.NOTE: Y

52 Alphabetical list of commandsdelete scheduleDescription Deletes a task schedule.Syntaxdelete schedule scheduleParameters scheduleThe schedule to de

HP StorageWorks 2300 Modular Smart Array CLI reference guide 53delete snap-poolDescription Deletes a snap pool.NOTE: You must disassociate all master

54 Alphabetical list of commandsdelete snapshotDescription Deletes a snapshot. All data uniquely associated with the snapshot is deleted and associate

HP StorageWorks 2300 Modular Smart Array CLI reference guide 55delete snapshot-write-dataDescription Deletes data written to a snapshot after it was c

56 Alphabetical list of commandsdelete taskDescription Deletes a task. If the task is scheduled, you must delete the schedule first.Syntaxdelete task

HP StorageWorks 2300 Modular Smart Array CLI reference guide 57delete userDescription Deletes a user profile. You can delete any user except the defau

58 Alphabetical list of commandsdelete vdiskDescription Deletes specified vdisks. This disassociates all disks that are assigned to the vdisks, and un

HP StorageWorks 2300 Modular Smart Array CLI reference guide 59delete volumeDescription Deletes a volume.CAUTION: Deleting a volume will delete all da

6

60 Alphabetical list of commandsdequarantine vdiskDescription A previously fault-tolerant vdisk becomes quarantined when not all of its disks are dete

HP StorageWorks 2300 Modular Smart Array CLI reference guide 61exitDescription Log off and exit the CLI session.Syntaxexit

62expand master-volumeSee expand volume.

HP StorageWorks 2300 Modular Smart Array CLI reference guide 63expand snap-poolDescription Expands a snap-pool volume. Expansion is restricted to the

64expand vdiskDescription Adds disks to a vdisk. The expansion capability for each supported RAID level is:RAID level Expansion capability Maximum dis

HP StorageWorks 2300 Modular Smart Array CLI reference guide 65expand volumeDescription Expands a standard or master volume. Expansion is restricted t

66map volumeDescription Maps a volume using settings that override the volume's default mapping. When a volume is created, if no mapping settings

HP StorageWorks 2300 Modular Smart Array CLI reference guide 67metaDescription For API use, shows data that CLI brief mode omits. The data is static a

68pingDescription Tests communication with a remote host. The remote host is specified by IP address. Ping sends ICMP echo response packets and waits

HP StorageWorks 2300 Modular Smart Array CLI reference guide 69rescanDescription This command forces rediscovery of attached disks and enclosures. If

HP StorageWorks 2300 Modular Smart Array CLI reference guide 7Tables1 Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

70reset host-linkDescription Resets specified FC controller host ports (channels). For an FC host port configured to use FC-AL (loop) topology, a loop

HP StorageWorks 2300 Modular Smart Array CLI reference guide 71reset snapshotDescription Deletes the data in a snapshot and resets it to the current d

72restartDescription Restarts the Storage Controller or Management Controller in a controller module. If you restart a Storage Controller, it attempts

HP StorageWorks 2300 Modular Smart Array CLI reference guide 73restore defaultsDescription This command is for use by or with direction from a service

74rollback master-volumeDescription Rolls back (reverts) the data on a master volume to the data that exists in a specified snapshot. You can choose w

HP StorageWorks 2300 Modular Smart Array CLI reference guide 75scrub vdiskDescription Analyzes specified vdisks to detect, report, and store informati

76set advanced-settingsDescription For API use, sets advanced system configuration options.Syntaxset advanced-settings [auto-write-back enabled|disabl

HP StorageWorks 2300 Modular Smart Array CLI reference guide 77power-supply-failure enabled|disabled|on|offOptional. Sets whether the cache policy aut

78set auto-write-through-triggerset awtSee set auto-write-through-trigger.Description Sets the trigger conditions that cause the controller to change

HP StorageWorks 2300 Modular Smart Array CLI reference guide 79set cache-parametersDescription Sets a volume's cache options or the system's

8

80Cache write policyThe cache policy setting for each volume determines when cached data is written to the disks. The ability to hold data in cache wh

HP StorageWorks 2300 Modular Smart Array CLI reference guide 81Cache read-ahead sizeYou can optimize a volume for sequential reads or streaming data b

82set cli-parametersDescription Sets options that control CLI behavior. If you are accessing the CLI through the network port, settings apply to the c

HP StorageWorks 2300 Modular Smart Array CLI reference guide 83units auto|MB|GB|TBOptional. Sets the unit for display of storage-space sizes. auto let

84set controller-dateDescription Sets the date and time for each Management Controller and then updates the date and time for each Storage Controller.

HP StorageWorks 2300 Modular Smart Array CLI reference guide 85set debug-log-parametersDescription This command is for use by or with direction from a

86set disk-parametersDescription Selects a global disk Self-Monitoring Analysis and Reporting Technology (SMART) setting. Disks equipped with this tec

HP StorageWorks 2300 Modular Smart Array CLI reference guide 87set email-parametersDescription Sets SMTP parameters for event notification.Syntaxset e

88set enclosureDescription Sets an enclosure's name, location, rack number, and rack position. Set these parameters to values that help you ident

HP StorageWorks 2300 Modular Smart Array CLI reference guide 89set expander-fault-isolationDescription This command is for use by or with direction fr

HP StorageWorks 2300 Modular Smart Array CLI reference guide 9About this guideThis guide provides information about managing an 2300 Modular Smart Arr

90set expander-phyDescription This command is for use by or with direction from a service technician.Disables (isolates) or enables a specific PHY.Syn

HP StorageWorks 2300 Modular Smart Array CLI reference guide 91See also • set expander-fault-isolation• show enclosure-status• show expander-status

92set host-nameDescription Changes a host's nickname.Syntaxset host-name id host new-nickname [profile standard|openvms|hp-ux]Parameters id hostT

HP StorageWorks 2300 Modular Smart Array CLI reference guide 93set host-parametersDescription For FC , sets controller host port parameters for commun

94set job-parametersDescription Sets parameters for background scrub, partner firmware upgrade, and other jobs.Syntaxset job-parameters [background-sc

HP StorageWorks 2300 Modular Smart Array CLI reference guide 95set ledDescription Changes the state of the Unit Locator LED on a specified disk or enc

96set network-parametersDescription Sets IP values for controller module network ports. IP values can be set dynamically using Dynamic Host Configurat

HP StorageWorks 2300 Modular Smart Array CLI reference guide 97set passwordDescription Sets a user's password for system interfaces (such as the

98set promptDescription Sets the prompt for the current CLI session.Syntaxset prompt promptParameters promptThe new prompt, which can include any vali

HP StorageWorks 2300 Modular Smart Array CLI reference guide 99set protocolsDescription Enables or disables management services and protocols.Syntaxse