HSJ80 Array Controller
ACS Version 8.5J-2
CLI Reference Guide
Second Edition (August 2000)
Part Number: EKHSJCL-RA. B01
Compaq Computer Corporation
2000 Compaq Computer Corporation.
COMPAQ, the Compaq logo, and StorageWorks Registered in U. S. Patent and Trademark Office.
NonStop and OpenVMS are trademarks of Compaq Information Technologies Group, L.P.
All other product names mentioned herein may be trademarks of their respective companies.
Confidential computer software. Valid license from Compaq 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.
Com paq shall not be liable for technical or editorial errors or omissions contained herein. The
information in this document is subject to change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS
WITH RECIPIENT. IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT,
CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE OR OTHER DAMAGES WHATSOEVER
(INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS,
BUSINESS INTERRUPTION OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS
BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND WHETHER IN AN ACTION
OF CONTRACT OR TORT, INCLUDING NEGLIGENCE.
The limited warranties for Compaq products are exclusively set forth in the documentation
accompanying such products. Nothing herein should be construed as constituting a further or
additional warranty.
Compaq StorageWorks HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
Second Edition (August 2000)
Part Number EKHSJCL-RA. B01
Contents
About This Guide
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Special Notices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Text Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Related Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
CLI Command Introduction
CLI Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Using the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Command Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Controller Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Device Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Storageset Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Partition Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Logical Unit Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Diagnostic and Utility Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Entering CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
CLI Command Descriptions
CLI Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
ADD CDROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
ADD DISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
ADD LOADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
iv HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
ADD MIRRORSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
ADD OPTICAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
ADD PASSTHROUGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
ADD RAIDSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
ADD SPARESET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
ADD STRIPESET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
ADD TAPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
ADD UNIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
CLEAR_ERRORS CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
CLEAR_ERRORS this_ controller INVALID_CACHE CLEAR_ERRORS other_
controller INVALID _CACHE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
CLEAR_ERRORS device-name UNKNOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
CLEAR_ERRORS unit-number LOST_DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
CLEAR_ERRORS unit-number UNWRITEABLE_DATA . . . . . . . . . . . . . . . . . . . . . . . . 239
CONFIGURATION RESET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
CONFIGURATION RESTORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
CONFIGURATION SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
CREATE_PARTITION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
DELETE container-name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
DELETE FAILEDSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
DELETE SPARESET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
DELETE unit-number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
DESTROY_PARTITION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
DIRECTORY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
INITIALIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
LOCATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
MIRROR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
REDUCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
RESTART this_controller RESTART other_controller . . . . . . . . . . . . . . . . . . . . . . . . . . 272
RETRY_ERRORS unit-number UNWRITEABLE_DATA . . . . . . . . . . . . . . . . . . . . . . . . 274
RUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
SELFTEST this_controller SELFTEST other_controller . . . . . . . . . . . . . . . . . . . . . . . . . 278
SET controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
SET device-name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
SET FAILEDSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
SET FAILOVER COPY=this_controller SET FAILOVER COPY=other_controller . . . 285
SET mirrorset-name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
SET NOFAILOVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
SET RAIDset-name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
SET this_controller SET other_controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
SET unit-number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2104
v
SHOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2110
SHUTDOWN this_controller SHUTDOWN other_controller . . . . . . . . . . . . . . . . . . . 2116
UNMIRROR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2118
Glossary
Index
vi HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
Tables
Table 11 Recall and Edit Command Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Table 21 ADD UNIT Switches for New Containers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Table 22 SET controller Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
Table 23 SET unit_number Switches for Existing Containers . . . . . . . . . . . . . . . . . . . . . . . 2104
About This Guide
This guide describes the Command Line Interpreter (CLI) of the HSJ80 Array Controller
running Array Controller Software (ACS) Version 8.5J-2. This guide is divided into an
overview section and a command description section. The overview provides a general
description of the CLI interface and an outline of how to use it. The command description
contains the description, full syntax, and examples of the use of each command available
on the CLI interface.
This book does not contain information about the operating environments to which the
controller may be connected, nor does it contain detailed information about subsystem
enclosures or their components. See the documentation that accompanied these
peripherals for that information.
Conventions
This book uses the following special notices and typographical conventions to help you
find what you are looking for:
Special Notices
This book does not contain detailed descriptions of standard safety procedures; however, it
does contain warnings for procedures that could cause personal injury, and cautions for
procedures that could damage the controller or its related components. Look for these
symbols when you are carrying out the procedures in this book:
viii HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
WARNING: A Warning contains information essential to people's safety. It advises
users that failure to take or avoid a specific action could result in physical harm to the
user or hardware. Use a warning, not a caution, when such damage is possible
CAUTION: A Caution contains information that the user needs to know to avoid
damaging the software or hardware.
IMPORTANT: An Important note is a type of note that provides information essential to the
completion of a task. Users can disregard information in a note and still complete a task, but
they should not disregard an important note.
NOTE: A note indicates neutral or positive information that emphasizes or supplements
important points of the main text. A note supplies information that may apply only in special
cases--for example, memory limitations, equipment configurations, or details that apply to
specific versions of a program.
About This Guide ix
Text Conventions
Convention Meaning
ALLCAPS Command syntax that must be entered exactly as shown, for example:
SET FAILOVER COPY=OTHER
Command syntax that is discussed within text, for example:
ALLCAPS
"Use the SHOW SPARESET command to show the contents of the
spareset."
MONOSPACED SCREEN DISPLAYS ARE IN UPPER-CASED MONOSPACED FONT.
Sans serif italic Command variable or numeric value that you supply, for example:
Sans serif italic SHOW RAIDset-name or
SET THIS_CONTROLLER PORT_1_SCS_NODENAME="xxxxxx"
Reference to other books, for example:
italic
"Refer to the Compaq StorageWorks HSJ80 Array Controller Configuration
Guide for details."
. Indicates that a portion of an example or figure has been omitted.
The controller serving your current CLI session through a local or remote terminal
"this controller"
The controller in a dual-redundant pair that is connected to the controller serving
"other controller"
your current CLI session.
x HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
Related Publications
The following table lists some of the documents related to the use of the controller, cache
module, and external cache battery.
Document Title 6-3 Part Numbers 2-5-2 Part Numbers
Compaq StorageWorks HSJ80 Array Controller 163134-001 EK-HSJMS-SA
ACS Version 8.5J-2 Maintenance and Service Guide
Compaq StorageWorks HSJ80 Array Controller 163133-001 EK-HSJAC-PA
ACS Version 8.5J-2 Configuration Procedures Guide
Compaq StorageWorks HSJ80 Array Controller 163132-001 EK-HSJCP-PA
ACS Version 8.5J-2 Configuration Planning Guide
Compaq StorageWorks HSJ80 Array Controller N/A EK-HSJSO-OA
ACS Version 8.5J-2 Software Solution Kit Overview
Compaq StorageWorks DS-BA356-MW Controller 143876-001 EK-356MW-IA
Enclosure Upgrade/Add-on Kit Installation Guide
Compaq StorageWorks DS-BA356-MW Controller 143177-001 EK-356MW-QA
Enclosure Upgrade/Add-on Kit Quick Setup Guide
Compaq StorageWorks DS-BA356-MW Controller 143875-001 EK-356MW-UA
Enclosure User Guide
Compaq StorageWorks HSJ80 Array Controller 163135-001 EK-HSJAA-RA
ACS Version 8.5J-2 for OpenVMSTM Release Notes
Revision History
Second Release: August 2000
First Release: December 1999
1
Chapter
CLI Command Introduction
Command Line Interpreter (CLI) commands are used to interact with your controller to
establish various controller parameters and storagesets. These CLI commands can be
entered into the controller by any of the following means:
s A local terminal connected to the maintenance port of the controller
s A remote connection by way of the host system terminal
s The StorageWorks Command Console (SWCC)
This overview section provides a general description of the CLI interface and an outline of
how to use it. The next section contains a description of each CLI command with the
correct syntax and examples of useage.
CLI Overview
The CLI is one of the user interfaces through which you control your Compaq
StorageWorks array controller in the storage subsystem (the CLI being the most direct).
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.
1 2 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
CLI commands for configuring and viewing the controllers use the relative terms "this
controller" and "other controller." See "Text Conventions," page ix, for an explanation of
these terms.
Using the CLI
You can access the CLI through the following methods:
s Connecting a local terminal/PC to the maintenance port on the front of the controller.
s Using the DUP utility from a system terminal, you may also enable a remote
connection to the controller. After you have initially configured the controller and
made it visible to the host, you can perform other configuration tasks through this
remote connection.
s 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.
Command Overview
CLI commands are divided into categories based on the options or structures they control.
The following is a list of the 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:
s CLEA R_ERRO RS
CLI
INVALID_CACH E
s CONFIGURATION
RESET
RESTORE
SAVE
s EXIT
s HELP
CLI Command Introduction 1 3
s RESTART
s SELFTEST
s SET this controller SET other controller
s SHOW
s RUN
s SHUTDOW N this controller SHUTDOWN other controller
The CLI commands controlling the failover mode of a controller pair are:
s SET FAILOVER
s SET NOFAILOVER
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:
s ADD DISK
s ADD TAPE
s ADD CDROM
s ADD LOADER
s ADD OPTICAL
s ADD PASSTHROUGH
s CLEA R ERRORS
LOST_DATA
UNKNOWN
UNWRITEABLE_DATA
s DELETE container-name
s INITIALIZE container-name
s LOCATE
s RENAME
1 4 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
s SET device-name
s SHOW
The CLI commands that allow you to change the sparesets/failedsets are:
s ADD SPARESET
s DELETE FAILEDSET
s DELETE SPARESET
s SET FAILEDSET
s SHOW
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 are:
s ADD MIRRORSET
s ADD RAIDSET
s ADD STRIPESET
s DELETE container-name
s INITIALIZE container-name
s LOCATE
s MIRROR
s REDUCE
s RENAME
s SET mirroeset-name SET RAIDset-name
s SHOW
s UNMIRROR
CLI Command Introduction 1 5
Partition Commands
Partition commands create multiple logical disk units from the same container.
The CLI Commands that pertain to partitions are:
s CREATE_PARTITION
s DESTROY_PARTITION
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 are:
s ADD UNIT
s DELETE unit-number
s LOCATE
s RETRY_ERRORS UNWRITEABLE_DATA
s SET unit-number
s SHOW
Diagnostic and Utility Commands
Diagnostic and utility commands perform general controller support functions.
The commands that pertain to the diagnostics and utilities are:
s DIRECTORY
s RUN
1 6 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
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 as you know, 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 ?
To see what is allowed for a prompt, enter the following:
SET THIS PROMPT=?
See the HELP command on Page 257 for further information.
Entering CLI Commands
Use the following tips and techniques for the entering of CLI commands:
s Commands are not case-sensitive.
s For most commands, you only need to enter enough of the command to make the
command unique. For example, SHO is the same as entering SHOW.
s The controller processes each command in sequence. You can continue entering
subsequent commands while the controller is processing prior commands. A controller
experiencing heavy data I/O may respond slowly to CLI commands.
Specific keys or a combination of keys allow you to recall and edit the last four
commands. This feature can save time and help prevent mistakes when you need to enter
similar commands during the configuration process. Table 11 lists the keys used to recall
and edit commands.
CLI Command Introduction 1 7
Table 11 Recall and Edit Command Keys
Key Function
Up Arrow or Ctrl/B, Steps forwards or backward through the four most recent CLI
Down Arrow or Ctrl/N commands
Left Arrow or Ctrl/D, Moves the cursor left or right in a command line
Right Arrow or Ctrl/F
Ctrl/E Moves the cursor to the end of the line
Ctrl/H or Backspace Moves the cursor to the beginning of the line
Ctrl/J or Linefeed Deletes the word to the left of the cursor
Ctrl/U Deletes all characters on the same line as the cursor
Ctrl/A or F14 Toggles between insert and overstrike mode:
s The default setting is insert mode allowing you to insert
characters at the cursor location (moving the existing
characters to the right).
s Overstrike mode replaces existing characters. The CLI prompt
returns to insert mode at the beginning of each line.
Ctrl/R Recalls the contents of the command line. This function is
especially helpful if the system issues a message that interrupts
your typing.
1 8 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
Command Syntax
Each CLI command is described using the following structure:
COMMAND SWITCHES
s COMMAND--A word or phrase expressed as a verb that is used to instruct the
controller what to do. Commands are represented in this manual in capitalized form.
s 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 manual in
capitalized form.
s parameter--W hen 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
representedin this manual as lowercase, italicized text.
s SWITCHES--An optional word or phrase that modifies the command/parameter
string. Not all CLI commands require switches. Switches are represented in this
manual as capitalized, italicized text.
2
Chapter
CLI Command Descriptions
The previous chapter provided a general description of the CLI interface and an outline of
how to use it. This section contains the CLI command descriptions which 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
Version 8.5J-2 software. Each command is described using the following format:
s Command name and brief description
s Syntax needed to enable command
s Parameters needed (if any) to further specify the command
s Switches needed (if any) to modify the command
s Example(s) to illustrate the command usage
s A "See Also" section to cross-reference to others with similar usage
22 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
ADD CDROM
Names a CD-ROM and adds it to the controller configuration.
Syntax
ADD CDROM container-name scsi-port-target-lun
Parameters
The following parameters are required for the ADD CDROM command:
s container-name
s scsi-port-target-lun
These parameters are described in the following paragraphs.
container-name
Assigns a name to the CD-ROM device. This container name is then used with the
ADD UNIT command to create a single-disk unit.
The container name must start with a letter (A through Z) and may consist of a
maximum of nine characters including letters A through Z, numbers 0 through 9,
periods (.), dashes (-), or underscores (_).
It is common to name a CD-ROM drive DISKpttll, where pttll is the device
Port-Target-LUN address. Although other naming conventions are acceptable, this
naming convention presents the type of disk drive and its SCSI location.
scsi-port-target-lun
Indicates the SCSI device PTL address. Place one space between the port number,
target number, and the LUN number when entering the PTL address.
port--Designates the SCSI device port number, from 1 to 6, on which the disk
resides.
target--Designates the SCSI target ID of the disk on the port. There can be up to
14 devices addressed. The device storage enclosures use target IDs of 00-05 and
08-15 (the controllers use 06 and 07).
lun--Indicates the LUN of the disk drive, and is always zero.
ADD CDROM 2 3
NOTE: Refer to the Compaq StorageWorks HSJ80 Array Controller ACS Version 8.5J for
OpenVMS Release Notes to determine whether the disk drive you are planning to use is
compatible with the controller.
Switches
The following switch is available with the ADD CDROM command:
TRANSFER_RATE_REQUESTED=
This switch is described in the following paragraph.
TRANSFER_RATE_REQUESTED=ASYNCHRO NOUS
TRANSFER_RATE_REQUESTED=20MHZ default)
TRANSFER_RATE_REQUESTED=10MHZ
TRANSFER_RATE_REQUESTED=5MH Z
Specifies the maximum data transfer rate at which the controller is to communicate
with the disk drive. The transfer rate might need to be limited to accommodate long
cables between the controllers and the device.
Exam ples
To add CDR10000 at port 1, target 0, LUN 0, enter:
ADD CDROM CDR10000 1 0 0
To add CDR40200 as a disk drive to port 4, target 2, LUN 0, enter:
ADD CDROM CDR40200 4 2 0
To add a CD-ROM drive named CDR30200 as a disk to port 3, target 2, LUN 0 and set the
data transfer rate to 10 MHz, enter the following on one line:
ADD CDROM CDR30200 3 2 0 TRANSFER_RATE_REQUESTED=10MHZ
See also
ADD UNIT
DELETE container-name
LOCATE
SHOW DEVICES
SET container-name
24 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
ADD DISK
Names a disk drive and adds it to the controller configuration. This command is typically
used when disk drives are added to a previously configured subsystem. During initial
setup, the entire disk set is customarily added to the controller's configuration through the
CONFIG utility.
Syntax
ADD DISK container-name scsi-port-target-lun
Parameters
The following parameters are required for the ADD DISK command:
s container name
s scsi-port-target-lun
These parameters are described in the following paragraphs.
container-name
Assigns a name to the disk device. This container name is then used with the ADD
UNIT command to create a logical unit. It is also used as a parameter in the adding of
a storageset.
The disk name must start with a letter (A through Z) and may consist of a maximum of
nine characters including letters A through Z, numbers 0 through 9, periods (.), dashes
(-), or underscores (_).
It is common to name a disk drive DISKpttll, where pttll is the disk's Port-Target-LUN
address. Although other naming conventions are acceptable, this naming convention
presents the type of disk drive and its SCSI location.
ADD DISK 2 5
scsi-port-target-lun
Indicates the SCSI device PTL address. Place one space between the port number,
target number, and the LUN number when entering the PTL address.
port--Designates the SCSI device port number, from 1 to 6, on which the disk
resides.
target--Designates the SCSI target ID of the disk on the port. There can be up to
14 devices addressed. The device storage enclosures use target IDs of 00-05 and
08-15 (the controllers use 06 and 07).
lun--Indicates the LUN of the disk drive and is always zero.
NOTE: Refer to the Compaq StorageWorks HSJ80 Array Controller ACS Version 8.5J for
OpenVMS Release Notes to determine whether the disk drive you are planning to use is
compatible with the controller.
Switches
The following switches are available with the ADD DISK command:
s TRANSFER_RATE_REQUESTED
s TRANSPORTABLE
These switches are described in the following paragraphs.
TRANSFER_RATE_REQUESTED=ASYNCHRO NOUS
TRANSFER_RATE_REQUESTED=20MHZ (default)
TRANSFER_RATE_REQUESTED=10MHZ
TRANSFER_RATE_REQUESTED=5MH Z
Specifies the maximum data transfer rate at which the controller is to communicate
with the disk drive. The transfer rate might need to be limited to accommodate long
cables between the controllers and the device.
26 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
TRANSPORTABLE
NOTRANSPORTABLE (default)
Indicates whether a disk drive can be accessed exclusively by StorageWorks
controllers or may be used by non-StorageWorks systems:
TRANSPORTABLE = disk drives do not contain any metadata or restricted areas.
Therefore, transportable disks forfeit the advantage metadata provides, but can be
moved to a non-StorageWorks environment with their data intact. Disks that are to
be used in storagesets cannot be set as transportable.
NOTRANSPORTABLE = the controller makes a small portion of the disk
inaccessible to the host. This restricted space is used to store administrative
information (metadata) used to improve data reliability, error detection, and the
ability to recover data. As a result of this metadata, only StorageWorks controllers
can retrieve data from non-transportable devices.
If you specify the NOTRANSPORTABLE switch and there is no metadata on the unit,
the unit must be initialized. If you specify TRANSPORTABLE for a disk that was
originally initialized as a NOTRANSPORTABLE, you should initialize the disk.
NOTE: Compaq recommends you avoid using transportable disks unless there is no other way
to move the data.
Exam ples
To add DISK10000 at port 1, target 0, LUN 0, enter:
ADD DISK DISK10000 1 0 0
To add DISK40200 as a transportable disk drive to port 4, target 2, LUN 0, enter:
ADD DISK DISK40200 4 2 0 TRANSPORTABLE
To add a disk drive named DISK30200 as a non-transportable disk to port 3, target 2, LUN
0 and set the data transfer rate to 10 MHz, enter the following on one line:
ADD DISK DISK30200 3 2 0 NOTRANSPORTABLE TRANSFER_RATE_REQUESTED=10MHZ
To create a host-addressable unit after the disk is added, enter:
INITIALIZE DISK40200
ADD UNIT D199 DISK40200
ADD DISK 2 7
See also
ADD UNIT
DELETE container-name
INITIALIZE
LOCATE
SHOW DISKS
SHOW DEVICES
SET container-name
28 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
ADD LOADER
Names a device loader (optical or tape) and adds it to the controller configuration.
Syntax
ADD LOADER container-name scsi-port-target-lun
Parameters
The following parameters are required for the ADD LOADER command:
s container-name
s scsi-port-target-lun
These parameters are described in the following paragraphs.
container-name
Assigns a name to the device loader. This is the name used with the ADD
PASSTHROUGH command to create a passthrough container to access the loader.
The name must start with a letter (A through Z) and may consist of a maximum of nine
characters including letters A through Z, numbers 0 through 9, periods (.), dashes (-),
or underscores (_).
It is common to name a loader LOADn, where n is a sequentially assigned, unique
identifier. Other naming conventions are acceptable, but this naming convention
presents both the type of container and its unique identifier in an intuitive manner.
scsi-port-target-lun
Indicates the SCSI device PTL address. Place one space between the port number,
target number, and the LUN number when entering the PTL address.
port--Designates the SCSI device port number, from 1 to 6, on which the disk
resides.
target--Designates the SCSI target ID of the loader on the port. There can be up to
14 devices addressed. The device storage enclosures use target IDs of 00-05 and
08-15 (the controllers use 06 and 07).
lun--Indicates the LUN of the loader, and is usually 1.
ADD LOADER 2 9
Switches
The following switch is available with the ADD CDROM command:
TRANSFER_RATE_REQUESTED=
This switch is described in the following paragraph.
TRANSFER_RATE_REQUESTED=ASYNCHRO NOUS
TRANSFER_RATE_REQUESTED=20MHZ default)
TRANSFER_RATE_REQUESTED=10MHZ
TRANSFER_RATE_REQUESTED=5MH Z
Specifies the maximum data transfer rate at which the controller is to communicate
with the disk drive. The transfer rate might need to be limited to accommodate long
cables between the controllers and the device.
Exam ples
To add loader LOAD421 at port 2, target 0, LUN 1, enter:
ADD LOADER LOAD421 2 0 1
ADD PASSTHROUGH PASS1 LOAD421
ADD UNIT D100 PASS1
See also
ADD PASSTHROUGH
DELETE container-name
SHOW loader
210 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
ADD MIRRORSET
Names a mirrorset and adds it to the controller configuration. Mirrorsets are often referred
to as RAID 1 storagesets. The data capacity of a RAID 1 is determined by the storage size
of the smallest member (base member size).
Syntax
ADD MIRRORSET mirrorset-name disk-name1 [disk-nameN]
Parameters
The following parameters are required for the ADD MIRRORSET command:
s mirrorset-name
s disk-name
These parameters are described in the following paragraphs.
mirrorset-name
Assigns a name to the mirrorset container. This is the name used with the ADD UNIT
command to identify the mirrorset as a host-addressable unit.
The mirrorset name must start with a letter (A through Z) and may consist of a
maximum of nine characters including letters A through Z, numbers 0 through 9,
periods (.), dashes (-), or underscores (_).
It is common to name a mirrorset MIRRn, where n is a sequentially assigned, unique
identifier. Other naming conventions are acceptable, but this naming convention
presents both the type of container and its unique identifier in an intuitive manner.
disk-name1 [disk-nameN]
Identifies the disk drives making up the mirrorset. A mirrorset may contain one to six
disk drives.
ADD MIRRORSET 2 11
Switches
The following switches are available with the ADD DISK command:
s COPY
s POLICY
s READ_SOURCE
These switches are described in the following paragraphs.
COPY=FAST
COPY=NORMAL (default)
Sets the speed at which the controller copies data to a new member from normal
mirrorset members:
s Specify COPY=FAST to allow the creation of mirrored data to take precedence
over other controller operations. When you specify COPY=FAST, the controller
uses more resources to create the mirrored data and copying takes less time.
However, overall controller performance is reduced.
s Specify COPY=NORMAL when operations performed by the controller should
take priority over the copy operation. If you specify COPY=NORMAL creating the
mirrored data has a minimal impact on performance.
POLICY=BEST_FIT
POLICY=BEST_PERFORMANCE (default)
NOPOLICY
Sets the selection criteria the controller uses to choose a replacement disk from the
spareset when a mirrorset member fails.
s Specify POLICY=BEST_FIT to choose a replacement disk drive from the spareset
that equals or exceeds the base member size (smallest disk drive at the time the
mirrorset was initialized). If there is more than one disk drive in the spareset that
meets the criteria, the controller selects a disk drive with the best performance.
s Specify POLICY=BEST_PERFORMANCE to allow the software to choose a
replacement disk drive from the spareset with the best performance. The controller
attempts to select a disk on a different port than existing mirrorset members. If
more than one disk drive in the spareset matches the best performance criteria, the
controller selects a disk drive that equals or exceeds the base member size.
s Specify NOPOLICY to prevent the controller from automatically replacing a failed
disk device. The mirrorset operates in a reduced state until a POLICY=BEST_FIT
or POLICY=BEST_PERFORMANCE is selected or a member is manually placed
in the mirrorset (see "SET mirrorset-name" on page 287).
212 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
READ_SOURCE=disk-name
READ_SOURCE=LEAST_BUSY (default)
READ_SOURCE=ROUND_ROBIN
Selects the mirrorset member used by the controller to satisfy a read request:
s Specify the READ_SOURCE=disk-name of a specific member to which you want
the controller to direct all read requests. If the member fails out of the mirrorset, the
controller selects the first normal member it finds to satisfy its read requests.
s Specify READ_SOURCE=LEAST_BUSY to direct read requests to the mirrorset
disk with the least amount of work in its queue. If multiple disks have equally short
queues, the controller queries normal disks for each read request as it would when
READ_SOURCE=ROUND_ROBIN is specified.
s Specify READ_SOURCE=ROUND_ROBIN to sequentially direct read requests to
each local mirrorset disk. The controller equally queries all normal disks for each
read request.
Exam ples
To create a a mirrorset named MIRR1 consisting of disks DISK10000, DISK20100, and
DISK30200, enter:
ADD MIRRORSET MIRR1 DISK10000 DISK20100 DISK30200
To create a host-addressable unit after the mirrorset MIRR1 has been created, enter:
INITIALIZE MIRR1
ADD UNIT D104 MIRR1
See also
ADD DISK
ADD UNIT
DELETE container-name
INITIALIZE
MIRROR
REDUCE
SHOW mirrorset-name
SHOW MIRRORSETS
SHOW STORAGESETS
UNMIRROR
ADD OPTICAL 2 13
ADD OPTICAL
Names an optical disk drive and adds it to the controller configuration.
Syntax
ADD OPTICAL container-name scsi-port-target-lun
Parameters
The following parameters are required for the ADD OPTICAL command:
s container-name
s scsi-port-target-lun
These parameters are described in the following paragraphs.
container-name
Assigns a name to the optical device. This container name is then used with the ADD
UNIT command to create a logical unit.
The disk name must start with a letter (A through Z) and may consist of a maximum of
nine characters including letters A through Z, numbers 0 through 9, periods (.), dashes
(-), or underscores (_).
It is common to name an optical drive OPTpttll, where pttll is the device
Port-Target-LUN address. Although other naming conventions are acceptable, this
naming convention presents the type of disk drive and its SCSI location.
scsi-port-target-lun
Indicates the SCSI device PTL address. Place one space between the port number,
target number, and the LUN number when entering the PTL address.
port--Designates the SCSI device port number, from 1 to 6, on which the disk
resides.
target--Designates the SCSI target ID of the optical device on the port. There can
be up to 14 devices addressed. The device storage enclosures use target IDs of
00-05 and 08-15 (the controllers use 06 and 07).
lun--Indicates the LUN of the optical device, and is always zero.
214 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
NOTE: Refer to the Compaq StorageWorks HSJ80 Array Controller ACS Version 8.5J for
OpenVMS Release Notes to determine whether the disk drive you are planning to use is
compatible with the controller.
Switches
The following switch is available with the ADD OPTICAL command:
TRANSFER_RATE_REQUESTED
This switch is described in the following paragraph.
TRANSFER_RATE_REQUESTED=ASYNCHRO NOUS
TRANSFER_RATE_REQUESTED=20MHZ (default)
TRANSFER_RATE_REQUESTED=10MHZ
TRANSFER_RATE_REQUESTED=5MH Z
Specifies the maximum data transfer rate at which the controller is to communicate
with the disk drive. The transfer rate might need to be limited to accommodate long
cables between the controllers and the device.
Exam ples
To add OPT10000 at port 1, target 0, LUN 0, enter:
ADD OPTICAL OPT10000 1 0 0
To add an optical drive named OPT30200 as a disk to port 3, target 2, LUN 0 and set the
data transfer rate to 10 MHz, enter the following on one line:
ADD OPTICAL OPT30200 3 2 0 TRANSFER_RATE_REQUESTED=10MHZ
To create a host-addressable unit after the disk is added, enter:
ADD UNIT D199 OPT10000
See also
ADD UNIT
DELETE container-name
INITIALIZE
LOCATE
SHOW DISKS
SHOW DEVICES
SET container-nam
ADD PASSTHROUGH 2 15
ADD PASSTHROUGH
Names a passthrough container and adds the container to the controller configuration.
Passthrough containers allow the host to "pass" SCSI commands directly to the
passthrough container. Optical drive loaders and tape loaders are examples of passthrough
containers.
Syntax
ADD PASSTHROUGH passthrough-name container-name
Parameters
The following parameters are required for the ADD PASSTHROUGH command:
s passthrough-name
s container-name
These parameters are described in the following paragraphs.
passthrough-name
Assigns a name to the passthrough device. This container name is then used with the
ADD UNIT command to create a logical unit.
The passthrough container name must start with a letter (A through Z) and may consist
of a maximum of nine characters including letters A through Z, numbers 0 through 9,
periods (.), dashes (-), or underscores (_).
It is common to name a passthrough device PASSpttll, where pttll is the device
Port-Target-LUN address. Although other naming conventions are acceptable, this
naming convention presents the type of disk drive and its SCSI location.
container-name
Assigns a name to the passthrough container. This name is used with the ADD UNIT
command to identify the passthrough container as a host-addressable unit.
The passthrough container name must start with a letter (A through Z) and may consist
of a maximum of nine characters including letters A through Z, numbers 0 through 9,
periods (.), dashes (-), or underscores (_).
It is common to name a passthrough device container name as PASpttll, where pttll is
the device Port-Target-LUN address. Although other naming conventions are
acceptable, this one presents the user with the type of disk drive and its SCSI location.
216 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
Switches
There are no switches with this command.
Exam ples
To create a passthrough container named PASS1 from loader LOAD421, enter:
ADD LOADER LOAD421 4 2 1
ADD PASSTHROUGH PASS1 LOAD421
ADD UNIT D100 PASS1
See also
ADD CDROM
ADD LOADER
ADD OPTICAL
ADD UNIT
DELETE container-name
SHOW
ADD RAIDSET 2 17
ADD RAIDSET
Names a RAIDset and adds the RAIDset to the controller configuration. RAIDsets can
contain from 3 to 14 members.
Compaq RAIDsets are often referred to as RAID level 3/5 storagesets because they use the
best characteristics of RAID level 3 and RAID level 5. The number of members in the
storageset is determined by the number of containers (logical disk units) specified by the
container-name parameter in the command. The data capacity of the RAIDset is
determined by the storage size of the smallest member (base member size).
Syntax
ADD RAIDSET RAIDset-name container-name1 container-name2 container-name3
[container-nameN]
Parameters
The following parameters are available to the ADD RAIDSET command:
s RAIDset-name
s container-name
These parameters are described in the following paragraphs.
RAIDset-name
Assigns a name to the RAIDset. This is the name used with the ADD UNIT command
to identify the RAIDset as a host-addressable unit.
The RAIDset name must start with a letter (A through Z) and may consist of a
maximum of nine characters including letters A through Z, numbers 0 through 9,
periods (.), dashes (-), or underscores (_).
It is common to name a RAIDset RAIDn, where n is a sequentially assigned, unique
identifier. This naming convention presents the user with the type of container and its
unique identifier.
container-name1 container-name2 container-name3 [container-nameN]
Identifies the containers making up the RAIDset. RAIDsets must include at least 3
containers and no more than 14.
218 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
Switches
The following switches are available with the ADD RAIDSET command:
s POLICY
s COPY
s RECO NSTRUCT
s REDUCED
These switches are described in the following paragraphs.
POLICY=BEST_FIT
POLICY=BEST_PERFORMANCE (default)
NOPOLICY
Sets the selection criteria the controller uses to choose a replacement member from the
spareset when a RAIDset member fails:
s Specify POLICY=BEST_FIT to choose a replacement disk drive from the spareset
that equals or exceeds the base member size of the remaining members of the
RAIDset. If more than one disk drive in the spareset is the correct size, the
controller selects a disk drive giving the best performance.
s Specify POLICY=BEST_PERFORMANCE to choose a replacement disk drive
from the spareset resulting in the best performance of the RAIDset. The controller
attempts to select a disk on a different port than existing RAIDset members. If
there is more than one disk drive in the spareset matching the best performance
criteria, the controller selects a disk drive that equals or exceeds the base member
size of the RAIDset.
s Specify NOPOLICY to prevent the controller from automatically replacing a failed
disk device. This RAIDset operates in a reduced state until you select either
POLICY=BEST_PERFORMANCE or POLICY=BEST_FIT, or manually place a
member in the RAIDset. See "SET RAIDset-name," on page 293, for more
information regarding this procedure.
ADD RAIDSET 2 19
COPY=FAST
COPY=NORMAL (default)
Sets the speed at which the controller copies data to a new member from normal
RAIDset members when data is being mirrored to the storageset's disk drives:
s Specify COPY=FAST to allow the creation of RAIDset data to take precedence
over other controller operations. When you specify COPY=FAST, the controller
uses more resources to create the RAIDset data, and copying takes less time.
However, overall controller performance is reduced.
s Specify COPY=NORMAL when operations performed by the controller should
take priority over the copy operation. If you specify COPY=NORMAL, creating
the RAIDset data has a minimal impact on performance.
RECONSTRUCT=FAST
RECO NSTRUCT=NORMAL (default)
Sets the speed at which the controller reconstructs data to a new RAIDset disk that
replaces the failed disk:
s Specify FAST to allow the reconstruct process to take precedence over other
controller operations. When the RECONSTRUCT=FAST switch is specified, the
controller uses more resources to perform the reconstruction. Reconstruction takes
less time, but overall controller performance is reduced during reconstruction.
s Specify NORMAL to balance other controller operations with the reconstruct
operation. The controller uses relatively few resources to perform the reconstruct
process and there is little impact on performance.
REDUCED
NOREDUCED (default)
Permits the addition of a RAIDset that is missing a member (due to a failure):
s Specify the REDUCED switch when you add a reduced RAIDset (a RAIDset that
is missing one member).
NOTE: Verify that the RAIDset contains all but one of its disks before specifying the REDUCED
switch.
s Specify the NOREDUCED switch when all the disks making up the RAIDset are
present--for instance, when creating a new RAIDset.
220 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
Exam ples
To create a RAIDset named RAID9 that contains disks DISK10000, DISK20100, and
DISK30200, enter:
ADD RAIDSET RAID9 DISK10000 DISK20100 DISK30200
To create a RAIDset named RAID8 that contains disks DISK10000, DISK20100, and
DISK30200, and uses the BEST_FIT switch to indicate the replacement policy, enter:
ADD RAIDSET RAID8 DISK10000 DISK20100 DISK30200 POLICY=BEST_FIT
NOTE: Enter the ADD RAIDSET command on one line.
To create a RAIDset named RAID8 that contains disks DISK10000, DISK20100, and
DISK30200, then initialize it and make it into a host-addressable unit, enter:
ADD RAIDSET RAID8 DISK10000 DISK20100 DISK30200
INITIALIZE RAID8
ADD UNIT D70 RAID8
To create a three-member RAIDset from the members of a reduced four-member
RAIDset, enter the following (do not initialize the RAIDset again):
CAUTION: Data contained on the RAIDset will be erased if you reinitialize the RAIDset.
ADD RAIDSET RAID6 DISK10300 DISK20400 DISK30200 REDUCED
See also
ADD UNIT
DELETE container-name
SET RAIDSET
SHOW RAIDSET
SHOW RAIDset-name
SHOW STORAGESETS
INITITA LIZE
ADD SPARESET 2 21
ADD SPARESET
Adds a disk drive to the spareset and initializes the metadata on the drive.The spareset is a
pool of drives available to the controller to replace failing storageset members.
Syntax
ADD SPARESET disk-name
Parameters
disk-name
Indicates the name of the disk drive being added to the spareset. Only one disk drive
can be added to the spareset with each ADD SPARESET command.
Switches
There are no switches associated with this command.
Exam ple
To add disk drives named DISK20200 and DISK30300 to a spareset, enter:
ADD SPARESET DISK20200
ADD SPARESET DISK30300
See also
DELETE SPARESET
SHOW SPARESET
SHOW STORAGESETS
222 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
ADD STRIPESET
Names a stripeset and adds it to the controller configuration. A stripeset can contain from
2 to 24 members. Stripesets are also referred to as RAID level 0 storagesets. The number
of members in the stripeset is determined by the number of container-name parameters
specified.
Syntax
ADD STRIPESET stripeset-name container-name1 container-name2 [container-nameN]
Parameters
The following parameters are required for the ADD STRIPESET command:
s stripeset-name
s container-name
These parameters are described in the following paragraphs.
stripeset-name
Assigns a name to the stripeset. This is the name used with the ADD UNIT command
to identify the stripeset as a host-addressable unit.
The stripeset name must start with a letter (A through Z) and may consist of a
maximum of nine characters including letters A through Z, numbers 0 through 9,
periods (.), dashes (-), or underscores (_).
It is common to name a stripeset STRIPEn, where n is a sequentially assigned, unique
identifier. This naming convention presents to the user both the type of container and
its unique identifier.
container-name1 container-name2 [container-nameN]
Identifies the members (disk drives or mirrorsets) making up the stripeset. Stripesets
can contain between 2 and 24 members.
The container name each must start with a letter (A through Z) and may consist of a
maximum of nine characters including letters A through Z, numbers 0 through 9,
periods (.), dashes (-), or underscores (_).
It is common to name a stripeset container CONTn, where n is a sequentially assigned,
unique identifier. This naming convention presents to the user both the type of
container and its unique identifier.
ADD STRIPESET 2 23
Switches
There are no switches associated with this command.
Exam ples
To create a stripeset named STRIPE1 that contains disks DISK10000, DISK20100, and
DISK30200, enter:
ADD STRIPESET STRIPE1 DISK10000 DISK20100 DISK30200
To create a stripeset named STRIPE1 and then create a logical unit from it, enter:
INITIALIZE STRIPE1
ADD UNIT D103 STRIPE1
To create a two-member striped mirrorset (a stripeset whose members are mirrorsets), and
a logical unit from it, enter the following:
NOTE: Because you can initialize the stripeset, you do not need to individually
initialize the mirrorset members.
ADD MIRRORSET MR1 DISK10000 DISK20100
ADD MIRRORSET MR2 DISK30200 DISK40300
ADD STRIPESET STRIPE1 MR1 MR2
INITIALIZE STRIPE1
ADD UNIT D104 STRIPE1
See also
ADD UNIT
ADD MIRRORSET
DELETE container-name
INITIALIZE
SHOW STORAGESET
SHOW STRIPESET
SHOW stripeset-name
224 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
ADD TAPE
Names a tape drive and adds it to the controller configuration.
Syntax
ADD TAPE tape-name port-target-LUN
Parameters
The following parameters are required for the ADD TAPE command:
s tape-name
s port-target-L UN
These parameters are described in the following paragraphs.
tape-name
Assigns a name to the tape drive. This is the name used with the ADD UNIT command
to identify the tape drive as a host-addressable unit.
The tape name must start with a letter (A through Z) and may consist of a maximum of
nine characters including letters A through Z, numbers 0 through 9, periods (.), dashes
(-), or underscores (_).
It is common to name a tape container TAPEn, where n is a sequentially assigned,
unique identifier. This naming convention presents both the type of container and its
unique identifier.
scsi port-target-LUN
Indicates the SCSI device PTL address. Place one space between the port number,
target number, and the LUN number when entering the PTL address.
port--Designates the SCSI device port number, from 1 to 6, on which the disk
resides.
target--Designates the SCSI target ID of the tape on the port. There can be up to
14 devices addressed. The device storage enclosures use target IDs of 00-05 and
08-15 (the controllers use 06 and 07).
lun--Indicates the LUN of the tape drive, and is always zero.
ADD TAPE 2 25
NOTE: Refer to the Compaq StorageWorks HSJ80 Array Controller ACS Version 8.5J for
OpenVMS Release Notes to determine whether the disk drive you are planning to use is
compatible with the controller.
Switches
The following switch is available with the ADD TAPE command:
TRANSFER_RATE_REQUESTED
This switch is described in the following paragraph.
TRANSFER_RATE_REQUESTED=ASYNCHRO NOUS
TRANSFER_RATE_REQUESTED=20MHZ (default)
TRANSFER_RATE_REQUESTED=10MHZ
TRANSFER_RATE_REQUESTED=5MH Z
Specifies the maximum data transfer rate at which the controller is to communicate
with the disk drive. The transfer rate might need to be limited to accommodate long
cables between the controllers and the device.
Exam ples
To create a tape drive named TAPE1 to port 1, target 0, LUN 0, enter:
ADD TAPE TAPE100 1 0 0
ADD UNIT T102 TAPE100
See also
ADD UNIT
DELETE container-name
SET UNIT
SHOW TAPES
226 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
ADD UNIT
Creates a logical unit from a specified container. The controller maps all requests from the
host to the logical-unit number as requests to the container specified in the ADD UNIT
command. Units can be created from all container types:
s Devices such as CD-ROMs, disks, optical storage, tapes, and passthrough
s Stripesets
s Mirrorsets
s RAID sets
s Partitions
If you add a newly created container to your subsystem, you must initialize it before it can
be added as a logical unit. If you are adding a container that has data on it that you want to
maintain, do not initialize it; it will be added as a logical unit.
CAUTION: Adding a unit immediately makes that unit available to all host connections
unless the port access switch is specified. There is more information about this under
the description of the THIS/OTHER_PORT_1/2_ACCESS= switch.
Syntax
ADD UNIT unit-number container-name
Parameters
The following parameters are required for the ADD UNIT command:
s unit-number
s container-name
ADD UNIT 2 27
These parameters are described in the following paragraphs.
unit-number
Assigns a number to the unit being created from a device, storageset, or partition in the
subsystem. The unit number consists of a device-type letter followed by the logical
unit number (0-4094). The device type letter is either:
s "D" for all container types (including passthrough), except for tape devices
s "T" for non-passthrough tape devices
For example, the unit number of a non-tape logical unit 544 is D544.
container-name
Specifies the name of the container (disk drive, device, storageset, or partition) being
used to create the unit.
Switches
Table 21 lists all switches for the ADD UNIT command and identifies which switches
may be used with each type of device or storageset. Descriptions of each switch follow the
table.
Table 21 ADD UNIT Switches for New Containers
N0transportable Disk
Transportable Disk
Container Type
Passthrough
Mirrorset
Stripeset
CD-ROM
RAIDset
Optical
Tape
Switch
MAX_READ_CACHED_TRANSFER_SIZE
MAX_WRITE_CACHED_TRANSFER_SIZE
MAXIMUM_CACHED_TRANSFER_SIZE
PARTITION=partition-number
PREFERRED_PATH
NO PREFERRED_PATH
READ_CACHE
NO READ_CACHE
228 HSJ80 Array Controller ACS Version 8.5J-2 CLI Reference Guide
Table 21 ADD UNIT Switches for New Containers (Continued)
N0transportable Disk
Transportable Disk
Container Type
Passthrough
Mirrorset
Stripeset
CD-ROM
RAIDset
Optical
Tape
Switch
READAHEAD _CACHE
NO READAHEAD_CACHE
RUN
NO RUN
THIS_PORT_1_ACCESS={NONE|READ|FULL}
OTHER_PORT_1_ACCESS={NONE|READ|FULL}
THIS_PORT_2_ACCESS={NONE|READ|FULL}
OTHER_PORT_2_ACCESS={NONE|READ|FULL}
WRITE_PROTECT
NO WRITE_PROTECT
WRITEBACK_CACHE
NO WRITEBACK_CACHE
NOTE: The NORUN switch cannot be specified for partitioned units.
MAX_READ_CACHED_TRANSFER_SIZE=32 (default)
MAX_READ_CACHED_TRANSFER_SIZE=n
Sets the largest number of read blocks to be cached by the controller. The controller
will not cache any transfers over the size set. Acceptable values are 0 through 2048.
The MAXIMUM_CACHED_TRANSFER switch affects both read and write-back
cache when set on a controller that has read and write-back caching.
MAX_WRITE_CACHED_TRANSFE_SIZE=32 (default)
MAX_WRITE_CACHED_TRANSFER_SIZE=n
Sets the largest number of write blocks to be cached by the controller. The controller
will not cache any transfers over the size set. Acceptable write block sizes are 0
| 143177-001
143875-001
143876-001
163132-001
163133-001
163134-001
163135-001
DS-BA356-MW
ed-write-ba
EK-356MW-IA
EK-356MW-QA
EK-356MW-UA
EK-HSJAA-RA
EK-HSJAC-PA
EK-HSJCP-PA
EK-HSJMS-SA
EK-HSJSO-OA
|
