HSG80 Array Controller
ACS Version 8.6
CLI Reference Guide
First Edition (June 2001)
Part Number: EKG80CLRA. 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.
Compaq 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.
Compaq 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 authorized 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.
HSG80 Array Controller ACS Version 8.6
CLI Reference Guide
First Edition (June 2001)
Part Number: EKG80CLRA. A01
Contents
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
Data Replication Manager (DRM) Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Entering CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
iv HSG80 Array Controller ACS Version 8.6 CLI Reference Guide
Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Changing the CLI Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Chapter 2
CLI Command Descriptions
CLI Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Glossary
Index
v
Figures
Figure 21. Location of node ID sticker on a BA370 enclosure. . . . . . . . . . . . . . . . . . . . . . . . . 2111
vi HSG80 Array Controller ACS Version 8.6 CLI Reference Guide
Tables
Table 11 Recall and Edit Command Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Table 21 ADD UNITS Switches for New Containers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Table 22 POWEROFF Switch Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Table 23 SET controller Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2106
Table 24 EMU Set Point Temperatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2119
Table 25 SET unit-number Switches for Existing Containers . . . . . . . . . . . . . . . . . . . . . . . . . 2139
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
COMMANDS, 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 HSG80 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 HSG80 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 Elsewhere, 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 HSG80 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 CLEAR_ERRORS
CLI
INVALID_CACHE
s CONFIGURATION
RESET
RESTORE
SAVE
CLI Command Introduction 1 3
s EXIT
s HELP
s POWEROFF
s RESTART
s SELFTEST
s SET
s SHOW
s RUN
s SHUTDOWN
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 CLEAR ERRORS
LOST_DATA
UNKNOWN
UNWRITEABLE_DATA
s DELETE
s INITIALIZE
s LOCATE
14 HSG80 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 1 5
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 HSG80 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
Data Replication Manager (DRM) Commands
DRM uses the peer-to-peer remote copy function of the HSG80 controller to achieve data
replication. HSG80 controller pairs at the initiator site are connected to a partner HSG80
controller pair at the target site. Remote copy sets are created from units at the initiator and
target sites. These remote copy sets are mirrors of each other.
The HSG80 controllers provide failover and failback capabilities in case of failures.
Failover makes the data available at the target site after a failure. Failback is used to move
data operations back to the initiator site once the site is back online.
The following CLI commands are used to configure a DRM environment and for failover
and failback procedures include
NOTE: All DRM commands are hidden and inoperative until the controller pair is put into remote
copy mode by specifying the REMOTE_COPY switch of the SET controller command.
DRM applies only to the HSG80 array controller running ACS version 8.6P.
The CLI commands used to configure a DRM environment and for failover and failback
procedures include:
s ADD ASSOCIATIONS
s ADD REMOTE_COPY_SET
s DELETE association-set-name
s DELETE remote-copy-set-name
s SET association-set-name
s SET remote-copy-set-name
s SITE FAILOVER
CLI Command Introduction 1 7
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.
18 HSG80 Array Controller ACS Version 8.6 CLI Reference Guide
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 parameter--When required in the command, parameters are used as one or more
words or phrases that supply necessary information to support the action of the
COMMAND. Note that not all CLI commands require parameters. Parameters are
represented in this guide as lowercase, italicized text.
CLI Command Introduction 1 9
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.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 HSG80 Array Controller ACS Version 8.6 CLI Reference Guide
ADD ASSOCIATIONS
An association set is a group of remote copy sets that shares common attributes. This
command adds a one-member association set (that is, an association set consisting of one
remote copy set) to the controller pair's configuration. Additional remote copy sets can be
added to the association set with the SET associations command.
NOTE: This command works only in a Data Replication Manager (DRM) environment and
requires an HSG80 array controller with ACS version 8.6P code. Like all DRM commands, use of
this command is heavily restricted. Refer to Compaq StorageWorks Data Replication Manager
HSG80 ACS Version 8.6P Operations Guide for examples of usage.
This command is valid only on the node on which the Initiator resides (where remote copy sets
are configured).
This command is rejected if the specified remote copy set is unknown to the controller
pair.
Syntax
ADD ASSOCIATIONS association-set-name
ADD ASSOCIATIONS remote-copy-set-name
Parameters
The following parameters are required for the ADD ASSOCIATIONS command:
s association-set-name
s remote-copy-set-name
These parameters are described in the following paragraphs:
association-set-name
The name can be any character string assigned to the association set.
NOTE: Association sets cannot be renamed with the RENAME command. If the wrong name is
entered, the association set must be deleted and then added again.
The association-set-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 (_).
remote-copy-set-name
CLI Command Descriptions 2 3
The name of the first member of the association set. This name can be any
character string.
Switches
There are no switches associated with this command.
Examples
To create an association set, AS3, from remote copy sets RSC1 and RSC2, enter:
ADD ASSOCIATIONS AS3 RSC1
SET AS3 ADD=RSC2
See Also
ADD REMOTE_COPY_SETS
SET associations
24 HSG80 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-name
Designates the first storageset to be a member of the concatset.
Switches
There are no switches associated with this command.
CLI Command Descriptions 2 5
Examples
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
26 HSG80 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 CONTROLLER
s PORT
CLI Command Descriptions 2 7
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.
28 HSG80 Array Controller ACS Version 8.6 CLI Reference Guide
Switches
The following switches are available with the ADD CONNECTION command:
s OPERATING_SYSTEM
s RESERVATION_STYLE
s UNIT_OFFSET
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=CONNECTION_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 9
UNIT_OFFSET=n
UNIT_OFFSET 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 D0 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 D120 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.
210 HSG80 Array Controller ACS Version 8.6 CLI Reference Guide
Examples
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 11
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.
212 HSG80 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=ASYNCHRONOUS
TRANSFER_RATE_REQUESTED=DEFAULT
TRANSFER_RATE_REQUESTED=20MHZ (default)
TRANSFER_RATE_REQUESTED=10MHZ
TRANSFER_RATE_REQUESTED=5MHZ
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 13
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.
Examples
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
214 HSG80 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 15
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 2125).
READ_SOURCE=LEAST_BUSY (default)
READ_SOURCE=ROUND_ROBIN
Selects the mirrorset member used by the controller to satisfy a read request.
216 HSG80 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.
Examples
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 17
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 logical 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.
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
passthrough device resides.
218 HSG80 Array Controller ACS Version 8.6 CLI Reference Guide
target--Designates the SCSI target ID of the passthrough device 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
4 through 7.
lun--Indicates the LUN of the passthrough device.
The parameters port, target, and lun must be entered with at least one space between them.
Leading zeroes can be excluded.
Switches
The following switch is available with the ADD DISKS command:
s TRANSFER_RATE_REQUESTED
These switches are described in the following paragraphs.
TRANSFER_RATE_REQUESTED=ASYNCHRONOUS
TRANSFER_RATE_REQUESTED=DEFAULT
TRANSFER_RATE_REQUESTED=20MHZ (default)
TRANSFER_RATE_REQUESTED=10MHZ
TRANSFER_RATE_REQUESTED=5MHZ
Specifies the maximum data transfer rate at which the controller is to communicate
with the passthrough device. The transfer rate might need to be limited to
accommodate long cables between the controllers and the device.
Examples
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 19
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.
220 HSG80 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 RECONSTRUCT
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 2133, for more information regarding this
procedure.
CLI Command Descriptions 2 21
RECONSTRUCT=FAST
RECONSTRUCT=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.
Examples
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
222 HSG80 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 23
ADD REMOTE_COPY_SETS
Creates a remote copy set (RCS), consisting of one unit at the initiator site and one unit at
the target site. The units may be a single disk (JBOD) or a stripeset, mirrorset, or RAIDset.
NOTE: This command works only in a DRM environment and requires an HSG80 array controller
with ACS version 8.6P code. Like all DRM commands, use of this command is heavily restricted.
Refer to the Compaq StorageWorks Data Replication Manager HSG80 ACS Version 8.6P
Operations Guide for examples of usage.
This command must only be used on the initiator (local) site.
The following restrictions apply to remote copy sets:
s There is a maximum of 12 remote copy sets per initiator/target pair.
s Neither initiator nor target units can be transportable units, concatset units, or snapshot
units.
Syntax
ADD REMOTE_COPY_SETS remote-copy-set-name initiator-unit-name
remote-node-name\target-unit-name
Parameters
The parameters required for this command are:
s remote-copy-set-name
s initiator-unit-name
s remote-node-name\target-unit-name (this parameter is not required; it can be added
later through the SET command)
These parameters are described in the following paragraphs:
remote-copy-set-name
The name by which the remote copy set will be known. This name must be unique
across the fabric.
NOTE: Remote copy sets cannot be renamed with the RENAME command. If the wrong name is
entered, the remote copy set must be deleted and then added again.
224 HSG80 Array Controller ACS Version 8.6 CLI Reference Guide
The remote copy set name must start with RCS and may consist of a maximum of 9
characters including letters A through Z, numbers 0 through 9, periods (.), dashes (-),
or underscores (_).
initiator-unit-name
The name of the initiator unit that is to be the first member of the remote copy set.
remote-node-name\target-unit-name
The remote-node-name part of the parameter specifies the name of the controller
pair--called a node--receiving the command. The target-unit-name part specifies the
unit on the remote node to be added as the target of the remote copy set.
Switches
The following switches are available with the ADD REMOTE_COPY_SETS command:
s OPERATION_MODE
s OUTSTANDING_IOS
These switches are described in the following paragraphs.
OPERATION_MODE=SYNCHRONOUS (default)
OPERATION_MODE=ASYNCHRONOUS
This switch determines which of two normal operating modes is assigned to the remote
copy set.
In synchronous mode, write operations must be completed on the remote units of the
remote copy set before the host is informed that the operation is complete.
Synchronous operation assures data consistency at all times among the members of a
remote copy set.
In asynchronous mode, the write operation is reported as complete to the host before
the data is written to the remote units of the remote copy set. Asynchronous mode
gives greater performance and faster response time, but the data on all members of the
remote copy set cannot be assumed to be always the same.
CLI Command Descriptions 2 25
OUTSTANDING_IOS=n (1 to 240; default is 200)
This switch sets the number of outstanding I/O operations from the initiator to the
target. The way this switch operates depends on which operating mode is set by the
OPERATION_MODE switch:
In synchronous mode, OUTSTANDING_IO refers to the number of remote writes
(write operations from the initiator to the target) that can be outstanding.
In asynchronous mode, OUTSTANDING_IO refers to the number of write
operations that can be reported as completed to the host before they have been
written on all the members of the remote copy set.
Example
To create remote copy set RCS1, consisting of unit D1 on the local controller pair and unit
D21 on a remote controller pair (node) named London, enter:
ADD REMOTE_COPY_SET RCS1 D1 LONDON\D21
See Also
ADD ASSOCIATIONS
SET controller REMOTE_COPY
SET remote-copy-set-name
226 HSG80 Array Controller ACS Version 8.6 CLI Reference Guide
ADD SNAPSHOT_UNITS
Creates and names a snapshot unit. A snapshot unit is one that reflects the contents of
another unit at a particular point in time (the instant the ADD SNAPSHOT_UNITS
command is entered). The snapshot unit can be presented to the host. The snapshot unit
remains until it is deleted (DELETE command).
NOTE: This command is operational only in ACS versions 8.6S and 8.6P and only if both
controllers have 512 MB of mirrored cache.
Syntax
ADD SNAPSHOT_UNITS snapshot-unit storageset-name source-unit
Parameters
The following parameters are required for the ADD SNAPSHOT_UNITS command:
s snapshot-unit
s storageset-name
s source-unit
The relationship of the parameters can be summarized as follows:
When the ADD SNAPSHOT_UNITS command is entered, storageset-name becomes
snapshot-unit and archives the current contents of source-unit at that instant.
These parameters are described in the paragraphs that follow.
snapshot-unit
The unit number that will be assigned to the snapshot unit. The unit number 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 (_).
The snapshot unit is created with all host access disabled by default. Do a SET
command to set up host access.
The snapshot unit will be created on the same controller as the source unit, and must
remain there.
storageset-name
Identifies the name of the storageset that will become the snapshot unit. The storageset
must have the following characteristics:
CLI Command Descriptions 2 27
Capacity equal to or greater than the source unit
Initialized
Not a partition or a concatset
source-unit
The unit whose contents will be frozen in time and preserved on the snapshot unit. The
source unit must have the following characteristics:
Less than 1.024 TB
Write-back cache enabled
Non-transportable
Switches
There are no switches associated with this command.
Example
To create unit D4, which consists of storageset RAID4 and which will become a
| ed-write-ba
|
