HP StorageWorks 1510i Modular Smart Array Command Line Interface user guide active/active firmware 2.
Legal and notice information © Copyright 2005, 2008 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 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.
Contents About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . Intended audience . . . . . . . . . . . Related documentation . . . . . . . . . Document conventions and symbols . . . HP technical support . . . . . . . . . . HP installation and configuration assistance Subscription service . . . . . . . . . . HP websites . . . . . . . . . . . . . . Documentation feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
bind unit . . . . . . . . . . . . . clear perf . . . . . . . . . . . . . delete acl_entry . . . . . . . . . . delete arp . . . . . . . . . . . . delete initiator . . . . . . . . . . . delete ip . . . . . . . . . . . . . delete isns_server . . . . . . . . . delete portal . . . . . . . . . . . delete portal_group . . . . . . . . delete route . . . . . . . . . . . . delete spare . . . . . . . . . . . delete target . . . . . . . . . . . delete unit . . . . . . . . . . . .
show isns . . . . . . . . . . . . show isns_server . . . . . . . . . show management . . . . . . . . show mib2 . . . . . . . . . . . show perf . . . . . . . . . . . show port . . . . . . . . . . . show portal . . . . . . . . . . . show portal_group . . . . . . . . show profile . . . . . . . . . . show preferred_path . . . . . . . show proxystats . . . . . . . . . show route . . . . . . . . . . . show service . . . . . . . . . . show snmp . . . . . . . . . . . show target . . . . . . . . . . .
Figures 1 Multiple physical drives (D1, D2, and D3) in a system . . . . . . . . . . . . . . . . 2 Multiple physical drives (D1, D2, and D3) configured into one logical drive (L1) 145 . . . . . 145 3 Data striping (S1-S4) and data blocks (B1-B12) on multiple physical drives (D1, D2, D3) . . 146 4 Two arrays (A1, A2) containing five logical drives (L1 through L5) spread across five physical drives (D1 through D5) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tables 1 Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 2 CLI special keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 3 RAID 0 features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 4 RAID 1, RAID 1+0 features . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 5 RAID 5 features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 6 RAID 6 features . . . . . . . . . . . . . . . . . . . . .
About this guide This document provides information to help you use the HP StorageWorks 1510i Modular Smart Array (MSA1510i) Command Line Interface (CLI). Intended audience 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 guide.
Document conventions and symbols Table 1 Document conventions Convention Element Blue text: Table 1 Cross-reference links and e-mail addresses Blue, underlined text: http://www.hp.
• Error messages • Operating system type and revision level • Detailed questions HP installation and configuration assistance Storage management and networking knowledge is required to successfully install this product. If you are not familiar with installing and configuring storage array systems, HP can install your system for you. For more information, access the HP Services website: http://www.hp.com/go/services.
About this guide
1 CLI setup and overview The Command Line Interface (CLI) is used to configure and manage the array controller and its storage. Tasks include configuring logical storage units (LUNs), limiting access to storage, viewing system and component information, configuring 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.
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) field. 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.
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. From any PC that is connected to the same LAN as the MSA, click StartRun to open the Run dialog box. 3. Enter the following command: telnet [] where [] 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.
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 first 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.
• Commands are not case sensitive and must be typed in full. • The CLI does not support line-continuation characters. If all characters of a command cannot fit on one line of the CLI, the command wraps to the next line on the screen. The maximum command length is 255 characters. Example command The following command has three portions: the basic command and three operands: add unit 0 data=”disk101-disk103” raid_level=0 The basic command is add unit.
CLI setup and overview
2 Initial configuration sequence The MSA can be completely configured using the CLI. If you want to use the HP Storage Management Unit (SMU), but the factory default management network settings do not work in your environment, see Configuring 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 configuration. The examples show the command that is typed in at the CLI prompt and the system response.
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=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 configure the storage in to multiple logical drives.
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.
Configuring Access Controls for LUN access NOTE: The steps in this section assume that you already have a basic iSCSI setup configured. 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.
• To a. b. c. iSNS enabled manually add iSNS servers Use the set isns command to change the iSNS server discovery mode: CLI> set isns server_discovery=manual iSNS parameters set. 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 Use the set discovery command to enable iSNS discovery on the iSCSI target.
4. [Optional] If required, enable access to the CLI via Telnet (not recommended) using the set service command: CLI> set service telnet on 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.
3 Command reference Command overview The CLI uses the following basic types of commands: add Creates new configuration elements. bind Creates associations between iSCSI elements. delete Removes configuration elements. help Displays all possible commands or a detailed description of a specified command. reset Restores the default values of configuration elements. set Changes the value of configuration elements.
Alphabetical listing of commands The following MSA1510i CLI commands are included in this section: accept unit, page 27 set preferred_path, page 92 set prompt, page 93 add acl_entry, page 28 set service, page 94 add arp, page 29 set snmp, page 95 add initiator, page 30 add ip, page 31 set target_chap, page 96 add isns_server, page 32 set this_controller|other_controller, page 97 add portal, page 33 set this_controller_id, page 98 set unit, page 99 add portal_group, page 34 add route, page 35 set unit_id, pa
accept unit Description Changes the state of the unit back to VOLUME_OK. Use this command to accept media exchange on a unit previously marked as failed. The accept unit and accept units commands are identical in functionality. Syntax accept unit [] accept units Operands [Optional] The number of the unit to be reset. If no value is entered, all units are reset. Example CLI> accept units NOTE: Accept Unit will cause a temporary LUN path change to this controller.
add acl_entry Description Grants an initiator access to an iSCSI target or specific LUN. If you specify the mapped LUN alias, the initiator is granted access to the specified mapped LUN. If you specify the target alias, all of the target’s mapped LUNs become accessible to the initiator. If more LUNs are mapped to the target at a later time, use the add acl_entry command to include them. NOTE: If Access Controls are turned off, this command turns them on.
add arp Description Adds a static ARP entry to ARP table of the storage ports. This is generally used only for debugging purposes. Syntax add arp Operands The IP address to map, in dotted notation. The associated MAC address, in the form AA:BB:CC:DD:EE:FF. Example CLI> add arp 10.10.10.11 12:14:33:44:34:11 The ARP entry was added successfully.
add initiator Description Adds an iSCSI initiator entry to the initiator pool. Syntax add initiator [alias=]> [profile=] Operands The fully qualified iSCSI name of the initiator (1-223 characters). alias= [Optional] The alias name (1-16 characters) of the initiator. profile= [Optional] The operating system profile to associate with the initiator, where is one of the following entries: windows—for Microsoft Windows servers. linux—for Linux servers.
add ip Description Assigns an IP address to the specified storage port. Syntax add ip ]> [] Operands The storage port to which the address is bound. Options include: SA0, SA1, SB0, or SB1. ]|default> The IP address in dotted notation. If default is entered instead of an IP address, the default gateway will be used.
add isns_server Description Adds an iSNS server to the iSNS server pool. NOTE: iSNS servers can be added with this command only when the iSNS server discovery mode is set to manual. For more information, see “set isns” on page 87. Syntax add isns_server [port=] [alias=] Operands The IP address of the iSNS server to add. port= [Optional] The TCP port of the iSNS server. Defaults to 3205 if no value is entered. alias= [Optional] An alias name for the iSNS server.
add portal Description Adds a new portal entry in the portal pool. To use the portal, it must be bound to a portal group using the bind portal command. Syntax add portal < ip> [port=] [alias=] Operands The IP address of the portal in dotted notation. The IP address must have been previously added using the add ip command. port= [Optional] The TCP port number of the portal. Defaults to 3260 if not defined.
add portal_group Description Adds a new portal group entry into the portal group pool. To use the portal group, it must be bound to a target using the bind portal_group command. Syntax add portal_group alias= [tag=] Operands alias= The alias name (1-16 characters). tag= [Optional] The decimal portal group tag in the portal group table (show portal_group will display the portal group tags). Portal group tags can be only used once per target.
add route Description Adds a static route to a controller. This command is generally used for debugging purposes. NOTE: There is one routing table per controller. Syntax add route ]|default> Operands The controller that the route is for. Valid values are “A” or “B”. ]|default> The IP address in dotted notation. If default is entered instead of an IP address, the default gateway will be used.
add spare Description Causes the specified drive or drives to be used as a spare by the specified unit. Syntax add spare unit= Operands unit= The unit (0-31) that will have access to the spare or spares. This is the same number that was assigned to the unit when it was created with the add unit command. The drive or drives to remove from active use.
add target Description Adds a new target to the target pool. The target name must be world wide unique. If all target elements are already configured (all slots are in use in the target configuration table), an error is returned. NOTE: To bind logical units to target LUNs, use the bind unit command. To create iSCSI portals to allow initiators access, use the add ip, add portal_group, add portal, bind portal_group, and bind portal commands.
add unit Description 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 are used in other CLI commands. In addition to recording the unit number, the drives included, and the RAID type and size, record the order in which they are created.
[Optional] The stripe size to assign (in KB). Valid values are 8, 16, 32, 64, 128, or 256 Kilobytes. • RAID 0 uses stripe sizes 8, 16, 32, 64, 128, and 256. Default: 128 KB. • RAID 1 uses stripe sizes 8, 16, 32, 64, 128, and 256. Default: 128 KB. • RAID 5 uses stripe sizes 8, 16, 32, and 64. Default: 16 KB. • RAID ADG uses stripe sizes 8, 16, 32, and 64. Default: 16 KB.
Example 2 To assign multiple LUNs from a drive or group of drives, use the add unit command and include the size= command option. Repeat the command using a unique LUN ID for each LUN, along with the desired size parameter. 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.
newpage pi 1510i Modular Smart Array Command Line Interface user guide 41
bind portal Description Binds an iSCSI portal to a portal group. This allows initiators to access the iSCSI target to which the portal group is bound. Syntax bind portal Operands The alias name of the portal to bind. The alias name of the target portal group. Example CLI> bind portal portal1.test pgroup1.test The portal was bound successfully to the portal group.
bind portal_group Description Binds an iSCSI portal group to an iSCSI target, allowing any portals in the portal group to be used to access the target. A portal group may only be bound to one target at a time. Syntax bind portal_group Operands The alias name of the portal group. The alias name of the iSCSI target. Example CLI> bind portal_group pgroup1.test target1.test The portal group was bound successfully to the target.
bind unit Description Binds a logical unit to a LUN on an iSCSI target. A unit can only be bound to one target. The LUN number is seen by iSCSI initiators when they access the target. Multiple iSCSI targets cannot have LUNs mapping to the same unit. Syntax bind unit [alias=] Operands The logical unit to which the LUN is mapped (0-31). The alias name of the iSCSI target. The mapped LUN number on the target (1-32).
clear perf Description Resets the controller performance analysis data previously initiated with the start perf command. Syntax clear perf Operands None Example CLI> clear perf Performance Monitor reset.
delete acl_entry Description Deletes an entry from the Access Control List (ACL), removing initiator permission to access to an iSCSI target or specific LUN. If you specify the LUN alias, the initiator is denied access to the specified mapped LUN. If you specify the target alias, all LUNs mapped to that target are denied access to the initiator. Syntax delete acl_entry target= -ordelete acl_entry lun= Operands The iSCSI alias name of the initiator.
delete arp Description Deletes an entry from the ARP table. Each physical port has its own ARP table. NOTE: Only static ARP entries added with the add arp command may be deleted. Syntax delete arp Operands The IP address, in dotted notation, of the ARP entry to delete. Example CLI> delete arp 10.10.10.11 The ARP entry was deleted successfully.
delete initiator Description Removes an initiator entry from the initiator pool. NOTE: If Access Control is disabled, the initiator can still access iSCSI targets. Syntax delete initiator Operands The alias name (1-16 characters) of the initiator. Example CLI> delete initiator alias1.test The initiator was deleted successfully.
delete ip Description Deletes an IP address and all associated iSCSI portals. Syntax delete ip Operands The IP address, in dotted notation, to delete. Example CLI> delete ip 10.0.8.224 The IP address was deleted successfully.
delete isns_server Description Deletes an iSNS server. Syntax delete isns_server Operands The alias name of the iSNS server to delete. Example CLI> delete isns_server server1.test The iSNS server was deleted successfully.
delete portal Description Delete an iSCSI portal and removes associations to the portal group and IP configuration table. Syntax delete portal Operands The alias of the portal to be deleted. Use the show portal command to display alias names. Example CLI> delete portal portal1.test The portal was deleted successfully.
delete portal_group Description Deletes an iSCSI portal group. Any portals in the portal group are automatically unbound. Syntax delete portal_group Operands The alias name of the portal group to be deleted. Example CLI> delete portal_group group1.test The portal group was deleted successfully.
delete route Description Deletes the specified route entry from the routing table for the specified controller. Syntax delete route ]|default > Operands The controller of the route to delete. Valid options are A and B. ]|default> The IP address in dotted notation. If default is entered instead of an IP address, the default gateway will be used.
delete spare Description Causes the specified drive to no longer be used as a spare by the specified unit. Syntax delete spare unit= Operands The unit (0-31) that will no longer have access to the spare or spares. This is the same number that was given to the unit when it was created with the ADD UNIT command. The spare drive or drives to remove from use.
delete target Description Removes the target from the target pool. All associated portal groups are automatically unbound. Syntax delete target Operands The current iSCSI target alias name (1-16 characters). Example CLI> delete target NewAlias1 The iSCSI target was deleted successfully.
delete unit Description Deletes the LUN or LUNs. All resources used by, and settings associated with the unit are deleted. NOTE: After a LUN is deleted, its unit number remains unused until manually assigned to a new LUN. Unit numbers are not automatically reassigned when a LUN is deleted. Syntax delete unit [-y] Operands The LUNs to delete. Unit numbers are from 0 to 31 and are the same numbers that were given to the units when they were first created with the add unit command.
• • • • • extend unit migrate unit set unit_id show unit_id unbind unit newpage pi 1510i Modular Smart Array Command Line Interface user guide 57
disable this_controller|other_controller Description In a dual-controller system, this command disables one of the controllers to prepare it for removal. When a controller is disabled, all resources being processed by that controller are automatically failed over to the remaining controller. After a controller has been successfully disabled, the LCD panel displays a message stating that it is safe for that controller to be removed.
download firmware Description Updates firmware on the MSA1510i controller or MSA1510i other components, or, updates firmware on the hard drive storage enclosures attached to the rear of the MSA1510i. IMPORTANT: Before using this method to update the firmware, make note of the following: • The custom CLI cable, shipped with the MSA, must be available to establish the serial connection to the MSA. This command is not available through SSH or Telnet.
• When determining which MSA controller firmware version to use, review the requirements and information in the Compatibility Matrix(es), release notes, and other MSA announcements. • Because firmware updates require least one restart of the MSA array and its attached storage enclosures, update system firmware only during a scheduled maintenance window. • The following versions of Internet Explorer are supported: • MSA1510i firmware 1.30 or earlier: IE6.0 • MSA1510i firmware 2.0 or later: IE7.
1. Determine which version firmware is currently installed on the MSA by using one of the following methods: • With the array controller powered on, press the arrow buttons on the front of the controller until the following message is displayed: 00 Array Controller Firmware ver . • From the MSA-CLI, enter the show version command. MSA1510i Firmware Revision is included in the displayed system information. 2. Obtain the latest firmware files and save to a temporary location on the host: a.
7. Establish a serial connection to the CLI using an emulator program such as HyperTerminal. NOTE: the following example describes the HyperTerminal emulator program. a. Connect the RJ-45Z end of the custom CLI configuration cable to the port on the front of the controller. One custom CLI cable is shipped with the MSA. b. Connect the DB9 end of the CLI cable to the serial port on the host server. c.
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 directory in which you placed the firmware files, and then select the firmware file. b. Expand the Protocol drop-down box, and then select 1K Xmodem. c. Click Send. A 1K Xmodem status window is displayed. 11. Wait for a completion message to display.
12. Restart the MSA and its attached storage enclosures storage system by doing the following (newly downloaded firmware cannot be accessed until the MSA is restarted): a. Press and hold down the MSA Power On/Standby button for approximately five seconds to place the MSA in Standby mode. b. Power off all storage enclosures attached to the MSA. c. Wait approximately two minutes to ensure that the hard disk drives in the enclosures stop rotating. d. Restart all storage enclosures attached to the MSA. e.
expand unit Description Adds a physical drive or drives to the LUN. This enables the specified unit and all units on the same volume to utilize more disks, effectively allowing them to increase in size. NOTE: Because this command affects the entire array, all LUNs made from the array are also affected. Syntax expand unit Operands The unit number (0-31) of any one of the LUNs within the target array.
extend unit Description Adds unused, available space in an array to the specified LUN. Syntax extend unit Operands The LUN to which the space will be added. , where sizing option equals one of the following: add_size=MB|GB—Specifies how much of the available space in the array to add to the LUN, where represents the size. You must specify if the size is MB or GB.
help Description Displays helpful information about CLI commands. Displayed information may include a brief definition, required command syntax, available operands, the number of characters for a command option value, or a list of allowed/disallowed characters. The basic command is help. If a noun or verb is also entered, the display is limited to information about that specific command.
controller adu_page drive_report perf taskstats debug aculock Specify command word: mib2 cacheinfo eventlog Example help display all command and response CLI> help display_all Displaying list of all currently supported CLI commands: ? help add unit add units add spare download firmware delete unit delete units delete spare migrate unit expand unit extend unit accept unit accept units set unit_id set this_controller set this_controller_id set other_controller set other_controller_id set globals set prompt
show perf stop perf show cacheinfo set debug start perf clear perf show taskstats show eventlog Example help add unit command and response CLI> help add unit Usage: ’add unit <#> raid_level=R data=diskrange [spare=diskrange] [stripe_size=S] [size=X] [max_boot=] [cache=] #={0-31} / R={0,1,5,6(ADG)} / X={positive integer} / S={8,16,32,64,128,256} diskrange examples: DISK101 DISK101-DISK105 "DISK101 DISK112-DISK202 DISK314" DISKxyy: x={1,2,3} (box #) / yy={01-14} (bay #
locate Description Helps you locate specific hardware by flashing the LEDs of the drives in the requested hardware. These LEDs are visible from the front of the storage enclosures. Syntax locate
migrate unit Description Migrates an existing LUN from one RAID level to another. If you attempt to move to an unsupported RAID configuration for a LUN, an error message is displayed. NOTE: Before changing the RAID level or stripe size of a LUN, verify there is available, unused space on the array. Migrating from one RAID level to another may require additional space for parity and organizational purposes.
• • • • • • • • newpage pi 72 Command reference show unit set unit accept unit expand unit extend unit set unit_id show unit_id unbind unit
refresh isns_entries Description Re-registers all iSNS-enabled targets with all iSNS servers. Syntax refresh isns_entries Operands None Example CLI> refresh isns_entries Refreshed the iSNS entries.
reset certificate Description Removes the SSL certificate being used by the management interface and resets the system to using an internally-generated, self-signed certificate.
reset controller Description Restarts the MSA controller through which you are connecting to the CLI. During this process, detailed progress and status information is displayed. Syntax reset controller [] Operands [Optional] The number of seconds to delay before restarting the controller. Example CLI> reset controller 10 System will reboot in 10 seconds.
reset management_login Description Resets the management username and password to their factory defaults. This command is only available through the serial port CLI. Syntax reset management_login Operands None Example CLI> reset management_login Management login and password reset.
set acl Description Sets access controls on or off for an iSCSI target. NOTE: When set acl disable is entered, all existing ACL entries on the target are automatically deleted. All storage on the target is immediately available to all initiators. Syntax set acl enable|disable Operands The alias name of the iSCSI target. enable|disable Specifies whether to enable or disable Access Controls. Example CLI> set acl target1.test disable Access Controls Disabled on Target target1.
set auto_path_change Description for dual-controller configurations only, turns on or off automatic, MSA-based I/O load balancing. If automatic path changes are enabled, the controller firmware may subsequently and automatically change controller paths for a target, based on I/O load. Syntax set auto_path_change enable|disable [prp=<#>] [mnr=<#>] [twp=<#>] [twl=<#>] Operands enable|disable Enables or disables automatic path changes.
set certificate Description Sets the SSL certificate to be used by the management interface. This is used to load a real certificate in place of the default self-signed certificate generated by the management interface. When this command is executed, the user is prompted to paste in the PEM-encoded data for their certificate and private key.
set discovery Description Enables or disables SLP and iSNS discovery on an iSCSI target. Syntax set discovery [slp=enable|disable] [isns=enable|disable] Operands The alias name of the target. slp=enable|disable [Optional] Enables or disables SLP for this target. If this operand is not specified, the current setting is kept. isns=enable|disable [Optional] Enable or disables iSNS for this target. If this operand is not specified, the current setting is kept.
set globals Description Sets the expand priority, the read/write ratio, or the system name, depending on the parameters specified. NOTE: All operands are optional, but at least one must be specified for the command to be valid.
[Optional] The write cache as a percentage of the total cache. The value of must be between 0 and 100, and the sum of the read cache and write cache must equal 100.
set initiator Description Sets the profile (operating system) associated with the initiator. If the profile is not set for an initiator, a default profile is assigned. Syntax set initiator profile= Operands The alias name of the iSCSI initiator. profile= The operating system profile to associate with the initiator, where is one of the following entries: windows—for Microsoft Windows servers. linux—for Linux servers. hp—for HP-UX servers.
set initiator_chap Description Sets the CHAP secret (password) for an iSCSI initiator in mutual CHAP authentication. Syntax set initiator_chap Operands The alias of the iSCSI initiator. The CHAP secret (12–16 character password) for the initiator.
set iscsi_keys Description Sets iSCSI login parameter keys for an iSCSI target. Syntax set iscsi_keys [=] NOTE: For the optional parameter value, to reset all the keys to their default values, enter default. Operands Specifies the alias name of the iSCSI target.
Example 1 CLI> set iscsi_keys target1 authentication=chap The new values were set successfully. Example 2 CLI> set iscsi_keys target1 default The new values were set successfully.
set isns Description Sets the iSNS parameters. Syntax set isns [service=enable|disable] [server_discovery=manual|dhcp|slp] [esi=] [entity=] Operands service=enable|disable [Optional] Enables or disables iSNS on the MSA1510i. server_discovery=manual|dhcp|slp [Optional] The method used to discover iSNS servers. • Use manual if the iSNS servers are being added manually. (Default) • Use dhcp if the iSNS servers are being discovered via DHCP.
set management Description Sets global management interface settings for the system. Syntax set management [disable|enable] [port=] [dhcp=] [hostname=] [domain=] [ip=[/]|default>] [gateway=] [dns1=] [dns2=] [vlan=] [ntp=] Operands NOTE: Although all parameters are optional, at least one parameter must be supplied for the command to be valid. NOTE: If a parameter is not specified then the current setting must not be changed.
gateway= The IP address, in doted notation. dns1= The IP address, in doted notation. dns2= The IP address, in doted notation. vlan= The VLAN ID (1-4096, or none to disable VLAN tagging). ntp= The IP address, in doted notation. Example 1 To set up the management interface to use port MA0, and to activate DHCP for the management interface: CLI> set management port=MA0 dhcp=enable Management settings changed.
set management_login Configures the login and password used to access the management interface. The command prompts you to enter your old username and password, and then enter the new username and password. If you have forgotten your old password, use the reset management_login command, or reset the password using the front panel display. Description NOTE: The default factory setting for both the username and password is root.
set port Description Enables or disables a physical port. NOTE: By default, all ports are enabled. Syntax set port enable|disable Operands The name of the physical port. For example: SA0. enable|disable Enable or disable the port. Example To enable port SA1: CLI> set port sa1 enable The operation was successful.
set preferred_path Description For dual-controller configurations only, this command either sets the controller ownership (path) for the specified LUNs, or, resets the preferred path of the specified LUNs to the last explicitly-set path. When executing this command, please note that I/O will be delayed slightly during the transfer of ownership. NOTE: If auto_path_change is enabled, the firmware may subsequently, automatically change the path of the LUN. For more information see set auto_path_change.
set prompt Description Changes the CLI prompt from the default of CLI>. Syntax set prompt Operands The text to use as the CLI prompt. The name can be up to 24 alphanumeric characters.
set service Description Configures the management interface network services. Syntax set service enable|disable port= Operands The name of the management interface service. Valid entries include the following: telnet—Telnet-based CLI interface ssh—SSH-based CLI interface http—Unencrypted web interface https—SSL-encrypted web interface snmp—SNMP agent enable|disable Enables or disables the service.
set snmp Description Configures the settings for the embedded SNMP agent. NOTE: Although all parameters are optional, at least one parameter must be supplied for the command to be valid. NOTE: If a parameter is not specified then the current setting remains unchanged.
set target_chap Description Sets the CHAP secret (password) used to access an iSCSI target when CHAP is enabled. To enable CHAP authentication on the target, use the set iscsi_keys command. Syntax set target_chap Operands The alias name of the iSCSI target. The CHAP secret (12–16 character password) used to access an iSCSI target when CHAP is enabled.
set this_controller|other_controller Description Sets the baud rate for the CLI serial port on the specified controller. NOTE: When using this command, you must also adjust the terminal speed on your client to match the setting. In dual-controller configurations, each controller has its own setting. Changing the speed on one controller does not affect the other controller.
set this_controller_id|other_controller_id Description Assigns a name or identifier to the controller. Syntax set this_controller_id or set other_controller_id Operands this_controller The controller to which the CLI session is connected. other_controller The other MSA controller. The name to assign to the specified controller, where is a string of up to 230 alphanumeric characters or a decimal number in the range of 0–65535.
set unit Description Enables or disables the array accelerator cache for a specific LUN. Syntax set unit cache=enable|disable Operands The number (0-31) of the LUN to modify. cache=enable|disable Enables or disables the use of the array accelerator cache for the specified LUN. Example 1 To enable the cache on unit 0: CLI> set unit 0 cache=enable Cache for unit 0 has been enabled. Example 2 To disable the cache on unit 1: CLI> set unit 1 cache=disable Cache for unit 0 has been enabled.
set unit_id Description Assigns a unique user-friendly name (alias) to a LUN. A user-defined name makes it easier to identify specific LUNs in other configuration procedures. Syntax set unit_id Operand The unit number (0-31) of the LUN. The user-friendly name (alias) to assign to the LUN. The ID can be up to 230 alphanumeric characters or a decimal number in the range of 0 through 65535. If spaces are included within the name, quotation marks are required.
show acl_entry Description Shows the access control lists for all initiators on a specified iSCSI target, or on all targets. NOTE: If access controls are disabled, a message is displayed. Syntax show acl_entry [target=] Operands target= [Optional] Limits the display to the ACL entries for a specific target, indicated by the target alias name. If this operand is not used, the complete ACL is displayed.
show adu_page Description Shows the specified ADU (Array Diagnostic Utility) XML report. You must capture the output in a capture file using the procedure below. After output is completed, a 30–second time window is given to close the capture file. NOTE: The preferred method of creating and viewing the ADU report is through the SMU.
show arp Description Shows the ARP table of the storage ports. Syntax show arp Operands None Example CLI> show arp IP Address --------------127.0.0.1 10.0.8.
show auto_path_change Description Shows whether implicit (automatic) path changing enabled and lists the criteria that must be met for an automatic LUN ownership change. Syntax show auto_path_change Operands None Example CLI> show auto_path_change Implicit (automatic load-based) LUN ownership changes are currently ENABLED. Implicit LUN ownership change preferences are as follows: Minimum % of proxied requests to trigger implicit path change..
show box Description Displays information about the specified hard drive storage enclosure. If a box number is not entered, information on all attached storage enclosures is displayed. Syntax show box [<#>] Operands <#> [Optional] Limits the display to information about a specific hard drive storage enclosure. For more information about box numbers and identifying boxes, see locate.
show cacheinfo Description Displays controller cache status.
show certificate Description Displays the SSL certificate being used by the management interface. Syntax show certificate [data] Operands data [Optional] When this switch is specified, the command outputs raw data in PEM-encoded format suitable for copying/pasting into a certificate file. The private key is also shown. The purpose of this format is to allow copying the certificate and private key to a file on a remote host for backup or reuse.
show discovery Description Shows the status of SLP/iSNS discovery on the iSCSI targets. Syntax show discovery [alias=] Operands alias= [Optional] Limits the display to the iSCSI target associated with the alias name specified by .
show disks Description Lists the disks and information pertaining to them.
show drive_report Description Displays a list of system smart components that require an update. An example smart component is a hard drive. NOTE: To use this command, you must first obtain an inventory table report and download it using the HP Storage Management Utility. For more information, see the HP StorageWorks Storage Management Utility user guide.
show eventlog Description Shows a list of events logged by the controller.
show globals Description Displays the following global settings: • System name • Rebuild and expand priority settings • Read and write cache settings • EMU and power supply temperatures Syntax show globals Operands None Example CLI> SHOW GLOBALS Global Parameters: System Name: MSA-1 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: 40 Celsius, 104 Farenheit PS2: 40 Celsius, 104 Farenheit See a
show initiator Description Displays all configured iSCSI initiators. Syntax show initiator [alias=] Operands alias= [Optional] Limits the display to the SCSI initiator associated with the alias name specified by . Example CLI> show initiator Alias Name Initiator Name -----------------------------------------------initiator1 iqn.1991-05.com.microsoft:myini.domain.
show ip Description Shows the IP addresses configured for iSCSI ports. Syntax show ip [port=] Operands port= [Optional] Limits the display to the iSCSI port associated with the port name specified by . Example CLI> show ip Port IP Address ---- --------SA0 10.0.8.221 SA0 10.0.8.222 SA0 10.0.8.223 See also Subnet Mask ---------255.255.0.0 255.255.0.0 255.255.0.
show iscsi_keys Description Shows the iSCSI login parameter keys for the iSCSI targets. Syntax show iscsi_keys [alias=] Operands alias= [Optional] Limits the display to the iSCSI target associated with the alias name specified by .
show isns Description Shows the iSNS parameters. Syntax show isns Operands None Example CLI>show isns iSNS Service is enabled iSNS Server Discovery Mode is DHCP ESI Port is 50000 Entity Name is iqn.1986–03.com.hp.storage.msa1510i.
show isns_server Description Shows a list of configured iSNS servers. Syntax show isns_server Operands None Example CLI> show isns_server Alias Name IP Address -----------------------------server1.test 10.10.10.
show management Description Displays current management settings for the controller management ports. Syntax show management Operands None Example CLI> show management System Time: Thu Jan Controller A: Hostname: Management Status: Management Port: MAC Address: 802.1Q VLAN ID: DHCP Enabled: IP Address: Network Mask: Default Gateway: Primary DNS: Secondary DNS: NTP Server: sga063701p Enabled MA0 00:12:79:68:d3:c8 None No 10.10.10.3 255.0.0.0 255.255.254.0 0.0.0.0 0.0.0.0 0.0.0.
show mib2 Description Shows SNMP MIB-II data for the storage ports. If one of the optional parameters is supplied, output is limited to only show the specified data. If no parameter is specified, all available data is displayed. NOTE: The MIB-II information for the management port can only be accessed through a remote SNMP Manager. Syntax show mib2 [iface|ip|icmp|tcp|udp] Operands iface—shows the Interface MIB. ip—shows the IP MIB. icmp—shows the ICMP MIB. tcp—shows the TCP MIB. udp—shows the UDP MIB.
show perf Description Displays controller performance information that was previously gathered by initiating the start perf command. Syntax show perf [logical|physical] Operands logical [Optional] Limits the display to some additional information about the logical drives that is not included with the show perf display. Operands physical [Optional] Limits the display to some additional information about the physical hard drives that is not included with the show perf display.
show port Description Shows status information for the storage ports. Syntax show port [] Operands [Optional] The name of the physical port. For example: SA0. If no value is entered, then all ports are shown.
show portal Description Displays all configured iSCSI portals, including the alias name, IP address, port, and portal group binding. Syntax show portal [alias=] Operands alias= [Optional] Limits the display to the iSCSI portal associated with the alias name specified by . Example CLI> show portal Alias Name IP Address --------------------test-portal1 10.0.8.221 test-portal2 10.0.8.
show portal_group Description Shows all configured iSCSI portal groups. Syntax show portal_group [alias=] Operands alias= [Optional] Limits the display to the iSCSI portal group associated with the alias name specified by .
show profile Description Displays detailed attribute information about supported host modes (operating systems). Syntax show profile [ProfileName] Operands ProfileName [Optional] Limits the display to information about a specific profile. Valid entries include: windows—for Microsoft Windows servers. linux—for Linux servers. hp—for HP-UX servers. openvms—for OpenVMS servers. tru64—for Tru64 UNIX servers. solaris—for Solaris servers. netware—for Netware servers. xp—for XP servers.
show preferred_path Description Displays the current path (controller owner) for each LUN. Syntax show preferred_path Operands None Example CLI> show preferred_path Controller 1 (this_controller) is the current optimal path for these units: 1,2,3,4 Controller 2 (other_controller) is the current optimal path for these units: None Implicit (automatic load-based) LUN ownership changes are currently ENABLED.
show proxystats Description For dual-controller configurations only, displays information about commands that have been passed from one controller to the other through the inter controller link (ICL). Syntax show proxystats Operands None Example CLI> show proxystats Proxy Size Size Size Port Statistics: of Proxy IOP...112 Bytes of ProxyCmd....160 Bytes of SCSI IOP....168 Bytes THIS Controller: Max Allocated Proxy IOP Count.......0 Current Allocated Proxy IOP Count...
show route Description Shows the routing table for the storage ports. Syntax show route Operands None Example CLI> show route Destination ----------10.0.8.221 10.0.8.222 10.0.8.223 127.0.0.0 224.0.0.1 224.0.0.1 224.0.0.1 224.0.0.1 224.0.0.1 239.255.255.253 See also Gateway ------127.0.0.1 127.0.0.1 127.0.0.1 127.0.0.1 127.0.0.1 10.0.8.221 10.0.8.222 10.0.8.223 10.0.8.224 0.0.0.0 Netmask ------255.255.255.255 255.255.255.255 255.255.255.255 255.0.0.0 255.255.255.255 255.255.255.255 255.255.255.
show service Description Displays the current management interface network services configuration.
show snmp Description Displays the current settings for the embedded SNMP agent. Syntax show snmp Operands None Example CLI> show snmp Community String: System Name: System Description: System Location: System Contact: Trap Destinations: 0: 10.2.1.
show target Description Displays all configured iSCSI targets. Syntax show target [alias= [Optional] Limits the display to the iSCSI target associated with the alias name specified by . Example CLI> show target Target target1: Node Name: iqn.1986-03.com.hp.storage.msa1510i.mgates-sj.target1 LUN Mapping: No units are mapped to LUN's on this target. Target iscsi: Node Name: iscsi The “iscsi” target is the canonical target.
show taskstats Description Displays controller task statistics.
show tech_support Description Executes a macro command that runs all of the CLI show commands. You should redirect the screen output to a file before executing this command. This file can then be sent to support personnel for analysis.
show tgt_stats Description Shows iSCSI login, session, and connection statistics for an iSCSI target. Syntax show tgt_stats [target=] [output=all|common] Operands target= [Optional] Limits the display to only the specified target. By default, statistics for all targets is shown. output=all|common [Optional] If all is entered, all possible statistics are shown. If common is entered, only common statistics are shown (default).
show this_controller|other_controller Description Displays configuration information for the specified controller, such as: • Serial number • Hardware/software revision • Controller identifier • SCSI version • Redundancy mode • SCSI address • Read/write cache ratio • Cache version, cache status, and cache battery status Syntax show this_controller|other_controller Operands this_controller Show the configuration of the controller that the CLI is connected to.
show unit Description Displays information about the specified LUN, or all defined LUNs. The show unit and show units commands are identical in functionality.
See also • • • • • • • • • • • newpage pi 136 Command reference add unit bind unit delete unit set unit accept unit expand unit extend unit migrate unit set unit_id show unit_id unbind unit
show unit_id Description Displays the user-defined name (alias) assigned to a LUN. Syntax show unit_id Operands The LUN number (0-31) for which to display the alias.
show version Description Displays firmware version and hardware revision information for the MSA chassis, system modules, and attached hard drive storage enclosures. Syntax show version [-all] Operands -all [Optional] In addition to the information displayed with the version command, this also displays individual hard drive information, including capacity, firmware version, and serial number. Example CLI> show version MSA1510i Firmware Revision: 1.
start perf Description Starts the collection of controller performance analysis data. Syntax start perf Operands None Example CLI> start perf Performance Monitor started.
stop perf Description Stops the collection of controller performance analysis data. Syntax stop perf Operands None Example CLI> stop perf Performance Monitor stopped.
unbind portal Description Unbinds an iSCSI portal from a portal group, or from all portal groups if no portal group alias name is given. Syntax unbind portal [] Operands The alias name of the portal to unbind. unbind portal portal4 The portal was unbound successfully from all portal groups.
unbind portal_group Description Unbinds an iSCSI portal group from its iSCSI target. Syntax unbind portal_group Operands The alias name of the portal group. Example CLI> unbind portal_group pg4 The portal group was unbound successfully from the target.
unbind unit Description Removes the mapping of a logical unit to a LUN on an iSCSI target. After the LUN is unmapped, iSCSI initiators cannot access the underlying logical unit until it is mapped to a LUN on another target. Syntax unbind unit Operands The alias name of the mapped LUN. Example To remove the mapping defined in lun2t1: CLI> unbind unit lun2t1 LUN lun2t1 has been unmapped.
Command reference
A Storage overview • • • • Arrays and logical drives Fault-tolerance levels Comparison of RAID Methods Choosing a RAID level Arrays and logical drives The capacity and performance of a single physical hard drive is adequate for home users. However, business users demand higher storage capacities, higher data transfer rates, and greater protection against data loss when a hard drive fails.
S1 S2 S3 S4 B1 B2 B3 B4 B5 B6 B7 B8 B9 B10 B11 B12 D1 D2 D3 15312 Figure 3 Data striping (S1-S4) and data blocks (B1-B12) on multiple physical drives (D1, D2, D3) For data in the logical drive to be readable, the data block sequence must be the same in every stripe. This sequencing process is performed by the array controller, which sends the data blocks to the drive write heads in the correct order.
that was originally on the failed drive to the online spare. The system is quickly restored to full RAID-level data protection. (In the unlikely event that another drive in the array fails while data is being rewritten to the spare, the logical drive will still fail.) A spare is assigned to an array and is automatically assigned to all logical drives in the same array. You do not need to assign a separate spare to each array; you can configure one hard drive to be the spare for several arrays.
S1 B1 B2 B3 B4 S2 B5 B6 B7 B8 D1 D2 D3 D4 D5 D6 D7 D8 S1 B1 B2 B3 B4 S2 B5 B6 B7 B8 15315 Figure 6 RAID 1+0 array, with eight physical hard drives (D1 through D8) In each mirrored pair, the physical drive that is not busy answering other requests answers any read request sent to the array. (This behavior is called load balancing.) If a physical drive fails, the remaining drive in the mirrored pair can still provide all the necessary data.
Table 5 RAID 5 features Advantages Disadvantages High read performance. Relatively low write performance. No loss of data if one physical drive fails. Loss of data if a second drive fails before data from the first failed drive is rebuilt. More usable drive capacity than RAID 1+0, because parity information requires the storage space equivalent to one physical drive.
Table 7 Summary of RAID methods RAID 0 RAID 1+0 RAID 5 RAID 6 Alternative name Striping Mirroring Distributed Data Guarding (DDG) Advanced Data Guarding (ADG) Usable drive space* 100% 50% 67% to 93% 50% to 96% Usable drive space formula n n/2 (n-1)/n (n-2)/n Minimum number of physical drives 1 2 3 4 Tolerates physical drive failure? No Yes Yes Yes Tolerates simultaneous failure of more than one physical drive? No Only if no two failed drives are in a mirrored pair No Yes Re
Index A Access Control List (ACL) See ACL access controls, set on or off set acl, 77 access controls, turn on acl_entry, 28 ACL delete an entry delete acl_entry, 46 ACL, show lists for all initiators show acl_entry, 101 advanced data guarding (See RAID 6.
reset certificate, 74 reset controller, 75 reset management_login, 76 set acl, 77 set auto_path_change, 78 dual-controller system, 78 set certificate, 79 set discovery, 80 set globals, 81 set initiator, 83 set initiator_chap, 84 set iscsi_keys, 85 set isns, 87 set management, 88 set management, note, 88 set management_login, 90 set port, 91 set preferred_path, 92 dual-controller systems, 92 set prompt, 93 set service, 94 set snmp, 95 set target_chap, 96 set this_controller_id|other_controller_id, 98 set thi
F fault tolerance description of levels, 146 fault tolerance (See RAID methods.
LUNs, display current path show preferred_path, 125 LUNs, migrating migrate unit, 71 M management interface network service, configure set service, 94 management interface network services configuration, display show service, 128 management interface, configuration username and password set management_login, 90 management settings, display show management, 118 management settings, static configure, 23 mirroring of drives (See RAID 1+0.