Table of Contents
Advertisement
Quick Links
hp StorageWorks
Modular Smart Array 1000/1500 cs
Command Line Interface
Second Edition (May 2004)
Part Number: 347282-002
This guide details the Command Line Interface (CLI), 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
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.
HP StorageWorks Modular SAN Array
User Guide
HP StorageWorks Modular Smart
and
347282- 002
Advertisement
Table of Contents
Related Manuals for HP StorageWorks Modular Smart Array 1000 cs
Summary of Contents for HP StorageWorks Modular Smart Array 1000 cs
-
Page 1: Command Line Interface
Note: HP StorageWorks Modular SAN Array HP StorageWorks Modular Smart Documentation titled 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. 347282- 002... - Page 2 © Copyright 2002-2004 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
-
Page 3: Table Of Contents
HP authorized reseller ........ - Page 4 Contents Viewing global settings ..........28 Viewing version information .
-
Page 5: 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 “About This Guide” topics include: Overview, page 6 Conventions, page 6 Getting help, page 9 Modular Smart Array 1000/1500 cs Command Line Interface User Guide... -
Page 6: Overview
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:... -
Page 7: Document Conventions
Variables <monospace, italic font> Web site addresses Underlined sans serif font text: http://www.hp.com Text symbols The following symbols may be found in the text of this guide. They have the following meanings: WARNING: Text set off in this manner indicates that failure to follow directions in the warning could result in bodily harm or death. -
Page 8: Equipment Symbols
About this Guide Equipment symbols The following equipment symbols may be found on hardware for which this guide pertains. They have the following meanings: Any enclosed surface or area of the equipment marked with these symbols indicates the presence of electrical shock hazards. Enclosed area contains no operator serviceable parts. -
Page 9: Getting Help
If you still 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. -
Page 10: Hp Technical Support
Note: For continuous quality improvement, calls may be recorded 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 http://www.hp.com. support: Be sure to have the following information available before calling:... -
Page 11: Overview And Setup
Overview and Setup The Command Line Interface (CLI) is used to configure and manage the MSA1000 Controller and its storage. In addition, the CLI can be used to display system setup information and status. It may also provide information on devices that are attached to the controller. Note: The CLI is available for all supported operating systems. -
Page 12: Overview
Overview and Setup Overview After accessing the interface, enter a command string at the CLI prompt ( CLI> Commands must use a specific, 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 meaning: Table 2: CLI Special Keys Keyboard Keys... -
Page 13: Cli Command Syntax
Overview and Setup CLI command syntax As previously mentioned, CLI commands are entered at the CLI prompt. Commands are not case sensitive and must be typed out in full. CLI command strings include the basic command plus specific command options, some of which are mandatory and some of which are optional. -
Page 14: Overview Of Cli Storage Configuration Procedures
Overview and Setup Overview of CLI storage configuration procedures When using the CLI to initially configure the MSA1000 Controller and its storage, use the following sequence: 1. Enter array controller settings, including global parameters. “Array controller configuration commands” on page 32 for command descriptions. -
Page 15: Setup
Overview and Setup Setup The CLI is accessed through a host computer connected to the serial port of an MSA1000 Controller. Use the following steps to establish a serial connection to the controller. Note: Any terminal emulator program may be used, but the following instructions demonstrate setting up the serial connection with HyperTerminal. - Page 16 Overview and Setup Figure 1: HyperTerminal 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. Figure 2 for an example of the Connect To dialog box.
- Page 17 Overview and Setup d. In the Connect To dialog box, expand the Connect using drop-down box, select the appropriate COM port, and click OK. Figure 2 illustrates selecting COM1. The COM Properties dialog box is displayed. Figure 3 is an example of the COM1 Properties dialog box. Figure 3: HyperTerminal COM1 Properties dialog box e.
- Page 18 Overview and Setup Modular Smart Array 1000/1500 cs Command Line Interface User Guide...
-
Page 19: Using The Cli
Using the CLI Managing and configuring the storage includes configuring LUNs, entering connection information, limiting access to the 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... -
Page 20: Help Commands
Using the CLI Help commands Help commands can be used to display a list of all possible commands or to display a detailed description of a specific command. Displayed information may include required command syntax, a brief definition, the number of characters for a command option value, or a list of allowed/disallowed characters. -
Page 21: Displaying A List Of All Available Commands
Using the CLI Displaying a list of all available commands To see a list of all commands: Example command CLI> HELP DISPLAY_ALL Command options —a list of all currently supported commands will be displayed. DISPLAY_ALL Example command output CLI> HELP DISPLAY_ALL Displaying list of all currently supported CLI commands: help add unit... -
Page 22: Displaying Help For A Specific Command
Using the CLI Displaying help for a specific command When the basic command is followed by a specific command verb or HELP command verb and noun, the CLI will display helpful information about that command. Example command CLI> HELP ADD ACL Command options —the specific command about which to display help. -
Page 23: Display Commands
Using the CLI Display commands Several commands are available to view system information and setup, including: Viewing physical disk information Viewing LUN information Viewing LUN names Viewing controller settings Viewing global settings Viewing version information Viewing connection information Viewing complete system information with one command Each of these procedures uses the command, which displays the SHOW... - Page 24 Using the CLI Example CLI response for an MSA1000 CLI> SHOW DISKS Disk List: (box,bay) (B:T:L:) Size Speed Units Enclosure 1: SCSI Disk101 (1,01) (0,00,00) 72.8GB 160 MB/s none Disk102 (1,02) (0,01,00) 72.8GB 160 MB/s none Disk103 (1,03) (0,02,00) 72.8GB 160 MB/s none Disk104...
-
Page 25: Viewing Lun Information
Using the CLI Viewing LUN information The following information can be displayed for the LUN: Unit identifier (user-defined name) LUN status, including OK, Failed, and Rebuilding List of the disks included in the LUN List of the disks assigned as spares to the LUN RAID level Unit size, in MB Basic command... -
Page 26: Viewing Lun Names
Using the CLI Viewing LUN names To view the user-defined names that have been assigned to the LUNs: Basic command SHOW UNIT_ID Example command CLI> SHOW UNIT_ID 0 Command options –the number of the LUN to display. Example CLI response Unit 0: ABC ABC represents the assigned user-defined name. - Page 27 Using the CLI To view information about the configuration of the controller: Basic command SHOW THIS_CONTROLLER SHOW OTHER_CONTROLLER Example command CLI> SHOW THIS_CONTROLLER Example CLI response Controller: MSA1000© Hewlett-Packard xxx Version 4.24 Build 122 Hardware 7 Component Enclosure. Controller Identifier: 123 NODE_ID=yyyyyyyy-yyyyyyyy SCSI_VERSION=SCSI-3 Supported Redundancy Mode: Active/Standby...
-
Page 28: Viewing Global Settings
Using the CLI Viewing global settings The following information can be displayed for the global settings of the controller: System name Rebuild and expand priority settings Read and write cache settings Power supply and EMU temperatures To view information about the global settings of the controller: Basic command SHOW GLOBALS Example command... -
Page 29: Viewing Version Information
Using the CLI Viewing version information The following 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>... -
Page 30: Viewing Connection Information
Using the CLI Viewing connection information The following command displays the World Wide Names of each Host Bus Adapter (HBA) attached to the MSA. If connections between the HBAs and the MSA have been given user-defined names, these names are also displayed. Note: Use the command to verify that all connections to the MSA... -
Page 31: Viewing Complete System Information With One Command
Using the CLI Viewing complete system information with one command The CLI provides a single command that will 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... -
Page 32: Array Controller Configuration Commands
Using the CLI Array controller configuration commands The CLI provides the ability to configure the MSA1000 controller, including: Setting global variables Setting the controller ID Setting hard addressing Changing the CLI prompt Each of these procedures uses the SET command, which changes the settings of the MSA1000 Controller. -
Page 33: Setting The Controller Id
Using the CLI ”—the system name, where XXX represents any user SYSTEM_NAME=”XXX defined phrase, up to 20 alphanumeric characters. —the read cache. This value must be between 0 and 100. READ_CACHE=50 —the write cache. This value must be between 0 and 100 WRITE_CACHE=50 Note: Read_cache plus write_cache must equal 100. -
Page 34: Setting Hard Addressing
Using the CLI Setting hard addressing To enable or disable Fibre Channel Arbitrated Loop hard addressing on an MSA controller: Basic command SET THIS_CONTROLLER_HARD_ADDRESS Example command CLI> SET THIS_CONTROLLER_HARD_ADDRESS ENABLE 1 Command options —enables hard addressing on the controller. ENABLE —disables hard addressing on the controller. -
Page 35: Lun Management Commands
Using the CLI LUN management commands The following commands are used to physically locate the specific hard drives in a LUN as well as create, delete, and modify storage LUNs. Flashing LEDs/locating hard drives Creating LUNs Assigning a name or ID to a LUN Adding a spare to a LUN Deleting LUNs Deleting spares... - Page 36 Using the CLI Basic command LOCATE Command options —(optional) the length of time to flash the LEDs, where xxx TIME=xxx represents the number of seconds. —all drives connected to the MSA storage sub-system will be flashed. —the number of the storage enclosure whose disks you want to flash. 1=the MSA drive shelf 2=the storage enclosure attached to SCSI port A 3=the storage enclosure attached to SCSI port B...
- Page 37 Using the CLI Locating all drives for a specific SCSI bus To flash the LEDs of all drives connected to a specific SCSI bus: Example command CLI> LOCATE BUS 1 —all drives connected to bus number 1 will be flashed. BUS 1 Locating all drives in a specific LUN To flash the LEDs and locate all drives associated with a specific LUN:...
-
Page 38: Creating Luns
Using the CLI Creating LUNs A LUN is a logical storage unit comprised of one or more hard drives. When a LUN is initially created, the LUN Unit ID is automatically set to the number assigned to the LUN. If desired, this LUN ID name can be changed. See “Assigning a Name or ID to a LUN”... - Page 39 Using the CLI —(optional) the stripe size to assign (in KB), where xxx STRIPE_SIZE=xxx represents 8, 16, 32, 64, 128, or 256 Kilobytes. uses stripe sizes 8, 16, 32, 64, 128, and 256 (Default: 128 KB) RAID 0 uses stripe sizes 8, 16, 32, 64, 128, and 256 (Default: 128 KB) RAID 1 uses stripe sizes 8, 16, 32, and 64 (Default: 16 KB) RAID 5...
- Page 40 Using the CLI Example CLI response First volume to be configured on these drives. Logical Unit size = 69460 MB RAID overhead = 0 MB Total space occupied by new unit = 69460 MB Free space left on this volume = 0 MB Unit 0 is created successfully.
- Page 41 Using the CLI Example CLI response The following display is a continuation of the previous example, creating three LUNs on the same group of physical drives. CLI> ADD UNIT 1 DATA=”DISK111-DISK114” RAID_LEVEL=5 STRIPE_SIZE=32 SIZE=1000MB First volume to be configured on these drives. The logical unit size has been adjusted by 4MB for optimal performance.
- Page 42 Using the CLI Creating a LUN with an assigned spare To create a LUN and assign a spare at the same time, use the command ADD UNIT and include the command option. SPARE= Note: More than one spare can be assigned to the same LUN and the same spare can be available to multiple LUNs.
-
Page 43: Assigning A Name Or Id To A Lun
Using the CLI Assigning a name or ID to a LUN If desired (or required by your operating system), each LUN can be assigned a unique name or ID in addition to its number. These user-defined names make it easier to identify specific LUNs in other configuration procedures. Note: OpenVMS systems require each LUN to have a unique ID. -
Page 44: Deleting Luns
Using the CLI Example CLI response First volume to be configured on these drives. Logical Unit size = 69460 MB RAID overhead = 69460 MB Total space occupied by new unit = 138920 MB Unit 2 is created successfully. Deleting LUNs To delete the last created LUN: Note: If more than one LUN has been created, only the last LUN created can be... -
Page 45: Deleting Spares
Using the CLI Deleting spares To remove a spare from use: Basic command DELETE SPARE Example command CLI> DELETE SPARE UNIT=2 DISK109 Command options —the unit that will no longer have access to the spare. This is the same UNIT 2 number that was given to the unit when it was created with the ADD UNIT command. -
Page 46: Modifying Arrays And Luns
Using the CLI Modifying arrays and LUNs Occasionally, after an array or a LUN has been created, its characteristics need to be changed. The following changes can be made: Adding drives to an array Adding space to a LUN Changing the RAID characteristics of a LUN Changing attributes of a LUN Each task is discussed in the following paragraphs. - Page 47 Using the CLI Adding space to a LUN To add unused, available space in an array to a specific LUN: Basic command EXTEND UNIT Example command CLI> EXTEND UNIT 2 ADD_SIZE=1000MB Command options —the LUN to which the space will be added. In this example, LUN 2 is being extended.
- Page 48 Using the CLI Changing the RAID characteristics of a LUN While obeying the constraints of included number of drives and applicable stripe sizes, you can migrate an array from one RAID level to another. If you attempt to move to an unsupported RAID configuration for an array, an error message is displayed.
- Page 49 Using the CLI Changing attributes of a LUN To enable or disable the array accelerator cache for a specific LUN: Basic command SET UNIT Example command CLI> SET UNIT 0 CACHE=DISABLE Command options —the number of the LUN to modify. In this example, LUN 0 will be UNIT 0 modified.
-
Page 50: Server Connection Commands
WWPN. Before a server accesses the storage of the MSA, you must identify the operating system (host mode) of each connection. HP also recommends assigning a user-defined name to each connection, to make the identification and setup of each connection easier. -
Page 51: Naming A Connection
Using the CLI Naming a connection This command is used to name the association between the Fibre Channel Initiator (HBA in the server) and the MSA, while at the same time identifying the operating system (connection profile) of the server. The name given to a connection is user defined, according to a naming convention that makes identification and setup of the ACL for each connection easier. -
Page 52: Setting The Connection Profile
Using the CLI Setting the connection profile To change the operating-system profile associated with an existing connection: Note: The connection profile is sometimes referred to as the Host Mode. Basic command SET CONNECTION X PROFILE=Y Example command CLI> SET CONNECTION ABC PROFILE=WINDOWS Command options —the name of the connection to modify, in this example ABC. -
Page 53: Changing The Name Of A Connection
Using the CLI Changing the name of a connection To change the name associated with a connection: Basic command RENAME CONNECTION Example command CLI> RENAME CONNECTION ABC XYZ Command options —the current name of the connection that is to be changed. —the new name to assign to the connection, up to 16 alphanumeric characters. -
Page 54: Deleting A Connection Name
Using the CLI Deleting 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 —the nickname that was assigned to the HBA within the server. Example CLI response Connection(s) has been deleted successfully. -
Page 55: Access Control List Commands
Using the CLI Access control list commands When multiple servers access the storage of the MSA, it becomes necessary to restrict access to LUNS to specific servers. The CLI uses an Access Control List (ACL) to enter the list of LUNs 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... -
Page 56: Viewing The Acl
Using the CLI Viewing the ACL To display the current ACL: Basic command SHOW ACL Command options There are no available options for this command. Example CLI response ACL is enabled: Connection WWPN Units 11111111-22222222 0,1,2 33333333-44444444 2,3,4 Inaccessible Units: 5,6 Adding to the ACL To indicate the allowable LUNs for each server: Basic command... - Page 57 Using the CLI Adding to the ACL using the connection name Example command CLI> ADD ACL CONNECTION=ABC UNIT=ALL Command options —entries will be added to the ACL of the connection named CONNECTION=ABC ABC. —all LUN will be accessible to the connection named ABC. UNIT=ALL Example CLI response Allowing 12345678-12345678 access to unit 2.
-
Page 58: Deleting Information From The Acl
Using the CLI Deleting Information from the ACL After the ACL has been set up, access permissions for certain LUNs may need to be removed. Basic command DELETE ACL Command options —the name of the connection for which to remove CONNECTION=xxx permissions. -
Page 59: Disabling The Acl
Using the CLI Deleting information from the ACL using the WWPN Example command CLI> DELETE ACL WWPN=12345678-12345678 UNIT=1 Command options —entries will be deleted from the ACL of the WWPN=12345678-12345678 connection with a WWPN of 12345678-12345678. —LUN 1 will be removed from the ACL of the named connection. UNIT=1 Example CLI response Disallowing 12345678-12345678 access to unit 1. - Page 60 Using the CLI Modular Smart Array 1000/1500 cs Command Line Interface User Guide...
-
Page 61: Index
Index connections, naming connections, viewing 30, 50, Access Control Lists See ACL controller ID, setting of controller settings, viewing 26, 28, adding to with the CLI disks, viewing information about commands display commands deleting from, with the CLI global settings disabling, with the CLI hard addressing, setting of viewing, with the CLI... - Page 62 Index commands controller settings, viewing, with the CLI 26, 28, ADD ACL ADD CONNECTION conventions ADD SPARE document ADD UNIT equipment symbols DELETE ACL text symbols DELETE CONNECTION DELETE SPARE DELETE UNIT DELETE ACL command EXPAND UNIT DELETE CONNECTION command EXTEND UNIT DELETE SPARE command HELP...
- Page 63 CLI deleting with the CLI symbols in text MIGRATE UNIT command symbols on equipment rack stability, warning technical support, hp RAID levels, changing for a LUN with the CLI text symbols related documentation RENAME CONNECTION command warning...
- Page 64 Index Modular Smart Array 1000/1500 cs Command Line Interface User Guide...
Need help?
Do you have a question about the StorageWorks Modular Smart Array 1000 cs and is the answer not in the manual?
Questions and answers