Hp StorageWorks 1510i Modular Smart Array Manuel d'utilisateur Page 1

HP StorageWorks1510i Modular Smart Array Command LineInterface user guideactive/active firmware 2.xPart number: 383074–002Second edition: May 2008

Document conventions and symbolsTable 1 Document conventionsConventionElementBlue text: Table 1 Cross-reference links and e-mail addressesBlue, underl

set unit_idDescription Assigns a unique user-friendly name (alias) to a LUN. A user-defined namemakes it easier to identify specific LUNs in other config

show acl_entryDescription Shows the access control lists for all initiators on a specified iSCSI target,or on all targets.NOTE:If access controls are d

show adu_pageDescription Shows the specified ADU (Array Diagnostic Utility) XML report. You mustcapture the output in a capture file using the procedure

show arpDescription Shows the ARP table of the storage ports.Syntaxshow arpOperands NoneExampleCLI> show arpIP Address MAC Address--------------- -

show auto_path_changeDescription Shows whether implicit (automatic) path changing enabled and lists thecriteria that must be met for an automatic LUN

show boxDescription Displays information about the specified hard drive storage enclosure. If abox number is not entered, information on all attached s

show cacheinfoDescription Displays controller cache status.Syntaxshow cacheinfoOperands NoneExampleCLI> show cacheinfo00000001 LINES: UNASSIGNED NO

show certificateDescription Displays the SSL certificate being used by the management interface.Syntaxshow certificate [data]Operandsdata[Optional] When

show discoveryDescription Shows the status of SLP/iSNS discovery on the iSCSI targets.Syntax show discovery [alias=<target_alias_name>]Operands

show disksDescription Lists the disks and information pertaining to them. The following informationis displayed:•Disknumber• Enclosure box and bay num

• Error messages• Operating system type and revision level• Detailed questionsHP installation and configuration assistanceStorage management and networ

show drive_reportDescription Displays a list of system smart components that require an update. Anexample smartcomponent is a hard drive.NOTE:To use t

show eventlogDescription Shows a list ofevents logged by the controller.Syntaxshow eventlogOperands NoneExampleCLI> show eventlogTIME CLASS SUB DET

show globalsDescription Displays the following global settings:•Systemname• Rebuild and expand priority settings•Readandwritecache settings• EMU and p

show initiatorDescription Displays all configured iSCSI initiators.Syntax show initiator [alias=<initiator_alias_name>]Operands alias=<initiat

show ipDescription Shows the IP addresses configured for iSCSI ports.Syntax show ip [port=<port_name>]Operands port=<port_name>[Optional] L

show iscsi_keysDescription Shows the iSCSI login parameter keys for the iSCSI targets.Syntax show iscsi_keys [alias=<target_alias_name>]Operands

show isnsDescription Shows the iSNS parameters.Syntaxshow isnsOperands NoneExampleCLI>show isnsiSNS Service is enablediSNS Server Discovery Mode is

show isns_serverDescription Shows a list of configured iSNS servers.Syntaxshow isns_serverOperands NoneExampleCLI> show isns_serverAlias Name IP Add

show managementDescription Displays current management settings for the controller management ports.Syntaxshow managementOperands NoneExampleCLI> s

show mib2Description Shows SNMP MIB-II data for the storage ports. If one of the optionalparameters is supplied, output is limited to only show the sp

12About this guide

show perfDescription Displays controller performance information that was previously gatheredby initiatingthe start perf command.Syntaxshow perf [logi

show portDescription Shows status information for the storage ports.Syntax show port [<port>]Operands <port>[Optional] The name of the phy

show portalDescription Displays all configured iSCSI portals, including the alias name, IP address,port, and portal group binding.Syntax show portal [a

show portal_groupDescription Shows all configured iSCSI portal groups.Syntax show portal_group [alias=<pg_alias_name>]Operands alias=<pg_alias

show profileDescription Displays detailed attribute information about supported host modes(operating systems).Syntax show profile [ProfileName]Operands

show preferred_pathDescription Displays the current path (controller owner) for each LUN.Syntaxshow preferred_pathOperands NoneExampleCLI> show pre

show proxystatsDescription For dual-controller configurations only, displays information aboutcommands that have been passed from one controller to the

show routeDescription Shows the routing table for the storage ports.Syntaxshow routeOperands NoneExampleCLI> show routeDestination Gateway Netmask

show serviceDescription Displays the current management interface network services configuration.Syntaxshow serviceOperands NoneExampleCLI> show ser

show snmpDescription Displays the current settings for the embedded SNMP agent.Syntaxshow snmpOperands NoneExampleCLI> show snmpCommunity String: p

1CLIsetupandoverviewThe Command Line Interface (CLI) is used to configure and manage the array controller and its storage.Tasks include configuring logi

show targetDescription Displays all configured iSCSI targets.Syntax show target [alias=<target_alias_name<]Operands alias=<target_alias_name&g

show taskstatsDescription Displays controller task statistics.Syntaxshow taskstatsOperands NoneExampleCLI> show taskstatsCurrent task stats for Ini

show tech_supportDescription Executes a macro command that runs all of the CLI show commands. Youshould redirect the screen output to a file before exe

show tgt_statsDescription Shows iSCSI login, session, and connection statistics for an iSCSI target.Syntax show tgt_stats [target=<target_alias_nam

show this_controller|other_controllerDescription Displays configuration information for the specified controller, such as:•Serialnumber• Hardware/softwa

show unitDescription Displays information about the specified LUN, or all defined LUNs. Theshow unit and show units commands are identical in functional

See also • add unit• bind unit• delete unit• set unit• accept unit• expand unit• extend unit• migrate unit• set unit_id• show unit_id• unbind unitnewp

show unit_idDescription Displays the user-defined name (alias) assigned to a LUN.Syntax show unit_id <unit>Operands <unit>The LUN number(0-

show versionDescription Displays firmware version and hardware revision information for the MSAchassis, system modules, and attached hard drive storage

start perfDescription Starts the collection of controller performance analysis data.Syntaxstart perfOperands NoneExampleCLI> start perfPerformance

2. Launch PuTTY on a PC that is connected to the same LAN as the MSA1510i.3. Enter the IP address of the MSA1510i management port in the Host Name (or

stop perfDescription Stops the collection of controller performance analysis data.Syntaxstop perfOperands NoneExampleCLI> stop perfPerformance Moni

unbind portalDescription Unbinds an iSCSI portal from a portal group, or from all portal groups if noportal group alias name is given.Syntax unbind po

unbind portal_groupDescription Unbinds an iSCSI portal group from its iSCSI target.Syntax unbind portal_group <pgroup>Operands <pgroup>The

unbind unitDescription Removes the mapping of a logical unit to a LUN on an iSCSI target. Afterthe LUN is unmapped, iSCSI initiators cannot access the

14 4Command reference

A Storage overview• Arrays and logical drives• Fault-tolerance levels• Comparison of RAID Methods•ChoosingaRAIDlevelArrays and logical drivesThe capac

S1S2S3S4B1B4B7B2B5B8B11B10 B12D2D1 D3B6B3B915312Figure3Datastriping(S1-S4)anddatablocks(B1-B12)onmultiplephysicaldrives(D1, D2, D3)For data in the log

that was originally on the failed drive to the online spare. The system is quickly restored to full RAID-leveldata protection. (In the unlikely event

S1S2S1S2D1D5B5B1B1B5D2D6B6B2B2B6D3D7B7B3B3B7D4D8B8B4B4B815315Figure 6 RAID 1+0 array, with eight physical hard drives (D1 through D8)In each mirrored

Table 5 RAID 5 featuresAdvantages DisadvantagesHigh read performance. Relatively low write performance.No loss of data if one physical drive fails.Los

1. Ensure that the Telnet interface is enabled. To enable Telnet, use the SMU. For more information, seethe HP Storage Management Utility user guide.2

Table 7 Summary of RAID methodsRAID 0 RAID 1+0RAID 5 RAID 6Alternative nameStriping MirroringDistributed DataGuarding (DDG)Advanced DataGuarding (ADG)

IndexAAccess Control List (ACL)See ACLaccess controls, set on or offset acl,77access controls, turn onacl_entry,28ACLdelete an entrydelete acl_entry,4

reset certificate,74reset controller,75reset management_login,76set acl,77set auto_path_change,78dual-controller system,78set certificate,79set discover

Ffault tolerancedescription of levels,146fault tolerance (See RAID methods.),146firmwareconfigurationsdual-controller,64obtaining,61update,59downloads f

LUNs, display current pathshow preferred_path,125LUNs, migratingmigrate unit,71Mmanagement interface network service,configureset service,94management

2. Open your terminal emulation software. The following instructions demonstrate using HyperTerminal:a. Click StartRun to open the Run dialog box. Typ

• Commandsarenotcasesensitiveandmustbetypedinfull.• The CLI does not support line-continuation characters. If all characters of a command cannotfit on

18CLI setup and overview

2 Initial configuration sequenceTheMSAcanbecompletelyconfiguredusingtheCLI.IfyouwanttousetheHPStorageManagementUnit (SMU), but the factory default manag

Legal and notice information© Copyright 2005, 2008 Hewlett-Packard Development Company, L.P.Confidential computer software. Valid license from HP requi

2. Configure a logical drive on a set of disks using the add unit command:CLI> add unit 0 raid_level=5 data=disk101-disk105 size=100gbLogical Unit s

10. Use the bind portal_group to bind the portal group to the iSCSI target just created:CLI> bind portal_group pg1 target1The portal group was boun

Configuring Access Controls for LUN accessNOTE:The steps in this section assume that you already have a basic iSCSI setup configured.1. Use the set acl

iSNS enabled• To manually add iSNS serversa. Use the set isns command to change the iSNS server discovery mode:CLI> set isns server_discovery=manua

4. [Optional] If required, enable access to the CLI via Telnet (not recommended) using the set servicecommand:CLI> set service telnet onCAUTION:The

3 Command referenceCommand overviewTheCLIusesthefollowingbasictypesofcommands:addCreates new configuration elements.bindCreates associations between iS

Alphabetical listing of commandsThe following MSA1510i CLI commands are included in this section:nlaccept unit, page 27set preferred_path, page 92add

accept unitDescription Changes the state of the unit back to VOLUME_OK. Use this command toaccept media exchange on a unit previously marked as failed

add acl_entryDescription Grants an initiator access to an iSCSI target or specificLUN.Ifyouspecifythe mapped LUN alias, the initiator is granted access

add arpDescription Adds a static ARP entry to ARP table of the storage ports. This is generallyused only for debugging purposes.Syntax add arp <ip

ContentsAboutthisguide ... 9Intendedaudience... 9Relateddocumentation...

add initiatorDescription Adds an iSCSIinitiator entry to the initiator pool.Syntax add initiator <name> [alias=<alias>]> [profile=<p

add ipDescription Assigns an IP address to the specified storage port.Syntax add ip <port><ip[/<mask>]> [<vlan>]Operands <po

add isns_serverDescription Adds an iSNS server to the iSNS server pool.NOTE:iSNS servers can be added with this command only when the iSNSserver disco

add portalDescription Adds a new portal entry in the portal pool. To use the portal, it must bebound to a portal group using the bind portal command.S

add portal_groupDescription Adds a new portal group entry into the portal group pool. To use the portalgroup, it must be bound to a target using the b

add routeDescription Adds a static route to a controller. This command is generally used fordebugging purposes.NOTE:There is one routing table per con

add spareDescription Causes the specifieddriveordrivestobeusedasasparebythespecifiedunit.Syntax add spare unit=<unit_number><diskrange>Opera

add targetDescription Adds a new target to the target pool. The target name must be world wideunique. If all target elements are already configured (al

add unitDescription Adds a new LUN comprised of one or more hard drives.NOTE:Maintain a record of the units as they are created. These Unit ID numbers

[Optional]Thestripesizetoassign(inKB).Validvaluesare8,16,32,64, 128, or 256 Kilobytes.• RAID0usesstripesizes8,16,32,64,128,and256.Default:128KB.• RAID

bindunit... 44clearperf... 45deleteacl_entry...

Example 2To assign multiple LUNs from a drive or group of drives, use the add unit command and includethe size= command option. Repeat the command usi

newpage pi1510i Modular Smart Array Command Line Interface user guide41

bind portalDescription Binds an iSCSIportal to a portal group. This allows initiators to access theiSCSI target to which the portal group is bound.Syn

bind portal_groupDescription Binds an iSCSI portal group to an iSCSI target, allowing any portals in theportal group to be used to access the target.

bind unitDescription Binds a logical unit to a LUN on an iSCSI target. A unit can only be boundto one target. The LUN number is seen by iSCSI initiato

clear perfDescription Resets the controller performance analysis data previously initiated withthe start perfcommand.Syntaxclear perfOperands NoneExam

delete acl_entryDescription Deletes an entry from the Access Control List (ACL), removing initiatorpermission to access to an iSCSI target or specificL

delete arpDescription Deletes an entry from the ARP table. Each physical port has its own ARPtable.NOTE:Only static ARP entries added with the add arp

delete initiatorDescription Removes an initiator entry from the initiator pool.NOTE:If Access Control is disabled, the initiator can still access iSCS

delete ipDescription Deletes an IP address and all associated iSCSI portals.Syntax delete ip <IP ad dress>Operands <IP address>The IP addr

showisns... 116showisns_server... 117showmanagement...

delete isns_serverDescription Deletes an iSNS server.Syntax delete isns_server <iSNS server alias>Operands <iSNS server alias>The alias na

delete portalDescription Delete an iSCSI portal and removes associations to the portal group and IPconfigurationtable.Syntax delete portal <portal a

delete portal_groupDescription Deletes an iSCSI portal group. Any portals in the portal group areautomatically unbound.Syntax delete portal_group <

delete routeDescription Deletes the specifiedrouteentryfromtheroutingtableforthespecifiedcontroller.Syntax delete route <ctlr><ip[/<mask>

delete spareDescription Causes the specifieddrivetonolongerbeusedasasparebythespecifiedunit.Syntax delete spare unit=<unit><diskrange>Operan

delete targetDescription Removes the target from the target pool. All associated portal groups areautomatically unbound.Syntax delete target<target

delete unitDescription Deletes the LUN or LUNs. All resources used by, and settings associatedwith the unit are deleted.NOTE:After a LUN is deleted, i

• extend unit• migrate unit• set unit_id• show unit_id• unbind unitnewpage pi1510i Modular Smart Array Command Line Interface user guide57

disable this_controller|other_controllerDescription In a dual-controller system, this command disables one of the controllers toprepare it for removal

download firmwareDescription Updates firmware on the MSA1510i controller or MSA1510i othercomponents, or, updates fi rmware on the hard drive storage enc

Figures1Multiplephysicaldrives(D1,D2,andD3)inasystem ... 1452Multiple physical drives (D1, D2, and D3) configured into one logical drive (

• When determining which MSA controller firmware version to use, review the requirements andinformation in the Compatibility Matrix(es), release notes,

1. Determine which version firmware is currently installed on the MSA by using one of the followingmethods:• With the array controller powered on, pres

7. Establish a serial connection to the CLI using an emulator program such as HyperTerminal.NOTE:the following example describes the HyperTerminal emu

9. On the menu bar at the top of the emulator window, select Transfer > Send File.10. In the Send File window:a. Click Browse, navigate to the dire

12. Restart the MSA and its attached storage enclosures storage system by doing the following (newlydownloaded firmware cannot be accessed until the MS

expand unitDescription Adds a physical drive or drives to the LUN. This enables the specified unitand all units on the same volume to utilize more disk

extend unitDescription Adds unused, available space in an array to the specified LUN.Syntax extend unit <unit><sizing option>Operands <u

helpDescription Displays helpful information about CLI commands. Displayed informationmay include a brief definition, required command syntax, availabl

controller adu_page mib2drive_report perf cacheinfotaskstats debug eventlogaculockSpecify command word:Example help display all command and responseCL

show perf start perfstop perf clear perfshow cacheinfo show taskstatsset debug show eventlogExample help add unit command and responseCLI> help add

Tables1Documentconventions... 102CLIspecialkeys ... 163RAID0features ...

locateDescription Helps you locate specific hardware by flashing the LEDs of the drives in therequested hardware. These LEDs are visible from the front

migrate unitDescription Migrates an existing LUN from one RAID level to another. If you attempt tomove to an unsupported RAID configuration for a LUN,

• show unit• set unit• accept unit• expand unit• extend unit• set unit_id• show unit_id• unbind unitnewpage pi72Command reference

refresh isns_entriesDescription Re-registers all iSNS-enabled targets with all iSNS servers.Syntaxrefresh isns_entriesOperands NoneExampleCLI> refr

reset certificateDescription Removes the SSL certificate being used by the management interface andresets the system to using an internally-generated, s

reset controllerDescription Restarts the MSA controller through which you are connecting to the CLI.During this process, detailed progress and status

reset management_loginDescription Resets the management username and password to their factory defaults.This command is only available through the ser

set aclDescription Sets access controls on or off for an iSCSI target.NOTE:When set acl disable is entered, all existing ACL entries on thetarget are

set auto_path_changeDescription for dual-controller configurations only, turns on or off automatic, MSA-basedI/O load balancing. If automatic path chan

set certificateDescription Sets the SSL certificate to be used by the management interface. This isused to load a real certificate in place of the defaul

8

set discoveryDescription Enables or disables SLP and iSNS discovery on an iSCSI target.Syntax set discovery <target> [slp=enable|disable][isns=e

set globalsDescription Sets the expand priority, the read/write ratio, or the system name,depending on the parameters specified.NOTE:All operands are o

[Optional] The write cache as a percentage of the total cache. The valueof <w> must be between 0 and 100, and the sum of the read cache andwrite

set initiatorDescription Sets the profile (operating system) associated with the initiator. If the profileis not set for an initiator, a default profile

set initiator_chapDescription Sets the CHAP secret (password) for an iSCSI initiator in mutual CHAPauthentication.Syntax set initiator_chap <initia

set iscsi_keysDescription Sets iSCSI login parameter keys for an iSCSI target.Syntax set iscsi_keys <target>[<parameter>=<setting>]N

Example 1CLI> set iscsi_keys target1 authentication=chapThe new values were set successfully.Example 2CLI> set iscsi_keys target1 defaultThe new

set isnsDescription Sets the iSNS parameters.Syntaxset isns [service=enable|disable] [server_discov-ery=manual|dhcp|slp] [esi=<esi_port>] [entit

set managementDescription Sets global management interface settings for the system.Syntax set management [disable|enable] [port=<port>][dhcp=<

gateway=<ip>The IP address, in doted notation.dns1=<ip>The IP address, in doted notation.dns2=<ip>The IP address, in doted notation.

About this guideThis document provides information to help you use the HP StorageWorks 1510i Modular Smart Array(MSA1510i) Command Line Interface (CLI

set management_loginDescription Configures thelogin and password used to access the managementinterface. The command prompts you to enter your old user

set portDescription Enables or disables a physical port.NOTE:By default, allportsareenabled.Syntax set port <port> enable|disableOperands <po

set preferred_pathDescription For dual-controller configurations only, this command either sets thecontrollerownership(path)forthespecified LUNs, or, re

set promptDescription Changes the CLI prompt from the default of CLI>.Syntax set prompt <new_prompt>Operands <new_prompt>The text to us

set serviceDescription Configures the management interface network services.Syntax set service <service-name> enable|disable port=<port-number

set snmpDescription Configures the settings for the embedded SNMP agent.NOTE:Although all parameters are optional, at least one parameter must besuppli

set target_chapDescription Sets the CHAP secret (password) used to access an iSCSI target whenCHAP is enabled. To enable CHAP authentication on the ta

set this_controller|other_controllerDescription Sets the baud rate for the CLI serial port on the specified controller.NOTE:When using this command, yo

set this_controller_id|other_controller_idDescription Assigns a name or identifier to the controller.Syntax set this_controller_id <identifier>ors

set unitDescription Enables or disables the array accelerator cache for a specificLUN.Syntax set unit <unit> cache=enable|disableOperands <uni