HP StorageWorks 1510i User Manual

HP StorageWorks 1510i Modular Smart Array Command Line

Interface user guide

active/active ﬁrmware 2.x

Part number: 383074–002

econd edition: May 2008

Legal and notice information

12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license.

The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Intel, Itanium, Pentium, Intel Inside, and the Intel Inside logo are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Microsoft, Windows, Windows XP, and Windows NT are U.S. registered trademarks of Microsoft Corporation. Adobe and Acrobat are trademarks of Adobe Systems Incorporated. Java is a US trademark of Sun Microsystems, Inc.

Aboutthisguide .......................... 9

Intendedaudience...................................... 9

Relateddocumentation.................................... 9

Documentconventionsandsymbols ............................. 10

HPtechnicalsupport.................................... 10

HP installation and conﬁgurationassistance ........................... 11

Subscriptionservice ..................................... 11

HPwebsites......................................... 11

Documentationfeedback ................................... 11

1 CLI setup and overview ....................... 13

CLIsetup......................................... 13

AccessingtheCLIthroughaSecureShell(SSH)connection.................. 13

AccessingtheCLIthroughaTelnetconnection ....................... 14

AccessingtheCLIthroughaserialconnection ....................... 15

CLIOverview....................................... 16

CLIcommandsyntax.................................. 16

Examplecommand ................................ 17

CLI commands in redundant conﬁgurations ........................ 17

CLIhelp ....................................... 17

Examplecommand ................................ 17

2Initialconﬁgurationsequence................... 19

Conﬁgurelogicaldrives .................................. 19

ConﬁguringabasiciSCSIsetup(noaccesscontrolsorauthentication)............... 20

ConﬁguringCHAPauthenticationforiSCSIconnections..................... 21

ConﬁguringAccessControlsforLUNaccess.......................... 22

EnablingiSNSdiscoveryoftheiSCSItarget.......................... 22

EnableSLPdiscoveryoftheiSCSItarget............................ 23

Conﬁgurestaticmanagementsettings............................. 23

3 Command reference . ...................... 25

Commandoverview .................................... 25

CanonicaliSCSItarget................................. 25

Alphabeticallistingofcommands .............................. 26

acceptunit ...................................... 27

addacl_entry..................................... 28

addarp ....................................... 29

addinitiator ..................................... 30

addip........................................ 31

addisns_server .................................... 32

addportal ...................................... 33

addportal_group ................................... 34

addroute....................................... 35

addspare ...................................... 36

addtarget ...................................... 37

addunit ....................................... 38

bindportal...................................... 42

bindportal_group................................... 43

1510i Modular Smart Array Command Line Interface user guide

bindunit....................................... 44

clearperf....................................... 45

deleteacl_entry.................................... 46

deletearp ...................................... 47

deleteinitiator..................................... 48

deleteip....................................... 49

deleteisns_server ................................... 50

deleteportal ..................................... 51

deleteportal_group .................................. 52

deleteroute...................................... 53

deletespare ..................................... 54

deletetarget ..................................... 55

deleteunit ...................................... 56

disablethis_controller|other_controller .......................... 58

download ﬁrmware .................................. 59

expandunit...................................... 65

extendunit...................................... 66

help......................................... 67

locate ........................................ 70

migrateunit...................................... 71

refreshisns_entries................................... 73

reset certiﬁcate .................................... 74

resetcontroller .................................... 75

resetmanagement_login ................................ 76

setacl........................................ 77

setauto_path_change ................................. 78

set certiﬁcate ..................................... 79

setdiscovery ..................................... 80

setglobals ...................................... 81

setinitiator...................................... 83

setinitiator_chap ................................... 84

setiscsi_keys ..................................... 85

setisns........................................ 87

setmanagement.................................... 88

setmanagement_login ................................. 90

setport........................................ 91

setpreferred_path................................... 92

setprompt ...................................... 93

setservice ...................................... 94

setsnmp....................................... 95

settarget_chap .................................... 96

setthis_controller|other_controller ............................ 97

setthis_controller_id|other_controller_id ......................... 98

setunit........................................ 99

setunit_id ...................................... 100

showacl_entry .................................... 101

showadu_page.................................... 102

showarp....................................... 103

showauto_path_change ................................ 104

showbox....................................... 105

showcacheinfo .................................... 106

show certiﬁcate .................................... 107

showdiscovery .................................... 108

showdisks ...................................... 109

showdrive_report ................................... 110

showeventlog..................................... 111

showglobals ..................................... 112

showinitiator..................................... 113

showip ....................................... 114

showiscsi_keys .................................... 115

showisns....................................... 116

showisns_server.................................... 117

showmanagement................................... 118

showmib2...................................... 119

showperf ...................................... 120

showport ...................................... 121

showportal...................................... 122

showportal_group................................... 123

show proﬁle ..................................... 124

showpreferred_path.................................. 125

showproxystats.................................... 126

showroute ...................................... 127

showservice ..................................... 128

showsnmp...................................... 129

showtarget...................................... 130

showtaskstats..................................... 131

showtech_support................................... 132

showtgt_stats..................................... 133

showthis_controller|other_controller ........................... 134

showunit....................................... 135

showunit_id ..................................... 137

showversion ..................................... 138

startperf....................................... 139

stopperf....................................... 140

unbindportal..................................... 141

unbindportal_group.................................. 142

unbindunit...................................... 143

A Storage overview . . . ..................... 145

Arraysandlogicaldrives.................................. 145

Fault-tolerancelevels.................................... 146

RAID0—nofaulttolerance ............................... 147

RAID1+0—drivemirroring ............................... 147

RAID5—distributeddataguarding............................ 148

RAID6—advanceddataguarding............................ 149

ComparisonofRAIDMethods................................ 149

ChoosingaRAIDlevel ................................... 150

Index .............................. 151

1510i Modular Smart Array Command Line Interface user guide

Figures

1 2 3 4

Multiplephysicaldrives(D1,D2,andD3)inasystem ................ 145

Multiple physical drives (D1, D2, and D3) conﬁgured into one logical drive (L1) . . . . . 145

Data striping (S1-S4) and data blocks (B1-B12) on multiple physical drives (D1, D2, D3) . . 146 Two arrays (A1, A2) containing ﬁve logical drives (L1 through L5) spread across ﬁve physical

drives (D1 th

RAID1array,withtwophysicalharddrives(D1,D2)................. 147

roughD5) ............................. 146

RAID 1+0 arr

RAID 5 array, with three physical hard drives (D1, D2, D3) showing distributed parity

information(Px,y)................................ 148

RAID 6 array, with four physical hard drives (D1, D2, D3, D4) showing distributed parity

information(Px,y)(Qx,y)............................. 149

ay,witheightphysicalharddrives(D1throughD8) ........... 148

Tables

Documentconventions.............................. 10

CLIspecialkeys ................................ 16

RAID0features ................................ 147

RAID1,RAID1+0features............................ 148

RAID5features ................................ 149

RAID 6 featur

SummaryofRAIDmethods............................ 150

es ................................ 149

Choosing a R

AIDlevel ............................. 150

1510i Modular Smart Array Command Line Interface user guide

About this guide

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

Intended audi

This guide is intended for users familiar with iSCSI storage networks and, in particular, with RFC3720. If you prefer to use a Graphical User Interface (GUI), consider using the HP Storage Management Utility (SMU), described in the HP Storage Management Utility user gu ide.

ence

Document conventions and symbols

Table 1 Documen

Convention

Blue text: Table 1 Cross-reference links and e-mail addresses Blue, underlined text: http://www.hp.com

Bold text

Italic text Text emphasis

Monospace text

Monospace, italic text

Monospac

e, bold text

t conventions

Element

Website addresses

• Keys that are pressed

• Text typed into a GUI element, such as a box

• GUI elements that are clicked or selected, such as

menu and list items, buttons, tabs, and check boxes

• File and directory names

• System output

• Code

• Commands, their arguments, and argument values

• Code variables

• Command variables

Emphasized monospace text

WARNING!

Indicates that failure to follow directions could result in bodily harm or death.

CAUTION:

Indicates that failure to follow directions could result in damage to equipment or data.

IMPORTANT:

Provides clarifying information or speciﬁc instructions.

NOTE:

Provides a

dditional information.

TIP:

Provides helpful hints and shortcuts.

HP technical support

For worldwide technical support information, see the HP support website: http://www.hp.com/support. Before co

• Product model names and numbers

• Technical support registration number (if applicable)

• Product

ntacting HP, collect the following information:

serial numbers

About this guide

• Error messages

• Operating system type and revision level

• Detailed questions

HP installation and conﬁguration assistance

Storage management and networking knowledge is required to successfully install this product. If you are not familiar with installing and conﬁguring storage array systems, HP can install your system for you. For more information, access the HP Services website: h Portfolio banner, select Infrastructure Services > Network Storage Services.

Depending on your needs, different levels of assistance are available, such as:

• Storage depl

• Physical installation

• Logical disk design and conﬁguration

• Service pla

• Service deployment

• Installation Veriﬁcation Testing (IVT)

• Customer o

oyment

nning

rientation

ttp://www.hp.com/go/services. Under the Services

Subscription service

HP recommends that you register your product at the Subscriber’s Choice for Business website:

ttp://www.hp.com/go/e-updates.

After registering, you will receive e-mail notiﬁcation of product enhancements, new driver versions, ﬁrmware updates, and other product resources.

HP websites

For addi

•h

•http://www.hp.com/go/storage

•http:/

•http://www.hp.com/support/manuals

•http://www.hp.com/support/downloads

tional information, see the following HP websites:

ttp://www.hp.com

/www.hp.com/service_locator

Documentation feedback

HP welcomes your feedback. To make comments and suggestions about product documentation, please send a message to

storagedocsFeedback@hp.com. All submissions become the property of HP.

1510i Modular Smart Array Command Line Interface user guide

About this guide

1CLIsetupandoverview

The Command Line Interface (CLI) is used to conﬁgure and manage the array controller and its storage. Tasks include conﬁguring logical storage units (LUNs), limiting access to storage, viewing system and component information, conﬁguring iSCSI elements, and setting up the management interface.

The CLI can also be used to display system setup information and status, and, provide information on devices that are attached to the controller.

CLI setup

You can access the CLI in three ways:

• Accessing the CLI through a Secure Shell (SSH) connection

•Accessingt

• Accessing the CLI through a serial connection

NOTE:

For information about planning for and installing the MSA, connecting the hardware, and obtaining the default IP address of the management port, see the

installat

ion and user guide

he CLI through a Telnet connection

HP StorageWorks 1510i Modular Smart Array

Accessing the CLI through a Secure Shell (SSH) connection

SSH provides the most secure way to access the CLI over a network. Data transmitted through SSH is encrypted. Before using SSH, you must download and install an SSH connection utility. HP recommends using a utility called PuTTY. The following procedure describes using PuTTY.

1. If necessary, download and install the PuTTY SSH connection utility. Use an Internet search engine

to locate the latest version of PuTTY.

1510i Modular Smart Array Command Line Interface user guide

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 IP address) ﬁeld.

4. Verify that the SSH radio button is selected.

5. Click Open.

The SSH shell opens and you are prompted to log on.

6. Enter your username and password.

NOTE:

When using SSH, Telnet, or the HP Storage Management Utility (SMU) to connect to the MSA1510i management port, you are required to log on. The factory default settings for username and password are both root.Theﬁrst time you log in to the MSA1510i using the default username and password, you are immediately prompted to enter a new username and password. Follow the prompts to set the new username and password. To subsequently changetheusernameandpasswordfromtheCLI,usetheset management_login command.

Accessing the CLI through a Telnet connection

CAUTION:

The Telnet protocol is not a secure method of transmitting data over a network. Because Telnet does not encrypt data, anyone with the proper knowledge and tools can read information being sent over the network. For this reason, HP recommends that you use SSH to connect to the MSA1510i over a network, or use a serial connection to connect to the MSA1510i directly.

NOTE:

Telnet is disabled by default. To enable Telnet, use the SMU. For more information, see the

Management Utility user guide

CLI setup and overview

HP Storage

1. Ensure that the Telnet interface is enabled. To enable Telnet, use the SMU. For more information, see

the HP Storage Management Utility user guide.

2. FromanyPCthatisconnectedtothesameLANastheMSA,clickStartRun to open the Run

dialog box.

3. Enter the following command:

telnet [<ip_address>] where

[<ip_address>] is the IP address of the MSA management port.

The Telnet shell opens and you are prompted to log on.

4. Enter your username and password.

NOTE:

When using SSH, Telnet, or the HP Storage Management Utility (SMU) to connect to the MSA1510i management port, you are required to log on. The factory default settings for

root

usernameandpasswordareboth default username and password, you are immediately prompted to enter a new username and password. Follow the prompts to set the new username and password. To subsequently change the username and password from the CLI, use the set management_login command.

.Theﬁrst time you log in to the MSA1510i using the

Accessing the CLI through a serial connection

Any terminal emulator program may be used to access the CLI, but the following instructions describe using Windows HyperTerminal.

1. From the front of the MSA, connect one end of the custom serial cable (included in the shipping

carton of the MSA) to the serial port of the host computer. Connect the other end to the RJ-45Z adapter on an MSA controller.

NOTE:

In dual-controller conﬁgurations, tasks can be performed through either MSA controller.

NOTE:

An additional or replacement custom serial cable can be ordered using part number 259992-001.

1510i Modular Smart Array Command Line Interface user guide

2. Open your terminal emulation software. The following instructions demonstrate using HyperTerminal:

a. Click StartRun to open the Run dialog box. Type hypertrm.exe, and then click OK.When

accessed for the ﬁrst time, the New Connection dialog box is displayed.

b. In the New Connection dialog box, type a name to associate with the connection between the

controller and the host server, and then click OK. The Connect To dialog box is displayed.

c. In the Connect To dialog box, expand the Connect using drop-down box, select the appropriate

COM port, and then click OK.TheCOMPropertiesdialogboxisdisplayed.

d. In the COM1 Properties dialog box, enter the following settings, and then click OK.

Option Setting

Bits per Second Data bits Parity Stop bits Flow contr

e. On the CLI Session screen, press Enter several times to display the command prompt (CLI>).

CLI Overview

Command strings are entered at the CLI prompt (CLI>). Commands must use a speciﬁc, preset syntax. After a declarative command is entered and executed, the results are displayed at the CLI prompt.

When using the CLI, the following keystrokes have special functions:

Table 2 CLI special keys

Keyboard Keys

Ctrl+B left arrow Moves the cursor back one character Ctrl+F right arrow

Ctrl+P

Ctrl+N down arrow

Arrow Key

up arrow

19200 8 None 1 None

Function

Moves the cursor forward one character Recalls the previous command in the

command buffer Recalls the next command in the command

buffer

CAUTION:

The CLI uses a zero-based numbering system. For example, LUN numbers begin with 0.

CLI command syntax

The following syntax describes the basic command format used for all CLI commands:

verb noun <operand 1> <operand 2> ... <operand n>

The following conventions apply to all CLI commands:

• A basic command includes a word or phrase used to instruct the controller. Commands usually

containaverbwithanoun. EveryCLIcommandmustbeginwithabasiccommand.

• CLI command strings include the basic command plus speciﬁc command parameters. Some

parameters are required; others are optional.

• CLI commands are entered at the CLI prompt.

CLI setup and overview

• Commandsarenotcasesensitiveandmustbetypedinfull.

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

ﬁt on one line of the CLI, the command wraps to the next line on the screen. The maximum command length is 255 characters.

Example comma

The following

add unit 0 data=”disk101-disk103” raid_level=0

The basic command is add unit. The operands are:

• 0

• data=”disk101-disk103”

• raid_level=0

Some CLI comma string is considered invalid. The syntax of the parameter value is uniquely deﬁned for each CLI command, but must be less than 20 alphanumeric characters.

Some CLI comm operand is av

command has three portions: the basic command and three operands:

nds require an operand. If operands are required but are not entered, the CLI command

ands support operands that modify the command, but are not required. If a modifying

ailable but not used, a default value is used.

CLI commands in redundant conﬁgurations

When a system has two controllers, the same ﬁrmware image is run on both controllers. The two controllers communicate with each other through a PCI bus called the inter-controller link (ICL). Each controller has a serial port and has a CLI available to users who connect the serial port to a serial terminal.

Some CLI commands are entered from one controller's CLI prompt but are for the other controller to execute. Command syntax instructs the controller to accept user input, pass the command to the other controller, and then display the result.

The following keywords are used in the CLI to indicate a speciﬁc controller:

• this_controller—refers to the controller that the CLI is connected to.

• other_controller—refers to the other controller in the MSA.

CLI help

Help commands can be used to display helpful information about CLI commands. Displayed information may include a brief deﬁnition, required command syntax, available operands, the number of characters for a comm

The basic command is help. If a noun or verb is also entered, the display is limited to information about that speciﬁc command. If help is entered without a limiting noun or verb, the displayed lists all possible command v

Example command

To see a list of all possible command verbs and command nouns, enter help without a command verb or noun.

help To see a list of all commands, use the display_all operand:

CLI> help display_all

To see information about a speciﬁc command, enter help followed by the command in question. The following example displays information about the add unit command.

CLI> help add unit

and option value, or a list of allowed/disallowed characters.

erbs and then all possible command nouns.

1510i Modular Smart Array Command Line Interface user guide

CLI setup and overview

2 Initial conﬁguration sequence

TheMSAcanbecompletelyconﬁguredusingtheCLI.IfyouwanttousetheHPStorageManagement Unit (SMU), but the factory default management network settings do not work in your environment, see

Conﬁguring static management settings.

The example commands shown in this chapter are provided as a general reference and may differ from the commands needed for your conﬁguration. The examples show the command that is typed in at the CLI prompt and the system response. For more information on the available options for each command, see Command reference in this guide or the CLI online help.

When conﬁguring the MSA for the ﬁrst time, use the following sequence:

•Conﬁgure logical drives

•Conﬁgure a basic iSCSI setup

•Conﬁgue CHAP authentication for iSCSI connection for iSCSI connections

•Conﬁgure Access Controls for LUN access

• EnableiSNSdiscoveryoftheiSCSItarget

• Enable SLP discovery of the iSCSI target

•Conﬁguring static management settings

Conﬁgure logical drives

Before creating any logical drives, ensure that all disk enclosures are physically connected to the MSA, so that the disks are available for conﬁguration.

1. [Optional] Verify that the disks are detected by the array controller using the show disks command:

CLI> sho

Disk List: (box,bay) (B:T:L) Size Speed Units

Enclosu

Disk101 (1,01) (0:03:01) 250.0GB 160 MB/s none

Disk102 (1,02) (0:03:02) 250.0GB 160 MB/s none

Disk103 (

Disk104 (1,04) (0:03:04) 250.0GB 160 MB/s none

Disk105 (1,05) (0:03:05) 250.0GB 160 MB/s none

Enclosur

Disk207 (2,07) (1:08:00) 72.8GB 160 MB/s none

Disk208 (2,08) (1:09:00) 72.8GB 160 MB/s none

Disk209 (

Disk210 (2,10) (1:11:00) 36.4GB 160 MB/s none

w disks

re 1: SATA (0:03:00) PROLIANT 8LCE 1.16

1,03) (0:03:03) 250.0GB 160 MB/s none

e 2: SCSI (1:06:00) PROLIANT 4LEE JB4F

2,09) (1:10:00) 72.8GB 160 MB/s none

1510i Modular Smart Array Command Line Interface user guide

2. Conﬁgure a logical drive on a set of disks using the add unit command:

CLI> add unit 0 raid_level=5 data=disk101-disk105 size=100gb

Logical Unit size = 102398 MB

RAID overhead = 25597 MB

Total space occupied by new unit = 127995 MB

Free space left on this volume: = 1064201 MB

Unit 0 is created successfully.

3. Repeat the add unit command as needed, to conﬁgure the storage in to multiple logical drives.

Conﬁguring a basic iSCSI setup (no access controls or authentication)

The example commands in this section use the simplest syntax and many default parameters. You should provide additional command arguments as required.

1. Create an IP address for iSCSI data trafﬁcusingtheadd ip command:

CLI> add ip SA0

The IP address has been added successfully.

2. Repeat the add ip command as required to conﬁgure addresses on multiple ports. Ports on the

primary controller are named SA0 and SA1. If you have a redundant array controller, the ports are named SB0

3. Use the add portal command to create an iSCSI portal that initiators will use to connect to the system:

CLI> add portal 20.20.20.5

The portal wa

Alias: portal1

4. Make a note of the portal alias, which is used in future commands to refer to the portal.

5. Create a por

CLI> add portal_group

The portal group was added successfully.

tal group using the add portal_group command:

20.20.20.5

and SB1.

s added successfully.

Alias: pg1

Tag: 0

6. Make a note of the portal group alias for use in future commands. Also make a note of the default

tag assigne

7. Create an iSCSI target using the add target command:

CLI> add target

The iSCSI ta

Name: iqn.1986-03.com.hp.storage.msa1510i.sga043600g.target1

Alias: target1

8. Make a note

9. Bind the portal to the portal group using the bind portal command:

CLI> bind portal portal1 pg1

The portal

Initial conﬁguration sequence

d to the portal group.

rget was added successfully.

of the iSCSI target node name and alias for use in future commands.

was bound successfully to the portal group.

10. Use the bind portal_group to bind the portal group to the iSCSI target just created:

CLI> bind portal_group pg1 target1

The portal group was bound successfully to the target.

11 . Bind logical drives to the iSCSI target using the bind unit command:

CLI> bind unit 0 target1 1

On Target target1:

LUN 1 mapped to Unit 0

Alias: lun1t1

12. Repeat the bind unit command as required to bind several logical drives to the target.

13 . Use the add initiator command to create an entry for the iSCSI initiator to enable it to access the

system:

CLI> add initiator iqn.1991-05.com.microsoft:myini.domain.com

The initiator was added successfully.

Name: iqn.1991-05.com.microsoft:myini.domain.com

Alias: initiator1

NOTE:

The iSCSI node name of your initiator can be found under the Initiator Settings tab of the Microsoft iSCSI Initiator control panel window.

Conﬁguration of a basic setup with a single iSCSI target, portal, and initiator is now complete. The initiator has full access to the LUNs on the target and is not required to provide any authentication information to log in.

Conﬁguring CHAP authentication for iSCSI connections

NOTE:

The steps in this section assume that you already have a basic iSCSI setup conﬁgured.

1. Set up a target CHAP secret (password) for one-way authentication using the set target_chap

command:

CLI> set target_chap target1 mychapsecret123

The CHAP settings have been applied.

2. Activate CHAP authentication for the target using the set iscsi_keys command:

CLI> set iscsi_keys target1 authentication=chap

The new values were set successfully.

3. [Optional] Set up an initiator CHAP secret for mutual authentication using the set initiator_chap

command:

CLI> set initiator_chap initiator1 inichapsecret123

The CHAP settings have been applied.

1510i Modular Smart Array Command Line Interface user guide

Conﬁguring Access Controls for LUN access

NOTE:

The steps in this section assume that you already have a basic iSCSI setup conﬁgured.

1. Use the set acl command to enable Access Controls on the target:

CLI> set acl target1 on

Access Controls Enabled

on Target target1

2. Decide whether to grant the initiator access to all LUNs on the target, or to a speciﬁcLUN,and

then do one of the following: To grant the initiator access to all LUNs on the target, use the add acl_entry command:

CLI> add acl_entry initiator1 target=target1

Allowed access to all LUNs

on Target target1

by Initiator initiator1

To grant the initiator access to a speciﬁcLUN,usetheadd acl_entry command:

CLI> add acl_entry initiator1 lun=lun1t1

Allowed Initiator initiator1

access to LUN lun1t1

NOTE:

If more LUNs are added to the target, repeat the add acl_entry command as required to include them.

Enabling iSNS

NOTE:

The steps in this section assume that you already have a basic iSCSI setup conﬁgured.

To set up iSNS, you must ﬁrst choose the method of discovering iSNS servers. Next, you must enable iSNS on the iSCSI target.

• To use DHCP discovery of iSNS servers:

a. Bydefault,theMSA1510iusesDHCPtodiscoveriSNSservers. b. Use the set discovery command to enable iSNS discovery on the iSCSI target.

CLI> set discovery target1 isns=enable iSNS enabled

• To use SLP discovery of iSNS servers:

a. Use the set isns command to change the iSNS server discovery mode:

CLI> set isns server_discovery=slp iSNS parameters set.

b. Use the set discovery command to enable iSNS discovery on the iSCSI target.

CLI> set discovery target1 isns=enable

discovery of the iSCSI target

Initial conﬁguration sequence

iSNS enabled

• To manually add iSNS servers

a. Use the set isns command to change the iSNS server discovery mode:

CLI> set isns server_discovery=manual iSNS parameters set.

b. Use the add isns_server command to add the IP address of the iSNS server:

CLI> add isns_server 20.20.20.26 The iSNS server was added successfully. Alias: isns1

c. Use the set discovery command to enable iSNS discovery on the iSCSI target.

CLI> set discovery target1 isns=enable iSNS enabled

Enable SLP disc

NOTE:

Steps in this section assume that you already have a basic iSCSI setup conﬁgured.

Use the set discovery command to enable SLP discovery on the iSCSI target:

CLI> set discovery target1 slp=enable

SLP enabled

overy of the iSCSI target

Conﬁgure static management settings

To access the MSA1510i management functionality over a network that does not use DHCP, and on which your management host cannot access the default zeroconf* IP address, you must set up a static IP address.

1. Conﬁgure management to use a static IP address using the set management command:

CLI> set management dhcp=disable ip=192.168.1.10/255.255.255.0

gateway=192.168.1.1

2. [Optional] If you have not done so already, conﬁgurealoginandpasswordforaccessing

management functionality using the set management_login command: CLI> set management_login <user_ID><password> where <user_ID>and<password> are your own unique settings.

3. [Optional] Switch management functionality to a different physical port using the set management

command:

CLI> set management port=MA1

1510i Modular Smart Array Command Line Interface user guide

4. [Optional] If required, enable access to the CLI via Telnet (not recommended) using the set service

command:

CLI> set service telnet on

CAUTION:

TheTelnetprotocolisnotasecuremethodoftransmittingdataoveranetwork.Because Telnet does not encrypt data, anyone with the proper knowledge and tools can read information being sent over the network. For this reason, HP recommends that you use SSH to connect to the MSA1510i over a network, or use a serial connection to connect to the MSA1510i directly.

Initial conﬁguration sequence

3 Command reference

Command overview

TheCLIusesthefollowingbasictypesofcommands:

add

bind

delete

help

reset

set

show

NOTE:

For a complet

help display_

NOTE:

Some CLI commands for iSCSI objects refer to an text string that refers to an object. In some cases, when an object is being added, if the alias is not speciﬁed, it is automatically generated by the CLI. In other cases, you must specify the alias.

elistofavailablecommandtypes,usethefollowinghelp command:

all

Creates new conﬁguration elements. Creates assoc Removes conﬁguration elements. Displays all possible commands or a detailed description of a speciﬁed

command. Restores the d Changes the value of conﬁguration elements. Displays detailed information about a conﬁguration element or all conﬁguration

elements in a table

iations between iSCSI elements.

efault values of conﬁguration elements.

alias

.Thealiasisaneasy-to-remember16-character

Canonical iSCSI target

The predeﬁned iSCSI target alias refers to the canonical iSCSI target, which is used during discovery. It can be used to conﬁgure authentication for discovery sessions.

CLI commands that can refer to the canonical iSCSI target are set iscsi_keys, show iscsi_keys,andset

target_chap. Other commands produce an error if the canonical target is speciﬁed. For example,

it is not po

newpage pi

ssible to delete the canonical target.

1510i Modular Smart Array Command Line Interface user guide

Alphabetical l

isting of commands

The following M

accept unit, page 27 add acl_entry, page 28 add arp,page29 add initiator, page 30 add ip, page 31 set target_chap, page 96 add isns_server,page32 set this_controller|other_controller,page97 add portal,page33 set this_controller_id, page 98 add portal_group,page34 add route, page 35 set unit_id, page 100 add spare, page 36 show acl_entry, page 101 add target, page 37 show adu_page, page 102 add unit, page 38 show arp, page 103 bind portal, page 42 show auto_path_change,page104 bind portal_group, page 43 show box,page105 bind unit,p clear perf,page45 show certiﬁcate, page 107 delete acl_entry, page 46 show discovery, page 108 delete arp,page47 show disks, page 109 delete initiator, page 48 show drive_report, page 110 delete ip, page 49 show eventlog, page 111 delete isns_server,page50 show globals, page 112 delete portal,page51 show initiator, page 113 delete por delete route,page53 show iscsi_keys, page 115 delete spare, page 54 show isns, page 116 delete target,page55 show isns_server, page 117 delete unit, page 56 show management, page 118 disable this_controller|other_controller, page 58 show mib2, page 119 download ﬁrmware, page 59 show perf, page 120 expand unit, page 65 show port, page 121 extend unit, page 66 show portal,page122 help, page 67 show portal_group,page123 locate, page 70

migrate unit, page 71 refresh isns_entries, page 73 reset certiﬁcate, page 74 reset controller, page 75 show service, page 128 reset management_login, page 76 show snmp, page 129

set acl, page 77 show target,page130 set auto_path_change, page 78 show taskstats, page 131 set certiﬁcate, page 79 set discovery,page80 show tgt_stats,page133 set globals, page 81 set initiator, page 83 set initiator_chap, page 84 show unit_id, page 137 set iscsi_keys, page 85 show version, page 138 set isns, page 87 set management, page 88 set management_login,page90 unbind portal, page 141 set port, page 91

SA1510i CLI commands are included in this section:

set preferred_path, page 92 set prompt, page 93 set service,page94 set snmp,page95

set unit,page99

age 44

tal_group,page52

show cacheinfo, page 106

show ip,pa

show proﬁle, page 124 show preferred_path,page125 show pro show route, page 127

show tech_support,page132

show this_controller/other_controller, page 134 show unit, page 135

start perf, page 139 stop perf, page 140

ge 114

xystats,page126

newpage pi

Command reference

accept unit

Description Changes the state of the unit back to VOLUME_OK. Use this command to

Syntax accept unit [<unit_number>]

Operands <unit_number>

Example

CLI> accept units NOTE: Accept Unit will cause a temporary LUN path change to this controller. [1970-01-04 15:46:39] SetPreferredPath start... owner=1, change_map=0x0, lun_to_ ctlr_map=0xFFFFFFFF Media exchange completed successfully.

CLI> [1970-01-04 15:46:40] Quiescing host I/O for LUN map 0xFFFFFFFF... Host/pr oxy I/O quiesced. [1970-01-04 15:46:40] Quiescing cache (quick)... Cache quiesced. [1970-01-04 15:46:40] Quiescing background I/O... Background quiesced. [1970-01-04 15:46:40] Flipping ownership(s)... change_map=0x0, lun_to_ctlr_map=0 xFFFFFFFF [1970-01-04 15:46:40] Processing work while quiesced... work processing complete . [1970-01-04 15:46:40] Resuming I/O... I/O Resumed.

accept media exchange on a unit previously marked as failed. The accept unit and accept units commands are identical in functionality.

accept units

[Optional] The number of the unit to be reset. If no value is entered, all units are res

et.

HP StorageWorks 1510i User Manual

Contents

About this guide

Related documentation

Document conventions and symbols

HP technical support

Subscription service

HP websites

Documentation feedback

1CLIsetupandoverview

CLI setup

Accessing the CLI through a Secure Shell (SSH) connection

Accessing the CLI through a serial connection

CLI Overview

CLI command syntax

CLI help

3 Command reference

Command overview