manualshive.com logo in svg

HP StorageWorks Modular Smart Array 1000 cs, User Manual, Page: 21 / 64

Share
Download
HP StorageWorks Modular Smart Array 1000 cs User Manual Download Page 21

Using the CLI

21

Modular Smart Array 1000/1500 cs Command Line Interface User Guide

Displaying a list of all available commands

To see a list of all commands:

Example command 

CLI> HELP DISPLAY_ALL

Command options 

DISPLAY_ALL

—a list of all currently supported commands will be displayed.

Example command output 

CLI> HELP DISPLAY_ALL

CLI>

Displaying list of all currently supported CLI commands:
?

help

add unit

add connection

add acl

add spare

delete unit

delete connection

delete acl

delete spare

migrate unit

expand unit

extend unit

accept unit

accept units

rename connection

set unit_id

set this_controller_id

set other_controller_id

set globals

set acl

set connection

set prompt

set unit

locate disk

locate unit

locate bus

locate box

locate all

locate cancel

show connections

show unit

show units

show unit_id

show this_controller

show other_controller

show version

show disks

show globals

show acl

show profile

show tech_support

Summary of Contents for StorageWorks Modular Smart Array 1000 cs

Page 1: ...which is used to configure and manage the storage on the Modular Smart Array 1000 MSA1000 and the Modular Smart Array 1500 Controller Shelf MSA1500 cs Note Documentation titled HP StorageWorks Modular SAN Array and HP StorageWorks Modular Smart Array both refer to HP StorageWorks MSA products Throughout this document the term MSA is used when referring to both the MSA1000 and the MSA1500 cs ...

Page 2: ...en consent of Hewlett Packard The information contained in this document is subject to change without notice Compaq Computer Corporation is a wholly owned subsidiary of Hewlett Packard Company Microsoft MS DOS MS Windows Windows and Windows NT are U S registered trademarks of Microsoft Corporation Hewlett Packard Company shall not be liable for technical or editorial errors or omissions contained ...

Page 3: ... 9 HP technical support 10 1 Overview and Setup 11 Overview 12 CLI commands in redundant configurations 12 CLI command syntax 13 Overview of CLI storage configuration procedures 14 Setup 15 2 Using the CLI 19 Help commands 20 Displaying a list of all basic commands 20 Displaying a list of all available commands 21 Displaying help for a specific command 22 Display commands 23 Viewing physical disk ...

Page 4: ...ompt 34 LUN management commands 35 Flashing LEDs locating hard drives 35 Creating LUNs 38 Assigning a name or ID to a LUN 43 Adding a spare to a LUN 43 Deleting LUNs 44 Deleting spares 45 Recognizing a failed unit 45 Modifying arrays and LUNs 46 Server connection commands 50 Naming a connection 51 Setting the connection profile 52 Changing the name of a connection 53 Changing the HBA of a connecti...

Page 5: ...e Interface User Guide About This Guide About this Guide About this Guide This user guide provides information to help you use the MSA Command Line Interface CLI About This Guide topics include Overview page 6 Conventions page 6 Getting help page 9 ...

Page 6: ...d documentation Intended audience This book is intended for use by administrators with a moderate amount of SAN management experience Related documentation In addition to this guide refer to the HP StorageWorks MSA Installation Guide that ships with this system Conventions Conventions consist of the following Document conventions Text symbols Equipment symbols ...

Page 7: ...cates that failure to follow directions could result in damage to equipment or data Note Text set off in this manner presents commentary sidelights or interesting points of information Table 1 Document Conventions Element Convention Cross reference links Figure 1 Key and field names menu items buttons and dialog box titles Bold File names application names and text emphasis Italics User input comm...

Page 8: ... symbols indicates a network interface connection WARNING To reduce the risk of electrical shock fire or damage to the equipment do not plug telephone or telecommunications connectors into this receptacle Any surface or area of the equipment marked with these symbols indicates the presence of a hot surface or hot component Contact with this surface could result in injury WARNING To reduce the risk...

Page 9: ...ll have a question after reading this guide contact an HP authorized service provider or access our web site http www hp com HP storage web site The HP storage web site has the latest information about this and other HP storage products Access the primary storage web site on the Internet at http www hp com country us eng prodserv storage html From this web site select the appropriate product or so...

Page 10: ...ded or monitored Outside North America call technical support at the nearest location Telephone numbers for worldwide technical support are listed on the HP web site under support http www hp com Be sure to have the following information available before calling Technical support registration number if applicable Product serial numbers Product model names and numbers Applicable error messages Oper...

Page 11: ...provide information on devices that are attached to the controller Note The CLI is available for all supported operating systems The CLI is accessed through a host computer connected to the serial port of an MSA1000 Controller Some CLI configuration and management tasks include configuring storage units LUNs setting the addressing mode limiting access to storage and viewing information on MSA comp...

Page 12: ...ler has a serial port and has a CLI available to the 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 ...

Page 13: ...mple command has three portions the basic command plus two command options Basic command add unit The basic command includes a word or phrase used to instruct the controller Commands usually contain a verb with a noun Every CLI command must begin with a basic command Command options 0 data disk101 disk103 raid_level 0 An option is defined as words or phrases listed after the basic command that sup...

Page 14: ... array controller See Setting the controller ID on page 33 for instructions 2 Create the LUNs See LUN management commands on page 35 for command descriptions Note In addition to creating the LUNs OpenVMS environments must assign a unique ID number to each LUN See Assigning a name or ID to a LUN on page 43 for instructions 3 Enter connection information about the HBAs with access to the MSA See Ser...

Page 15: ...ping carton of the MSA An additional or replacement custom serial cable can be ordered using part number 259992 001 MSA adapter RJ 45Z Host server adapter serial port on the host server 3 Set up a terminal emulator To set up HyperTerminal a Access HyperTerminal If you need to load HyperTerminal on the server navigate the Web and download the latest version If HyperTerminal is already loaded on the...

Page 16: ...inal New Connection dialog box c In the New Connection dialog box type a name to associate with the connection between the controller and the host server Then click OK The Connect To dialog box is displayed See Figure 2 for an example of the Connect To dialog box Figure 2 HyperTerminal Connect To dialog box ...

Page 17: ...ox is displayed Figure 3 is an example of the COM1 Properties dialog box Figure 3 HyperTerminal COM1 Properties dialog box e In the COM1 Properties dialog box enter the following settings also listed in Figure 3 and click OK Bits per Second 19200 Data bits 8 Parity None Stop bits 1 Flow control None The CLI input screen is displayed f In the CLI session screen press Enter several times to display ...

Page 18: ...Overview and Setup 18 Modular Smart Array 1000 1500 cs Command Line Interface User Guide ...

Page 19: ... storage and viewing information about the configuration This chapter contains the following information and is organized in the order in which the commands are used when configuring a new MSA installation Help commands page 20 Display commands page 23 Array controller configuration commands page 32 LUN management commands page 35 Server connection commands page 50 Access control list commands pag...

Page 20: ...The basic command is HELP but can be modified with command options to more narrowly define the request Displaying a list of all basic commands If the HELP command is entered without a limiting command verb or noun the CLI will display the available basic commands Example command CLI HELP CLI Note HELP and are interchangeable Example command output CLI HELP Specify command word Possible command ver...

Page 21: ...tly supported CLI commands help add unit add connection add acl add spare delete unit delete connection delete acl delete spare migrate unit expand unit extend unit accept unit accept units rename connection set unit_id set this_controller_id set other_controller_id set globals set acl set connection set prompt set unit locate disk locate unit locate bus locate box locate all locate cancel show co...

Page 22: ... display helpful information about that command Example command CLI HELP ADD ACL Command options ADD ACL the specific command about which to display help Example command output CLI HELP ADD Specify command noun Additional command example and output CLI HELP ADD ACL add acl connection name wwpn xxxxxxxx xxxxxxxx unit adds access rights for one connection to one or all units CLI Possible command nou...

Page 23: ... complete system information with one command Each of these procedures uses the SHOW command which displays the configuration of the MSA These procedures are discussed in the following paragraphs Viewing physical disk information The following information can be displayed for the disks Disk number Enclosure box and bay number Enclosure bus number and ID Disk size LUN in which the disk is used Disk...

Page 24: ... 36 4GB 160 MB s none Disk204 2 04 2 03 00 36 4GB 160 MB s none Disk205 2 05 2 04 00 36 4GB 160 MB s none Disk206 2 06 2 05 00 36 4GB 160 MB s none Disk207 2 07 2 06 00 36 4GB 160 MB s none CLI SHOW DISKS Disk List box bay B T L Size Speed Units Enclosure 1 SATA SATA BULK 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 1 03 0 03 03 250 0GB 160 MB s non...

Page 25: ...ecific LUN CLI SHOW UNIT 1 Example CLI response Unit 1 In PDLA mode Unit 1 IS LUN 2 In VSA mode Unit 1 is LUN 1 Unit Identifier Device Indentifier 600805F3 00006B20 AE277D4B B0D100F7 Cache Status Enabled Max Boot Partition Disabled Volume Status VOLUME OK Parity Init Status 3 complete 5 Data Disk s used by lun 1 Disk107 Box 1 Bay 07 SCSI bus 0 SCSI id 8 Disk108 Box 1 Bay 08 SCSI bus 1 SCSI id 0 Di...

Page 26: ... Command options 0 the number of the LUN to display Example CLI response Unit 0 ABC ABC represents the assigned user defined name Viewing controller settings The following information can be displayed for the controllers Controller identifier Controller hardware and software versions SCSI compliance information Controller SCSI ID Redundancy information Host Port Information Controller cache config...

Page 27: ...ode Not Redundant No Failure Device Port SCSI address 6 Terminal speed for the CLI is set to 19200 Host Port_1 REPORTED PORT_ID YYYYYYYYY YYYYYYYYY PORT_1_TOPOLOGY F_Port Cache 128 megabytes read cache 128 megabytes write cache Version 2 Cache is GOOD and Cache is enabled No unflushed data in cache Battery Module 1 is fully charged and turned off Controller Up Time 5 Days 06 Hours 01 Minutes 51 Se...

Page 28: ...write cache settings Power supply and EMU temperatures To view information about the global settings of the controller Basic command SHOW GLOBALS Example command CLI SHOW GLOBALS Example CLI response CLI SHOW GLOBALS Global Parameters System Name ABC Rebuild Priority high Expand Priority high Total Cache 256MB 50 Read Cache 128 MB 50 Write Cache 128 MB Temperature EMU 30 Celsius 86 Farenheit PS1 4...

Page 29: ...information can be displayed for the controllers Firmware version Hardware revision Internal EMU Firmware revision To view version information about the MSA Basic command SHOW VERSION Example command CLI SHOW VERSION Example CLI response CLI SHOW VERSION Firmware version 4 24 build 122 Hardware revision 7 Internal EMU Rev 1 86 ...

Page 30: ...A are recognized and defined Basic command SHOW CONNECTIONS Example command CLI SHOW CONNECTIONS Command options CONNECTION NAME the name of a specific connection to display WWPN the WWPN of a specific connection to display Example CLI response Connection Name abc Host WWNN 11111111 11111111 Host WWPN 22222222 22222222 Profile Name Default Unit Offset 0 Controller 1 Port 1 Status Online Controller...

Page 31: ...execute the following commands as a batch show version show profile show globals show acl show connections show disks show units show this_controller show other_controller Basic command SHOW TECH_SUPPORT Example command CLI SHOW TECH_SUPPORT The commands will execute using the standard output For example displays and more information on the separate commands see the previous pages ...

Page 32: ... expanding an array to set the priority of array expansions in relation to input output operations See below for detailed information about these settings REBUILD_PRIORITY HIGH the rebuild priority Used when rebuilding an array to set the priority of an array rebuild in relation to input output operations Low expansion or rebuild takes place only when the array controller is not busy handling norm...

Page 33: ...System Name XXX Rebuild Priority HIGH Expand Priority HIGH Total Cache 256MB 50 Read Cache 128MB 50 Write Cache 128MB Setting the controller ID To assign a unique name to each controller installed in the MSA Basic command SET THIS_CONTROLLER_ID SET OTHER_CONTROLLER_ID Example command CLI SET THIS_CONTROLLER_ID 123 Command options 123 the user defined ID for the controller The ID can be up to 230 a...

Page 34: ...roller DISABLE disables hard addressing on the controller 1 a decimal number between 0 and 125 to assign the loop identifier Example CLI response CLI SET THIS_CONTROLLER_HARD_ADDRESS ENABLE 1 Hard Addressing is enabled Loop ID 1 ALPA 0xE8 Changing the CLI prompt To temporarily change the CLI prompt from the default of CLI Basic command SET PROMPT Example command CLI SET PROMPT ABC Command options ...

Page 35: ...es A variety of commands are available for physically locating specific hard drives Specifically you can locate all drives attached to the MSA all drives in a specific storage enclosure all drives on a specific SCSI bus all drives in a specific LUN or a specific individual hard drive When these commands are executed the LEDs of the requested drives will blink These LEDs are visible from the front ...

Page 36: ...ort B BUS the number of the bus whose disks you want to flash UNIT the number of the LUN whose disks you want to flash DISKxxx DISKyyy a range of drives to flash Disks are identified by box number and bay number DISKzzz a specific drive to flash Disks are identified by box number and bay number Locating all drives attached to the MSA To flash the LEDs of all drives attached to the MSA Example comm...

Page 37: ... LUN Example command CLI LOCATE UNIT 1 UNIT 1 the drives in LUN 1 will be flashed UNIT ALL all drives incorporated into LUNs will be flashed Locating specific drives To flash the LEDs to locate an individual drive or group of drives Example command CLI LOCATE DISK DISK102 DISK106 DISK DISK102 DISK106 the LEDs on drives in bays 2 through 6 in box 1 will blink Canceling a LOCATE request To stop the ...

Page 38: ...ber For example DISK110 identifies disk 10 in box number 1 DATA DISKxxx DISKyyy a range of drives is to be incorporated into the LUN Disks are identified by box number and bay number For example DISK101 DISK105 identifies disks 1 through 5 in box number 1 Note Quotation marks must be entered both before and after the data disk drives that are to be included in the LUN RAID_LEVEL xxx the RAID fault...

Page 39: ...t where xxx represents the disk number More than one disk can be assigned as a spare to a LUN MAXBOOT ENABLE DISABLE optional changes the size of the boot partition Enable 8 GB boot partition default Disable 4 GB boot partition CACHE ENABLE DISABLE optional determines whether to use the array controller cache for the LUN Enable default use the array controller cache Disable not use the array contr...

Page 40: ... a unique LUN ID for each LUN along with the desired size parameter Example command CLI ADD UNIT 1 DATA DISK111 DISK114 RAID_LEVEL 5 STRIPE_SIZE 32 SIZE 1000MB Note Maintain a record of the units as they are created These Unit ID numbers are used in other CLI commands In addition to recording the unit number the drives included RAID type and size and record the order in which they are created Comm...

Page 41: ...cal Unit size 996 MB RAID overhead 498 MB Total space occupied by new unit 1494 MB Free space left on this volume 24533 MB Unit 1 is created successfully CLI ADD UNIT 2 DATA DISK111 DISK114 RAID_LEVEL 5 STRIPE_SIZE 32 SIZE 2000MB Logical Unit size 2000 MB RAID overhead 1000 MB Total space occupied by new unit 3000 MB Free space left on this volume 21533 MB Unit 2 is created successfully CLI ADD UN...

Page 42: ...on to recording the unit number the drives included RAID type and size and record the order in which they are created Command options 4 LUN 4 is to be created DATA DISK211 DISK212 drives 11 through 12 in box number 2 are to be incorporated into the LUN RAID_LEVEL 1 RAID 1 will be used when creating the LUN SPARE DISK213 the drive in bay 13 of box 2 will be assigned as a spare drive to the LUN Note...

Page 43: ...Basic command SET UNIT_ID Example command CLI SET UNIT_ID 0 ABC Command options 0 LUN 0 is being assigned a name ABC is the name to assign to LUN 0 The name of this LUN will be ABC Example CLI response Identifier ABC created for unit 0 Adding a spare to a LUN To add a spare to an existing LUN Basic command ADD SPARE Example command CLI ADD SPARE UNIT 2 DISK109 Command options UNIT 2 the unit to as...

Page 44: ...cord of the unit numbers and the order in which they are created Note After a LUN is deleted its unit number goes unused until manually assigned to a new LUN Unit numbers are not automatically reassigned when a LUN is deleted Basic command DELETE UNIT Example command CLI DELETE UNIT 4 Command options 4 the unit to delete This is the same number that was given to the unit when it was created with t...

Page 45: ...access to the spare DISK109 the spare drive to remove from use Disks are identified by box number and bay number In this example drive 1 in box number 9 will no longer be used as a spare for LUN 2 Recognizing a failed unit If all drives of a previously failed unit are in working order use this command to change the state of the unit back to VOLUME_OK To accept media exchange on a unit marked as fa...

Page 46: ...n array Note Because this command affects the entire array all LUNs made from the array are also affected Basic command EXPAND UNIT Example command CLI EXPAND UNIT 4 DISK204 DISK207 Command options 4 one of the LUN within the target array Note Any LUN in the array can be entered to identify the array the space is added to the array and not the LUN DISK204 DISK207 the physical disks to add to the a...

Page 47: ..._SIZE 1000MB how much of the available space in the array to add to the LUN In this example 1000 MB of space will be added The size limit must be specified as GB MB or KB If no size is specified the maximum available space of the included disks will be assigned to the array NEW_SIZE xxxxyy can be used instead of ADD_SIZE to enter the total new size of the LUN where xxxx represents the size and yy ...

Page 48: ...nizational purposes Basic command MIGRATE UNIT Example command CLI MIGRATE UNIT 0 RAID_LEVEL 5 STRIPE_SIZE 32 Command options UNIT 0 the number of the LUN to modify In this example LUN 0 will be migrated RAID_LEVEL xxx RAID 5 will be assigned to the LUN RAID levels include 0 RAID 0 no fault tolerance 1 RAID 1 mirroring 5 RAID 5 distributed parity ADG Advanced Data Guarding ADG STRIPE_SIZE xxx opti...

Page 49: ...NIT Example command CLI SET UNIT 0 CACHE DISABLE Command options UNIT 0 the number of the LUN to modify In this example LUN 0 will be modified CACHE ENABLE or DISABLE either enables or disables the use of the array accelerator cache for the specified LUN Example CLI response CLI SET UNIT 0 CACHE ENABLE Cache for unit 0 has been enabled CLI SET UNIT 1 CACHE DISABLE Cache for unit 1 has been disable...

Page 50: ...to restrict access to the LUNs to specific servers The CLI uses an Access Control List ACL to enter the list of LUNs a server can access See the following section Access control list commands for more information about SSP and ACLs Each of the following commands is used to enter and manage the connections Naming a connection Setting the connection profile Changing the name of a connection Changing...

Page 51: ...nection Basic command ADD CONNECTION Example command CLI ADD CONNECTION ABC WWPN 12345678 12345678 PROFILE WINDOWS Command options ABC the user defined name to give the connection WWPN 12345678 12345678 the WWPN of the active HBA inside the server attached to the MSA The show connections command can be used to obtain the WWPN WWNN the WWNN of the active HBA inside the server attached to the MSA Th...

Page 52: ...and options ABC the name of the connection to modify in this example ABC WWPN 12345678 12345678 the WWPN of the connection to modify using the WWPN of the HBA The show connections can be used to obtain the WWPN WWNN 12345678 12345678 the WWNN of the connection to modify using the WWNN of the HBA The show connections command can be used to obtain the WWNN PROFILE WINDOWS the platform of the host wh...

Page 53: ...nnection s has been renamed successfully Changing the HBA of a connection When a new HBA needs to be associated with an existing connection name Basic command SET CONNECTION Example command CLI SET CONNECTION ABC WWPN 12345678 Y999999Y Command options ABC the connection to make the changes to WWPN 12345678 12345678 the World Wide Port Name WWPN of the new HBA to associate with the connection WWNN ...

Page 54: ...a connection name To remove the name associated with a connection to a server Basic command DELETE CONNECTION Example command CLI DELETE CONNECTION ABC Command options ABC the nickname that was assigned to the HBA within the server Example CLI response Connection s has been deleted successfully ...

Page 55: ...UNs a server can access Each of the following commands is used to set up and manage the ACL Viewing the ACL Adding to the ACL Deleting Information from the ACL Disabling the ACL Each of these tasks is defined in the following sections Note Use the SHOW CONNECTIONS command to display the connection name and the WWPN of each HBA connected to the MSA The connection name or the WWPN is used when enter...

Page 56: ...ons CONNECTION xxx the name of the connection to grant access where xxx represents the connection name UNIT xxx which LUN to assign to the indicated server Options include An individual LUN can be assigned by entering one LUN ID UNIT 0 A group of LUN can be assigned by entering a range of LUN UNIT 1 3 Access to all units can be granted by entering UNIT ALL Two methods of entering LUN assignments a...

Page 57: ... ABC UNIT ALL all LUN will be accessible to the connection named ABC Example CLI response Allowing 12345678 12345678 access to unit 2 Adding to the ACL using the WWPN Example command CLI ADD ACL WWPN 12345678 12345678 UNIT 2 Command options WWPN 12345678 12345678 entries will be added to the ACL of the connection with a WWPN of 12345678 12345678 UNIT 2 LUN 2 will be accessible to the named connect...

Page 58: ...ssigned LUNs are available Deleting information from the ACL using the connection name Deleting information from the ACL using the WWPN Note If all entries in the ACL are being deleted immediately after the last entry is deleted all connected servers have unlimited access to the storage Deleting information from the ACL using the connection name Example command CLI DELETE ACL CONNECTION ABC UNIT 0...

Page 59: ...removed from the ACL of the named connection Example CLI response Disallowing 12345678 12345678 access to unit 1 Disabling the ACL If the ACL has been set up but the decision has been to not use it and not limit access to the storage the entries in the ACL need to be deleted Use the following command to delete all entries in the ACL Basic command SET ACL DISABLE Example CLI response Disabling acl ...

Page 60: ...Using the CLI 60 Modular Smart Array 1000 1500 cs Command Line Interface User Guide ...

Page 61: ... the name of 53 connections deleting names of 54 connections managing profiles of 52 connections naming 51 connections viewing 30 50 55 controller ID setting of 33 controller settings viewing 26 28 29 disks viewing information about 23 display commands 23 global settings 32 hard addressing setting of 34 hard drives locating 35 help command described 20 Hyper Terminal setting up 15 inter controller...

Page 62: ...hanging the HBA with the CLI 53 changing the name of with the CLI 53 deleting names of with the CLI 54 managing profiles of with the CLI 52 naming with the CLI 51 viewing with the CLI 30 50 55 controller settings viewing with the CLI 26 28 29 conventions document 7 equipment symbols 8 text symbols 7 D DELETE ACL command 58 DELETE CONNECTION command 54 DELETE SPARE command 45 DELETE UNIT command 44...

Page 63: ...RENAME CONNECTION command 53 S serial connection setting up 15 SET ACL DISABLE command 59 SET CONNECTION command 52 53 SET GLOBALS command 32 SET OTHER_CONTROLLER command 33 34 SET PROMPT command 34 SET THIS_CONTROLLER command 33 34 SET UNIT command 49 SET UNIT_ID command 43 SHOW ACL command 56 SHOW CONNECTIONS command 30 SHOW DISKS command 23 SHOW GLOBALS command 28 SHOW OTHER_CONTROLLER command ...

Page 64: ...Index 64 Modular Smart Array 1000 1500 cs Command Line Interface User Guide ...

Reviews:

No comments