HSG60 Array Controller
ACS Version 8.6
CLI Reference Guide
First Edition (June 2001)
Part Number: EKG60CLRA. A01
Compaq Computer Corporation
2001 Compaq Computer Corporation.
Compaq, the Compaq logo, and StorageWorks Registered in U. S. Patent and Trademark Office.
Tru64 and OpenVMS are trademarks of Compaq Information Technologies Group, L.P. in the United
States and other countries.
UNIX is a trademark of The Open Group in the United States and other countries.
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 provided "as is" without warranty of any kind and is subject to change
without notice. The warranties for Compaq products are set forth in the express limited warranty
statements accompanying such products. Nothing herein should be construed as constituting an additional
warranty.
Com paq service tool software, including associated documentation, is the property of and contains
confidential technology of Compaq Computer Corporation. Service customer is hereby licensed to use
the software only for activities directly relating to the delivery of, and only during the term of, the
applicable services delivered by Compaq or its authorized service provider. Customer may not modify or
reverse engineer, remove, or transfer the software or make the software or any resultant diagnosis or
system management data available to other parties without Compaq's or its service provider's consent.
Upon termination of the services, customer will, at Compaq's or its service provider's option, destroy or
return the software and associated documentation in its possession.
Printed in the U.S.A.
HSG60 Array Controller ACS Version 8.6
CLI Reference Guide
First Edition (June 2001)
Part Number: EKG60CLRA. A01
Contents
About This Guide
Text Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Symbols in Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Symbols on Equipment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Rack Stability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Compaq Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Compaq Website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Compaq Authorized Reseller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Chapter 1
CLI Command Introduction
CLI Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Using the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Command Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Controller Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Device Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Selective Storage Presentation Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Storageset Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Partition Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Logical Unit Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Diagnostic and Utility Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Entering CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Changing the CLI Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
iv HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
Chapter 2
CLI Command Descriptions
CLI Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Glossary
Index
v
Figures
Figure 21. Location of node ID sticker on a BA370 enclosure. . . . . . . . . . . . . . . . . . . . . . . . . . 295
vi HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
Tables
Table 11 Recall and Edit Command Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Table 21 ADD UNITS Switches for New Containers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Table 22 SET controller Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Table 23 SET unit-number Switches for Existing Containers . . . . . . . . . . . . . . . . . . . . . . . . . 2115
About This Guide
This guide is designed to be used as step-by-step instructions for installation and as a
reference for operation, troubleshooting, and future upgrades.
Text Conventions
This document uses the following conventions to distinguish elements of text:
Keys Keys appear in boldface. A plus sign (+) between two
keys indicates that they should be pressed
simultaneously.
USER INPUT User input appears in a different typeface and in
uppercase
FILENAMES File names appear in uppercase italics.
Menu Options, These elements appear in initial capital letters.
Command Names,
Dialog Box Names
C OMMANDS, These elements appear in upper case.
DIRECTORY NAMES,
NOTE: UNIX commands are case sensitive and will not
and DRIVE NAMES appear in uppercase.
Type When you are instructed to type information, type the
information without pressing the Enter key.
Enter When you are instructed to enter information, type the
information and then press the Enter key.
viii HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
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.
CAUTION: Text set off in this manner indicates that failure to follow directions could
result in damage to equipment or loss of information.
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
These icons may be located on equipment in areas where hazardous conditions may exist.
Any 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.
About This Guide ix
Any surface or area of the equipment marked with these symbols indicates
the presence of a hot surface or hot component. If this surface is contacted,
the potential for injury exists.
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
equipment is supplied by multiple sources of power.
WARNING: To reduce the risk of injury from electrical shock,
remove all power cords to completely disconnect power from the
system.
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 manual material handling.
Rack Stability
WARNING: To reduce the risk of personal injury or damage to the equipment, be sure
that:
s The leveling jacks are extended to the floor.
s The full weight of the rack rests on the leveling jacks.
s The stabilizing feet are attached to the rack if it is a single rack installations.
s The racks are coupled together in multiple rack installations.
s A rack may become unstable if more than one component is extended for any
reason. Extend only one component at a time.
x HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
Getting Help
If you have a problem and have exhausted the information in this guide, you can get
further information and other help in the following locations.
Compaq Technical Support
You are entitled to free hardware technical telephone support for your product for as long
you own the product. A technical support specialist will help you diagnose the problem or
guide you to the next step in the warranty process.
In North America, call the Compaq Technical Phone Support Center at
1-800-OK-COMPAQ. This service is available 24 hours a day, 7 days a week.
NOTE: For continuous quality improvement, calls may be recorded or monitored.
Outside North America, call the nearest Compaq Technical Support Phone Center.
Telephone numbers for world wide Technical Support Centers are listed on the Compaq
website. Access the Compaq website by logging on to the Internet at
http://www.compaq.com.
Be sure to have the following information available before you call Compaq:
s Technical support registration number (if applicable)
s Product serial numbers
s Product model names and numbers
s Applicable error messages
s Add-on boards or hardware
s Third-party hardware or software
s Operating system type and revision level
s Detailed, specific questions
Compaq Website
The Compaq website has latest information on this product as well as the latest drivers.
You can access the Compaq website by logging on to the Internet at
http://www.compaq.com/storage.
About This Guide xi
Compaq Authorized Reseller
For the name of your nearest Compaq Authorized Reseller:
s In the United States, call 1-800-345-1518.
s In Canada, call 1-800-263-5868.
s Elsew here, see the Compaq website for locations and telephone numbers.
1
Chapter
CLI Command Introduction
Command line interpreter (CLI) commands are used to interact with the 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 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
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.
12 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
CLI commands for configuring and viewing the controllers use the relative terms "this
controller" and "other controller." See Text Conventions on page vii for an explanation of
these terms.
Using the CLI
Access the CLI through the following methods:
s Connecting a PC or local terminal to the maintenance port on the front of the
controller.
s 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.
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 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:
s CLEA R_ERRO RS
CLI
INVALID_CACHE
s CONFIGURATION
RESET
RESTORE
SAVE
CLI Command Introduction 13
s EXIT
s HELP
s POWEROF F
s RESTART
s SELFTEST
s SET
s SHOW
s RUN
s SHUTDOW N
The CLI commands controlling the Transparent Failover of a controller pair are:
s SET FAILOVER
s SET MULTIBUS_FAILOVER
s SET NOFAILOVER
s 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:
s ADD DISK
s ADD PASSTHROUGH
s CLEA R ERRORS
LOST_DATA
UNKNOWN
UNWRITEABLE_DATA
s DELETE
s INITIALIZE
s LOCATE
14 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
s RENAME
s SET
The CLI commands that change sparesets and failedsets include:
s ADD SPARESET
s DELETE FAILEDSET
s DELETE SPARESET
s SET FAILEDSET
s 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:
s ADD UNITS (the ENABLE_ACCESS_PATH switch)
s ADD UNITS (the DISABLE_ACCESS_PATH switch)
s SET unit-number (the ENABLE_ACCESS_PATH switch)
s SET unit-number (the DISABLE_ACCESS_PATH switch)
s ADD CONNECTIONS (the UNIT_OFFSET switch)
s 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:
s ADD MIRRORSET
s ADD RAIDSET
CLI Command Introduction 15
s ADD STRIPESET
s DELETE
s INITIALIZE
s LOCATE
s MIRROR
s REDUCE
s RENAME
s SET
s SHOW
s UNMIRROR
Partition Commands
Partition commands create multiple logical disk units from the same container.
The CLI Commands that pertain to partitions include:
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 include:
s ADD CONCATSETS
s ADD SNAPSHOT_UNITS
s DELETE
s LOCATE
s RENAME
s RETRY_ERRORS UNWRITEABLE_DATA
s SET
s SHOW
16 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
Diagnostic and Utility Commands
Diagnostic and utility commands perform general controller support functions.
The commands that pertain to the diagnostics and utilities include:
s DIRECTORY
s RUN
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:
s Commands are not case-sensitive.
s For most commands, only 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, 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 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 key or Ctrl+B keys, Steps forwards or backward through the four most recent CLI
Down Arrow key or Ctrl+N keys commands.
Left Arrow key or Ctrl+D keys, Moves the cursor left or right in a command line.
Right Arrow key or Ctrl+F keys
Ctrl+E keys Moves the cursor to the end of the line.
Ctrl+H keys or Backspace key Moves the cursor to the beginning of the line.
Ctrl+J keys or Linefeed key Deletes the word to the left of the cursor.
Ctrl+U keys Deletes all characters on the same line as the cursor.
Ctrl+A keys or F14 key 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 keys Recalls the contents of the command line. This function is
especially helpful if the system issues a message that interrupts
your typing.
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 guide 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 guide in
capitalized form.
s param eter--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.
18 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
s 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>."
2
Chapter
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 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
versions 8.6F, 8.6G, 8.6L, 8.6P, and 8.6S 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 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
ADD CONCATSETS
Creates a specialized volume, called a storageset expansion or 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.
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:
s concatset-name
s storageset-name
These parameters are described in the following paragraphs:
concatset-name
Assigns a name to the concatenation set, or concatset.
The concatset-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 (_).
storageset-nam e
Designates the first storageset to be a member of the concatset.
Switches
There are no switches associated with this command.
CLI Command Descriptions 2 3
Exam ples
To expand the capacity of unit D0, which consists of stripeset Stripe1, by adding another
stripeset, Stripe2, enter:
ADD CONCATSETS C1 STRIPE1
SET C1 ADD=STRIPE2
See Also
DELETE concatset-name
SET concatset-name
SHOW CONCATSETS
SHOW concatset-name
24 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
ADD CONNECTIONS
Each path between a Fibre Channel adapter in a host computer and an active host port on a
controller is a connection.
This command adds the specified host connection to the table of known connections. This
table is maintained in the controller's memory. The maximum table length is 96
connections; if the table contains 96 entries, new connections cannot be added unless
some old ones are deleted.
There are two mechanisms for adding a new connection to the table:
1. Physically connecting a host adapter to a controller host port. During Fibre Channel
initialization, the controller becomes aware of the connection and adds it to the table.
This physical discovery of connections occurs at the point when a host adapter is
plugged in to a controller port and after issuing a RESTART command. New
connections discovered through physical connection are assigned a default connection
name by the controller. The default connection name is of the form !NEWCONnn.
NOTE: Certain host conditions, such as a power cycle, that disturb the state of the switched
fabric may cause a connection to reappear in the table. The connection will be assigned a
default connection name.
2. Adding a connection through the ADD CONNECTIONS command.
NOTE: ADD CONNECTIONS will add an entry to the table whether the connection physically
exists or not. The table can be completely filled up with fictitious connections.
Syntax
ADD CONNECTIONS connection-name HOST_ID=host-id ADAPTER_ID=adapter-id
CONTROLLER=controller PORT=port
Parameters
The following parameters are required to the ADD CONNECTIONS command:
s connection-name
s HOST_ID
s ADAPTER_ID
s CONT ROL LER
s PORT
CLI Command Descriptions 2 5
These parameters are described in the following paragraphs:
connection-name
The name that will be assigned to the host connection. The connection name can be
any character string, with one exception: the name cannot be in the form of a default
connection name. The form of a default connection name is !NEWCONnn.
The default connection name is assigned automatically by the controller when the
connection is physically made between a host adapter and a controller port. Default
connection names are assigned only by the controller.
HOST_ID=host-id
HOST_ID is the parameter name for the host-id variable, which is the worldwide name
(WWN) of the host. WWN is a 16-character hexadecimal number. The hyphens are not
necessary, but are recommended to avoid mistakes in entering the number. The
HOST_ID parameter name must be entered, followed by an equal sign, followed by
the WWN of the host.
For example, to specify a WWN of AAAA-BBBB-CCCC-DDDD, type:
HOST_ID=AAAA-BBBB-CCCC-DDDD
ADAPTER_ID =adapter-id
ADAPTER_ID is the parameter name for the adapter-id variable, which is the
worldwide name (WWN) of the host Fibre Channel adapter. WWN is a 16-character
hexadecimal number. The hyphens are not necessary, but are recommended to avoid
mistakes in entering the number. The ADAPTER_ID parameter name must be entered,
followed by an equal sign, followed by the WWN of the host bus adapter.
For example, to specify a WWN of FFFF-GGGG-BBBB-9876, type:
ADAPTER_ID=FFFF-GGGG-BBBB-9876
NOTE: The worldwide name of the host and adapter are sometimes the same. This is a
characteristic of the adapter.
CONTROLLER=controller
CONTROLLER is the parameter name for the controller variable, which specifies
which controller the host is to connect through. The choices are
THIS_CONTROLLER, which can be shortened to THIS, and
OTHER_CONTROLLER, which can be shortened to OTHER.
PORT= port
PORT is the parameter name for the port variable that specifies which host port
(1 or 2) the connection is on.
26 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
Switches
The following switches are available with the ADD CONNECTION command:
s OPERATING_SYSTEM
s RESERVAT IO N_STYLE
s UNIT _O FFSET
These switches are described in the following paragraphs.
OPERATING_SYSTEM= OS_name
Specifies the operating system of the host. The OPERATING_SYSTEM switch tailors
the controllers behavior for use with a particular operating system. Enter a question
mark after OPERATING_SYSTEM to see the supported operating systems, as follows:
ADD CONNECTIONS SERVER1 OPERATING_SYSTEM=?
The response for this command is a list of abbreviations for the supported operating
systems.
RESERVATION_STYLE=CONNECTIO N_BASED (default)
RESERVATION_STYLE=HBA_PORT_ID_BASED
Selection of a RESERVATION_STYLE should be based upon the capabilities of the
host operating system. See the OS kit for more details. SCSI persistent reservations are
processed differently by the HSG80 based upon the RESERVATION_STYLE. Normal
SCSI reservations ( not persistent) are always treated as CONNECTION_BASED.
When set to HBA_PORT_ID_BASED, a single persistent reservation command is
propagated to all HSG80 controller ports, thereby enabling the host to access the unit
over any available path.
When set to CONNNECTION_BASED, the persistent reservation is only valid for the
port on which it is received, thereby limiting the host access to those paths that have
been explicitly reserved.
IMPORTANT: If a particular host prefers either the CONNECTION_BASED or
HBA_PORT_ID_BASED reservation style, all the connections to that particular host must have
identical reservation style settings.
The most important advantage of this mechanism is allowing various hosts, with different
reservation style requirements, to be connected to the same HSG80 controllers in a SAN
environment.
CLI Command Descriptions 2 7
UNIT_O FFSET=n
UNIT_O FFSET is a decimal value (n) that establishes the beginning of the range of
units that a host connection can access. This offset defines and restricts host
connection access to a contiguous group of unit numbers.
In transparent failover mode, host connections on port 1 default to an offset of 0; port 1
connections can see units 0 through 99. Host connections on port 2 default to an offset
of 100; port 2 connections can see units 100 through 199.
In multiple-bus failover mode, the default offset is 0 for all host connections.
NOTE: If a controller pair is switched from transparent failover mode to multiple-bus failover
mode, the unit offsets for transparent mode remain in effect.
The LUN number equals the unit number minus the offset:
LUN number = unit number offset
Logical unit number or LUN number = the logical unit number presented to the
host connection.
Unit number = the number assigned to the unit in the ADD UNITS command. This
is the number by which the unit is known internally to the controllers.
For example, a system has three host connections, each of which can see 8 LUNs.
Each connection designates its LUNs as 0 through 7. To define for each of these
connections a block of 8 units, set the offset for each connection, as follows:
CLI>SET SERVER1 UNIT_OFFSET=0
CLI>SET SERVER2 UNIT_OFFSET=10
CLI>SET SERVER3 UNIT_OFFSET=120
(It is not necessary to use offsets that are divisible by 10, but it makes things simpler.)
The effect of these offset assignments will be as follows:
Server1 will access units D 0 through D7, which it will see as LUNs 0 through 7.
Server2 will access units D10 through D17, which it will see as LUNs 0 through 7.
Server3 will access units D 120 through D127, which it will see as LUNs 0
through 7.
There is one additional factor to consider when assigning unit numbers and offsets. If
the SCSI_VERSION qualifier of the SET THIS/OTHER CONTROLLER command is
set to SCSI-3, the command console LUN (CCL) is presented as LUN 0 to every
connection, superseding any unit assignments. For more information see the ADD
UNITS command.
28 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
Exam ples
This example shows how to add an entry for a connection named George to the table of
known connections, with the indicated host and adapter worldwide names, on port 2 of
"this controller," and with reservations checked using the port_id of the host bus adapter.
ADD CONNECTIONS GEORGE HOST_ID=1000-0000-C920-1234
ADAPTER_ID=1000-0000-C920-5678 CONTROLLER=THIS PORT=2
RESERVATION_STYLE=HBA_PORT_ID_BASED
See Also
ADD UNITS
DELETE connections
SET connection-name
CLI Command Descriptions 2 9
ADD DISKS
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.
NOTE: The controller supports a maximum of 84 storage devices, even though more than 84
target IDs are available. Do not exceed the maximum number of devices in the subsystem.
Syntax
ADD DISKS disk-name scsi-port-target-lun
Parameters
The following parameters are required for the ADD DISKS command:
s disk-name
s scsi-port-target-lun
These parameters are described in the following paragraphs:
disk-name
Assigns a name to the disk device. This disk-name is then used with the ADD UNITS
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 (_).
A disk drive is commonly named DISKpttll, where pttll is the disk Port-Target-LUN
address. Although other naming conventions are acceptable, this naming convention
presents the type of disk drive and the disk drive 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.
210 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
target--Designates the SCSI target ID of the disk on the port. Valid device target
IDs for single controller configurations are 0015, excluding ID 7. Valid device
target IDs for dual controller configurations are 0015, excluding IDs 6 and 7.
lun--Indicates the LUN of the disk drive and is always zero.
The parameters port, target, and lun must be entered with at least one space between them.
Leading zeroes can be excluded.
Switches
The following switches are available with the ADD DISKS command:
s TRANSFER_RATE_REQUESTED
s TRANSPORTABLE and NOTRANSPORTABLE
These switches are described in the following paragraphs.
TRANSFER_RATE_REQUESTED=ASYNCHRO NOUS
TRANSFER_RATE_REQUESTED=DEFAULT
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.
TRANSPORTABLE
NOTRANSPORTABLE (default)
Indicates whether a disk drive can be accessed exclusively by StorageWorks
controllers or can 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.
CLI Command Descriptions 2 11
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 DISKS DISK10000 1 0 0
To add DISK40200 as a transportable disk drive to port 4, target 2, LUN 0, enter:
ADD DISKS 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 DISKS DISK30200 3 2 0 NOTRANSPORTABLE TRANSFER_RATE_REQUESTED=10MHZ
To create a host-addressable unit after the disk is added, enter:
INITIALIZE DISK40200
ADD UNITS D199 DISK40200
See Also
ADD PASSTHROUGH
ADD UNITS
DELETE container-name
INITIALIZE
LOCATE
SHOW DISKS
SHOW DEVICES
SHOW PASSTHROUGH
SET container-name
212 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
ADD MIRRORSETS
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 MIRRORSETS mirrorset-name disk-name1 [disk-nameN]
Parameters
The following parameters are required for the ADD MIRRORSETS command:
s mirrorset-name
s disk-name1
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 UNITS
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 (_).
A mirrorset is commonly named 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 a unique identifier for the container 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.
Switches
The following switches are available with the ADD DISKS command:
s COPY
s POLICY and NOPOLICY
CLI Command Descriptions 2 13
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:
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.
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.
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.
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.
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 page 2104).
READ_SOURCE=LEAST_BUSY (default)
READ_SOURCE=ROUND_RO BIN
Selects the mirrorset member used by the controller to satisfy a read request.
214 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
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.
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 mirrorset named MIRR1 consisting of disks DISK10000, DISK20100, and
DISK30200, enter:
ADD MIRRORSETS MIRR1 DISK10000 DISK20100 DISK30200
To create a host-addressable unit after the mirrorset MIRR1 has been created, enter:
INITIALIZE MIRR1
ADD UNITS D104 MIRR1
See Also
ADD DISKS
ADD UNITS
DELETE container-name
INITIALIZE
MIRROR
REDUCE
SHOW mirrorset-name
SHOW MIRRORSETS
SHOW STORAGESETS
UNMIRROR
CLI Command Descriptions 2 15
ADD PASSTHROUGH
Names a passthrough devices and adds it to the controller configuration. This command is
typically used when passthrough devices are added to a previously configured subsystem.
During initial setup, the entire device set is customarily added to the controller's
configuration through the CONFIG utility.
NOTE: The controller supports a maximum of 84 storage devices, even though more than 84
target IDs are available. Do not exceed the maximum number of devices in the subsystem.
Syntax
ADD PASSTHROUGH passthrough-name scsi-port-target-lun
Parameters
The following parameters are required for the ADD PASSTHROUGH command:
s passthrough-name
s scsi-port-target-lun
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 UNITS command to create a unit.
The passthrough device 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 (_).
A passthrough device is commonly named PASSpttll, where pttll is the disk
Port-Target-LUN address. Although other naming conventions are acceptable, this
naming convention presents the type of passthrough device and the passthrough device
SCSI location.
Switches
The following switch is available with the ADD DISKS command:
These switches are described in the following paragraphs.
216 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
Exam ples
To add PASS10200 at port 1, target 2, LUN 0, enter:
ADD PASSTHROUGH PASS10200 1 2 0
ADD UNIT P4 PASS10200
See Also
ADD UNITS
DELETE container-name
LOCATE
SHOW DISKS
SHOW DEVICES
SHOW PASSTHROUGH
SET container-name
CLI Command Descriptions 2 17
ADD RAIDSETS
Names a RAIDset and adds the RAIDset to the controller configuration. RAIDsets can
contain from 3 to 14 members.
NOTE: The maximum size of a RAIDset is up to 1.024TB
Compaq RAIDsets are RAID level 3/5 storagesets that use the best characteristics of
RAID level 3 and RAID level 5. A RAIDset should only contain disk drives of the same
capacity. The controller limits the effective capacity of each member to the capacity of the
smallest member in the storageset (base member size) when the storageset is initialized.
Thus, if you combine 9 GB disk drives with 4 GB disk drives in the same storageset, you
will waste 5 GB of capacity on each 9 GB member. A RAIDset must include at least 3 disk
drives, but no more than 14.
Syntax
ADD RAIDSETS RAIDset-name disk-name1 disk-name2 disk-name3 [disk-nameN]
Parameters
The following parameters are available to the ADD RAIDSETS command:
s RAIDset-name
s disk-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 UNITS
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.
disk-name1 disk-name2 disk-name3 [disk-nameN]
Identifies the disk making up the RAIDset. RAIDsets must include at least 3
containers and no more than 14.
218 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
Switches
The following switches are available with the ADD RAIDSETS command:
s POLICY and NOPOLICY
s RECO NSTRUCT
s REDUCED and NOREDUCED
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:
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.
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.
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 page 2112, for more information regarding this
procedure.
CLI Command Descriptions 2 19
RECO NSTRUCT=FAST
RECO NSTRUCT=NORMAL (default)
Sets the speed at which the controller reconstructs data to a new RAIDset disk that
replaces the failed disk:
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.
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):
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.
Specify the NOREDUCED switch when all the disks making up the RAIDset are
present--for instance, when creating a new RAIDset.
Exam ples
To create a RAIDset named RAID9 that contains disks DISK10000, DISK20100, and
DISK30200, enter:
ADD RAIDSETS 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 RAIDSETS RAID8 DISK10000 DISK20100 DISK30200 POLICY=BEST_FIT
NOTE: Enter the ADD RAIDSETS 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 RAIDSETS RAID8 DISK10000 DISK20100 DISK30200
INITIALIZE RAID8
ADD UNITS D70 RAID8
220 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
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 RAIDSETS RAID6 DISK10300 DISK20400 DISK30200 REDUCED
See Also
ADD UNITS
DELETE container-name
INITIALIZE
SET RAIDSETS
SHOW RAIDSETS
SHOW RAIDset-name
SHOW STORAGESETS
CLI Command Descriptions 2 21
ADD SPARESETS
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 SPARESETS 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 SPARESETS 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 SPARESETS DISK20200
ADD SPARESETS DISK30300
See Also
DELETE SPARESETS
SHOW SPARESETS
SHOW STORAGESETS
222 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
ADD STRIPESETS
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.
NOTE: The maximum size of a stripeset is up to 1.024 TB
.Syntax
ADD STRIPESETS stripeset-name container-name1 container-name2
[container-nameN]
Parameters
The following parameters are required for the ADD STRIPESETS 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 UNITS 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 (_).
CLI Command Descriptions 2 23
It is common to name a stripeset container 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.
NOTE: A 256-character limit exists for the command line. If configuring a stripeset with many
members, consider renaming the members to shorter names in order to enter the entire
command line.
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 STRIPESETS STRIPE1 DISK10000 DISK20100 DISK30200
To create a stripeset named STRIPE1 and then create a logical unit from it, enter:
INITIALIZE STRIPE1
ADD UNITS 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 MIRRORSETS MR1 DISK10000 DISK20100
ADD MIRRORSETS MR2 DISK30200 DISK40300
ADD STRIPESETS STRIPE1 MR1 MR2
INITIALIZE STRIPE1
ADD UNITS D104 STRIPE1
See Also
ADD UNITS
ADD MIRRORSETS
DELETE container-name
INITIALIZE
SHOW STORAGESET
SHOW STRIPESETS
SHOW stripeset-name
224 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
ADD UNITS
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 UNITS
command. Units can be created from all container types:
s Disk and passthrough devices
s Stripesets
s Mirrorsets
s RAID sets
s Partitions
s Striped mirrorsets
If adding a newly created container to a subsystem, the container must be initialize in
order to be added as a logical unit. If adding a container with stored data that needs to be
maintained, do not initialize this container; the container will be added as a logical unit.
CAUTION: Adding a unit immediately makes that unit available to all host connections
unless the DISABLE_ACCESS_PATH switch is specified. See the
ENABLE_ACCESS_PATH/DISABLE_ACCESS_PATH switch description for more
information.
Syntax
ADD UNITS unit-number container-name
Parameters
The following parameters are required for the ADD UNITS command:
s unit-number
s container-name
CLI Command Descriptions 2 25
These parameters are described in the following paragraphs:
unit-number
The unit number is the designation by which the controller keeps track of the unit. This
number maps to one or more host-accessible LUNs. Unit numbers are prefixed by D
and are in the range of 0--199. How units are assigned to ports depends on the failover
mode.
Transparent failover mode:
D0 to D99 are units assigned to port 1
D100 to D199 are units assigned to port 2
Multiple-bus failover mode:
D0 to D199 are units visible to the hosts through both ports of both controllers
In transparent failover mode, adding unit D0 creates a logical unit and presents it as D0
to the host on port 1. Adding unit D100 creates a logical unit and presents it as D0 to
the host on port 2.
Partitioned units cannot be split across ports.
In multiple-bus failover mode, adding unit D0 creates a logical unit that is presented to
both ports on both controllers. What hosts can see the unit is determined by parameters
of the ADD CONNECTIONS command and by the
ENABLE/DISABLE_ACCESS_PATH switch of the ADD UNITS command.
The LUN number a host connection assigns to a unit is a function of the
UNIT_OFFSET switch in the ADD (or SET) CONNECTIONS command. LUN
number equals unit number minus offset:
LUN number = unit number offset
If no value is specified for the UNIT_OFFSET switch in the ADD (or SET)
CONNECTIONS command, the offsets are as follows:
In transparent failover mode, host connections on port 1 have an offset of 0 and
host connections on port 2 have an offset of 100.
In multiple-bus failover mode, all ports have a default offset of 0.
container-name
Specifies the name of the container (disk drive, device, storageset, or partition) being
used to create the unit.
A unit can consist of a maximum of 48 devices.
226 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
Switches
Table 21 lists all switches for the ADD UNITS 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 UNITS Switches for New Containers
N0Tra nsportable
Switch Container Type
Transportable
Passthrough
Mirrorset
Stripeset
RAIDset
ENABLE_ACCESS_PATH
DISABLE_ACCESS_PATH
MAX_READ_CACHED_TRANSFER_SIZE
MAX_WRITE_CACHED_TRANSFER_SIZE
MAXIMUM_CACHED_TRANSFER_SIZE
PARTITION= partition-number
PREFERRED_PATH
NOPREFERRED_PATH
READ_CACH E
NOREAD _CACHE
READAHEAD_CACHE
NOREAD AHEAD_CACHE
R UN
N OR UN
WRITE_PROTECT
NOWRITE_PROTECT
WRITEBACK_CACHE
NOWRITEBACK_CACHE
NOTE: The NORUN switch cannot be specified for partitioned units.
CLI Command Descriptions 2 27
ENABLE_ACCESS_PATH=
DISABLE_ACCESS_PATH=
Determines which host connections can access the unit. The allowable variables are:
ALL
A string of connection names, separated by commas and enclosed in parentheses.
Setting ENABLE_ACCESS_PATH=ALL permits all host connections to access the
unit. This is the default.
CAUTION: If the storage subsystem has more than one host connection, access path
must be specified carefully to avoid giving undesirable host connections access to the
unit. The default condition is that access paths to all host connections are enabled. To
restrict host access to a set of host connections, specify
DISABLE_ACCESS_PATH=ALL when the unit is added, then use the SET unit
command to specify the set of host connections that are to have access to the unit.
Enabling the access path to a particular host connection does not override previously
enabled access paths. All access paths previously enabled are still valid; the new host
connection is simply added to the list of connections that can access the unit.
The procedure of restricting access by enabling all access paths then disabling
selected paths is particularly not recommended because of the potential data/security
breach that occurs when a new host connection is added.
MAX_READ_CACHED_TRANSFER_SIZE=n
MAX_READ_CACHED_TRANSFER_SIZE=32 (default)
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=n
MAX_WRITE_CACHED_TRANSFER_SIZE=32 (default)
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 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.
228 HSG60 Array Controller ACS Version 8.6 CLI Reference Guide
MAXIMUM_CACH ED_TRANSFER_SIZE=n
MAXIMUM_CACH ED_TRANSFER_SIZE=32 (default)
Sets the largest number of read and write blocks to be cached by the controller. The
controller will not cache any transfers over the size set. Acceptable write block sizes
are 1 through 2048.
The MAXIMUM_CACHED_TRANSFER_SIZE switch affects both read and
write-back cache when set on a controller that has read and write-back caching.
The use of this switch has the effect of setting both the
MAX_READ_CACHED_TRANSFER_SIZE and the
MAX_WRITE_CACHED_TRANSFER_SIZE switches.
PARTITION=partition-number
Identifies the partition-number for a partition on a container. The partition-number
identifies the partition associated with the unit number being added. Use the SHOW
container-name command to find the partition numbers used by a storageset or a
single-disk unit.
NOTE: Transportable units cannot be partitioned. All partitions on a container must be
addressed through the same controller. If you add a unit for a partition and specify the preferred
path switch, all partitions on that container inherit the same path.
PREFERRED_PATH=O THER_CONTROLLER
PREFERRED_PATH=THIS_CONTROLLER
NOPREFERRED_PATH (default)
The PREFERRED_PATH switch allows balancing of the I/O load by specifying the
controller through which the unit will be accessed. If you set NOPREFERRED_PATH
for a unit, it can be accessed through either controller.
| ed-write-ba
|
