HP HSG80 - StorageWorks RAID Array Controller User manual

hp StorageWorks
HSG80 Array Controller V8.7
Command Line Interface Reference
Guide
Part Number: EK–G80CL–RA. B01
Second Edition (August 2002)
Product Version: 8.7
This guide provides detailed descriptions of all CLI commands and
step-by-step instructions on how to use each command.

© Hewlett-Packard Company, 2002. All rights reserved.
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.
This document contains proprietary information, which is protected by copyright. No part of this
document may be photocopied, reproduced, or translated into another language without the prior
written consent of Hewlett-Packard. The information contained in this document is subject to change
without notice.
Microsoft, MS-DOS, Windows, and Windows NT are trademarks of Microsoft Corporation in the U.S.
and/or other countries.
All other product names mentioned herein may be trademarks of their respective companies.
Hewlett-Packard Company shall not be liable for technical or editorial errors or omissions contained
herein. The information is provided “as is” without warranty of any kind and is subject to change
without notice. The warranties for Hewlett-Packard Company products are set forth in the express
limited warranty statements accompanying such products. Nothing herein should be construed as
constituting an additional warranty.
Printed in the U.S.A.
HSG80 Array Controller V8.7 Command Line Interface Reference Guide
Second Edition (August 2002)
Part Number: EK–G80CL–RA. B01

HSG80 Array Controller V8.7 Command Line Interface Reference Guide iii
Contents
About this Guide
Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Symbols in Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Symbols on Equipment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Rack Stability. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Getting Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
StorageWorks Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
StorageWorks Website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viii
StorageWorks Authorized Reseller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viii
1 CLI Command Introduction
CLI Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–1
Using the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–1
Command Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2
Controller Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2
Device Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3
Selective Storage Presentation Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3
Storageset Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–4
Partition Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–4
Logical Unit Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–5
Diagnostic and Utility Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–5
Data Replication Manager (DRM) Commands . . . . . . . . . . . . . . . . . . . . . . . . 1–5
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–6
Entering CLI Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–6
Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–7
Changing the CLI Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–8
2 CLI Command Descriptions
CLI Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–1

iv HSG80 Array Controller V8.7 Command Line Interface Reference Guide
Contents
Glossary
Index

HSG80 Array Controller V8.7 Command Line Interface Reference Guide v
About this Guide
This Command Line Interface reference guide provides information to help you:
• Use the CLI commands
• Contact technical support for additional assistance
Document Conventions
The conventions included in Table 1 apply in most cases.
Symbols in Text
These 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 loss of life.
Table 1: Document Conventions
Element Convention
Key names, menu items, buttons,
and dialog box titles
Bold
File names and application names Italics
User input, command names, system
responses (output and messages)
Monospace font
COMMAND NAMES are uppercase
unless they are case sensitive
Variables Monospace, italic font
Website addresses Sans serif font (http://www.compaq.com)

About this Guide
vi HSG80 Array Controller V8.7 Command Line Interface Reference Guide
CAUTION: Text set off in this manner indicates that failure to follow directions could
result in damage to equipment or data.
IMPORTANT: Text set off in this manner presents clarifying information or specific instructions.
NOTE: Text set off in this manner presents commentary, sidelights, or interesting points of
information.
Symbols on Equipment
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.
WARNING: To reduce the risk of injury from electrical shock hazards, do
not open this enclosure.
Any RJ-45 receptacle marked with these 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 of injury from a hot component, allow the
surface to cool before touching.
Power supplies or systems marked with these symbols indicate the
presence of multiple sources of power.
WARNING: To reduce the risk of injury from electrical shock,
remove all power cords to completely disconnect power from the
power supplies and systems.

About this Guide
HSG80 Array Controller V8.7 Command Line Interface Reference Guide vii
Any product or assembly marked with these symbols indicates that the
component exceeds the recommended weight for one individual to
handle safely.
WARNING: To reduce the risk of personal injury or damage to the
equipment, observe local occupational health and safety requirements
and guidelines for manually handling material.
Rack Stability
WARNING: To reduce the risk of personal injury or damage to the equipment, be
sure that:
• The leveling jacks are extended to the floor.
• The full weight of the rack rests on the leveling jacks.
• In single rack installations, the stabilizing feet are attached to the rack.
• In multiple rack installations, the racks are coupled.
• Only one rack component is extended at any time. A rack may become
unstable if more than one rack component is extended for any reason.
Getting Help
If you still have a question after reading this guide, contact service representatives or
visit our website.
StorageWorks Technical Support
In North America, call StorageWorks technical support at 1-800-OK-COMPAQ,
available 24 hours a day, 7 days a week.
NOTE: For continuous quality improvement, calls may be recorded or monitored.
Outside North America, call StorageWorks technical support at the nearest location.
Telephone numbers for worldwide technical support are listed on the StorageWorks
website: http://www.compaq.com.
Be sure to have the following information available before calling:
• Technical support registration number (if applicable)
• Product serial numbers

About this Guide
viii HSG80 Array Controller V8.7 Command Line Interface Reference Guide
• Product model names and numbers
• Applicable error messages
• Operating system type and revision level
• Detailed, specific questions.
StorageWorks Website
The StorageWorks website has the latest information on this product, as well as the
latest drivers. Access the StorageWorks website at: http://www.compaq.com/storage.
From this website, select the appropriate product or solution.
StorageWorks Authorized Reseller
For the name of your nearest StorageWorks Authorized Reseller:
• In the United States, call 1-800-345-1518.
• In Canada, call 1-800-263-5868.
• Elsewhere, see the StorageWorks website for locations and telephone numbers.

HSG80 Array Controller V8.7 Command Line Interface Reference Guide 1–1
1
CLI Command Introduction
Command line interface (CLI) provides a set of commands used to maintain controller
parameters and manage storagesets. These CLI commands can be delivered to the
controller by any of the following means:
• A local terminal connected to the maintenance port of the controller
• A remote connection by way of the host system terminal
• The StorageWorks Command Console (SWCC)
This chapter provides a general description of the CLI interface and an outline of how
to use this interface. Chapter 2 contains a description of each CLI command with the
correct syntax and examples of usage.
CLI Overview
Issuing CLI commands via the maintenance port of the controller is the most direct
means of communicating with the controller. The CLI commands allow you to
manage the subsystem by viewing and modifying the configuration of the controller
and the devices attached to them. You can also use the CLI to start controller
diagnostic and utility programs.
While the CLI provides the most detailed level of subsystem control, a graphical user
interface (GUI) is available for use with the CLI. The GUI that is designed for use in
the application of CLI commands is called the StorageWorks Command Console
(SWCC). The SWCC replicates most of the functions available within the CLI in
graphic form and provides a user-friendly method of executing CLI commands.
Using the CLI
Access the CLI through the following methods:
• Connecting a PC or local terminal to the maintenance port on the front of the
controller.

1–2 HSG80 Array Controller V8.7 Command Line Interface Reference Guide
CLI Command Introduction
• Using the diagnostic utility protocol (DUP) utility from a system terminal, enable
a remote connection to the controller. After the controller is initially configured
and made visible to the host, other configuration tasks can be performed through
this remote connection.
• Using the SWCC by way of a PC setup on the subsystem. The SWCC can be used
to perform most of the CLI commands that the local terminal can perform.
Command Overview
CLI commands are divided into categories based on the options or structures they
control. The following sections list these command categories.
Controller Commands
Controller commands configure the maintenance terminal characteristics, CLI prompt,
and so forth. These commands are also used to shut down and restart the controller.
There are two types of controller commands: general and failover.
The CLI commands that pertain to the controllers in a general way are:
• CLEAR_ERRORS
• CONFIGURATION
•EXIT
• HELP
•POWEROFF
•RESTART
• SELFTEST
•SET
•SHOW
•RUN
• SHUTDOWN
The CLI commands controlling the failover mode of a controller pair are:
• SET FAILOVER
• SET MULTIBUS_FAILOVER
• SET NOFAILOVER

HSG80 Array Controller V8.7 Command Line Interface Reference Guide 1–3
CLI Command Introduction
• SET NOMULTIBUS_FAILOVER
Device Commands
Device commands create and configure containers made from physical devices
attached to the controller. There are two types of device commands: general and
spareset/failedset.
The CLI Commands that allow you to add and configure physical devices in general
are:
• ADD DISK
• ADD PASSTHROUGH
• CLEAR ERRORS
• DELETE
• INITIALIZE
•LOCATE
•RENAME
•SET
The CLI commands that support sparesets and failedsets include:
• ADD SPARESET
• DELETE FAILEDSET
• DELETE SPARESET
•SETFAILEDSET
• SHOW FAILEDSET
Selective Storage Presentation Commands
Selective Storage Presentation commands enable or disable access to individually
selected units from host and controller ports. Paths can be enabled or disabled either
all inclusively or specifically on a per-path basis during the addition of new units or as
a modification of existing units.
The CLI commands that pertain to the Selective Storage Presentation feature include:
• ADD UNITS (the ENABLE_ACCESS_PATH switch)
• ADD UNITS (the DISABLE_ACCESS_PATH switch)

1–4 HSG80 Array Controller V8.7 Command Line Interface Reference Guide
CLI Command Introduction
• SET unit-number (the ENABLE_ACCESS_PATH switch)
• SET unit-number (the DISABLE_ACCESS_PATH switch)
• ADD CONNECTIONS (the UNIT_OFFSET switch)
• SET connection-name (the UNIT_OFFSET switch)
Storageset Commands
Storageset commands create and configure complex containers made from groups of
device containers. These commands group device containers together and allow them
to be handled as single units. There are four types of storagesets: stripesets, RAIDsets,
striped-mirrorsets, and mirrorsets.
The CLI commands that pertain to storagesets include:
• ADD MIRRORSET
• ADD RAIDSET
• ADD STRIPESET
• DELETE
• INITIALIZE
•LOCATE
•MIRROR
• REDUCE
•RENAME
•SET
•SHOW
• UNMIRROR
Partition Commands
Partition commands create multiple logical disk units from the same container.
The CLI Commands that pertain to partitions include:
• CREATE_PARTITION
• DESTROY_PARTITION

HSG80 Array Controller V8.7 Command Line Interface Reference Guide 1–5
CLI Command Introduction
Logical Unit Commands
Logical unit commands create and optimize access to logical units made from any
container type.
The CLI commands that pertain to units include:
• ADD CONCATSETS
• ADD SNAPSHOT_UNITS
• DELETE
•LOCATE
•RENAME
• RETRY_ERRORS UNWRITEABLE_DATA
•SET
•SHOW
Diagnostic and Utility Commands
Diagnostic and utility commands perform general controller support functions.
The commands that pertain to the diagnostics and utilities include:
•DIRECTORY
•RUN
Data Replication Manager (DRM) Commands
DRM uses the peer-to-peer remote copy function of the HSG80 controller to achieve
data replication. HSG80 controller pairs at the initiator site are connected to a partner
HSG80 controller pair at the target site. Remote copy sets are created from units at the
initiator and target sites. These remote copy sets are mirrors of each other.
The HSG80 controllers provide failover and failback capabilities in case of failures.
Failover makes the data available at the target site after a failure. Failback is used to
move data operations back to the initiator site once the site is back online.
NOTE: All DRM commands are hidden and inoperative until the controller pair is put into
remote copy mode by specifying the REMOTE_COPY switch of the SET controller command.
DRM applies only to the HSG80 array controller running ACS version 8.7P.
The CLI commands used to configure a DRM environment and for failover and
failback procedures include:

1–6 HSG80 Array Controller V8.7 Command Line Interface Reference Guide
CLI Command Introduction
• ADD ASSOCIATIONS
• ADD REMOTE_COPY_SET
• DELETE association-set-name
• DELETE remote-copy-set-name
•SETassociation-set-name
•SETremote-copy-set-name
• SITE FAILOVER
Getting Help
To get help with using the CLI commands, enter HELP at the CLI prompt. The
resulting display shows an overview of the CLI Help System. To obtain help with a
specific command or to determine what switches are available with a command, enter
as much of the command syntax that is known, followed by a space and a question
mark.
For example, to get information on the switches used with the SET
THIS_CONTROLLER command, enter:
SET THIS_CONTROLLER=?
To see what is allowed for a prompt, enter the following:
SET THIS PROMPT=?
Entering CLI Commands
Use the following tips and techniques for the entering of CLI commands:
• Commands are not case-sensitive.
• For most commands, only enter enough of the command to make the command
unique. For example, SHO is the same as entering SHOW.
• The controller processes each command in sequence, regardless of the number of
commands entered. A controller experiencing heavy data I/O might respond
slowly to CLI commands.
Specific keys or a combination of keys allow the ability to recall and edit the last four
commands. This feature can save time and help prevent mistakes when entering
similar commands during the configuration process. Table 1–1 lists the keys used to
recall and edit commands.

HSG80 Array Controller V8.7 Command Line Interface Reference Guide 1–7
CLI Command Introduction
Command Syntax
Each CLI command is described using the following structure:
COMMAND <PARAMETER_NAME=parameter> SWITCHES
• COMMAND—A word or phrase expressed as a verb that is used to instruct the
controller what to do. Commands are represented in this guide in capitalized form.
Table 1–1: Recall and Edit Command Keys
Key Function
Up Arrow key or Ctrl+B
keys,
Down Arrow key or
Ctrl+Nkeys
Steps forwards or backward through the four most
recent CLI commands.
Left Arrow key or
Ctrl+Dkeys,
Right Arrow key or
Ctrl+Fkeys
Moves the cursor left or right in a command line.
Ctrl+Ekeys Moves the cursor to the end of the line.
Ctrl+Hkeys Moves the cursor to the beginning of the line.
Ctrl+Jkeys or Linefeed
key
Deletes the word to the left of the cursor.
Ctrl+Ukeys Deletes all characters on the same line as the
cursor.
Ctrl+Akeys or F14 key Toggles between insert and overstrike mode:
• The default setting is insert mode allowing you
to insert characters at the cursor location
(moving the existing characters to the right).
• Overstrike mode replaces existing characters.
The CLI prompt returns to insert mode at the
beginning of each line.
Ctrl+Rkeys Recalls the contents of the command line. This
function is especially helpful if the system issues a
message that interrupts your typing.

1–8 HSG80 Array Controller V8.7 Command Line Interface Reference Guide
CLI Command Introduction
• PARAMETER_NAME—The name of a parameter, followed by an equal sign and
the parameter variable. If a specific command specifies parameter names, they
must be entered in the command string. Parameter names are represented in this
guide in capitalized form.
•parameter—When required in the command, parameters are used as one or more
words or phrases that supply necessary information to support the action of the
COMMAND. Note that not all CLI commands require parameters. Parameters are
represented in this guide as lowercase, italicized text.
•SWITCHES—An optional word or phrase that modifies the command/parameter
string. Not all CLI commands require switches. Switches are represented in this
guide as capitalized, italicized text.
Changing the CLI Prompt
Change the CLI prompt display by using the SET controller PROMPT command.
Enter a 1- to 16- character string as the new prompt. For example, the prompt could be
changed to indicate the array controller type, such as “HSG>.”

HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–1
2
CLI Command Descriptions
The previous chapter provided a general description of the CLI interface and an
outline of how to use the interface. This section contains the CLI command
descriptions that contain the description, full syntax, and examples of the use of each
command available on the CLI interface.
CLI Command Descriptions
This section contains the descriptions of the available CLI commands used with the
ACS versions 8.7F, 8.7G, 8.7P, and 8.7S software. Each command is described using
the following format:
• Command name and brief description
• Syntax needed to enable command
• Parameters needed (if any) to further specify the command
• Switches needed (if any) to modify the command
• Example(s) to illustrate the command usage
• A “See Also” section to cross-reference to others with similar usage

2–2 HSG80 Array Controller V8.7 Command Line Interface Reference Guide
CLI Command Descriptions
An association set is a group of remote copy sets that shares common attributes (See
SET ASSOCIATIONS for the attribute list). This command adds an association set to
the controller pair’s configuration. The association set can be initialized with a single
remote copy set through the use of the remote-copy-set-name switch. Additional
remote copy sets can be added to the association set with the SET
association-set-name command.
NOTE: This command is hidden and inoperative until the controller pair is put into remote copy
mode by specifying the REMOTE_COPY switch of the SET controller command.
This command is valid only on the node on which the Initiator resides (where remote copy sets
are configured).
This command is rejected if the specified remote copy set is unknown to the controller
pair.
Syntax
ADD ASSOCIATIONS association-set-name
Parameters
The following parameters are required for the ADD ASSOCIATIONS command:
association-set-name
The association-set-name may consist of a maximum of nine printable characters
excluding commas and back-slashes.
NOTE: Association sets cannot be renamed with the RENAME command. If the wrong
name is entered, the association set must be deleted and then added again.
Switches
The following switch is available with the ADD ASSOCIATIONS command:
remote-copy-set-name
The name of the first member of the association set.
Examples
To create an association set, AS3, from remote copy sets RSC1 and RSC2, enter:
ADD ASSOCIATIONS AS3 RSC1
SET AS3 ADD=RSC2
ADD ASSOCIATIONS

HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–3
ADD ASSOCIATIONS
See Also
ADD REMOTE_COPY_SETS
SET association-set-name
SHOW ASSOCIATIONS
SHOW association-set-name

2–4 HSG80 Array Controller V8.7 Command Line Interface Reference Guide
CLI Command Descriptions
Creates a specialized volume, called a concatset (short for concatenation set), from a
storageset that has been given a unit number. Another storageset can then be added to
the concatset by the SET CONCATSETS command, thereby dynamically increasing
the size of the unit.
CAUTION: This command should only be executed with host operating systems that
support dynamic volume expansion. If the operating system cannot handle one of its
disks increasing in size, use of this command could make data inaccessible.
Syntax
ADD CONCATSETS concatset-name storageset-name
Parameters
The following parameters are required for the ADD CONCATSETS command:
•concatset-name
•storageset-name
These parameters are described in the following paragraphs:
concatset-name
The name to be assigned to the concatenation, or concatset.
The concatset-name must consist of a string of up to nine printable characters
excluding commas and back-slashes.
storageset-name
Designates the first storageset to be a member of the concatset. The storageset
specified must already be configured as a unit.
Switches
There are no switches associated with this command.
ADD CONCATSETS