HP STORAGEWORKS ARRAY CONTROLLER HSG V8.7 User Manual

hp StorageWorks

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

Part Number: EK–G80CL–RA. B01

Second Edition (August 2002)

Product Version:

8.7

This guide provides detailed descriptions of all CLI commands and step-by-step instructions on how to use each command.

© Hewlett-Packard Company, 2002. All rights reserved.

Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.

This document contains proprietary information, which is protected by copyright. No part of this document may be photocopied, reproduced, or translated into another language without the prior written consent of Hewlett-Packard. The information contained in this document is subject to change without notice.

Microsoft, MS-DOS, Windows, and Windows NT are trademarks of Microsoft Corporation in the U.S. and/or other countries.

All other product names mentioned herein may be trademarks of their respective companies.

Hewlett-Packard Company shall not be liable for technical or editorial errors or omissions contained herein. The information is provided “as is” without warranty of any kind and is subject to change without notice. The warranties for Hewlett-Packard Company products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.

Printed in the U.S.A.

HSG80 Array Controller V8.7 Command Line Interface Reference Guide Second Edition (August 2002)

Part Number: EK–G80CL–RA. B01

Contents

About this Guide

Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v Symbols in Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v Symbols on Equipment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi Rack Stability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

StorageWorks Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii StorageWorks Website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii StorageWorks Authorized Reseller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

1 CLI Command Introduction

CLI Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–1

Using the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–1

Command Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2

Controller Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2

Device Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3

Selective Storage Presentation Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3

Storageset Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–4

Partition Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–4

Logical Unit Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–5

Diagnostic and Utility Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–5

Data Replication Manager (DRM) Commands . . . . . . . . . . . . . . . . . . . . . . . . 1–5

Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–6

Entering CLI Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–6

Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–7

Changing the CLI Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–8

2 CLI Command Descriptions

CLI Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–1

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

iii

Contents

Glossary

Index

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

About this Guide

This Command Line Interface reference guide provides information to help you:

•Use the CLI commands

•Contact technical support for additional assistance

Document Conventions

The conventions included in Table 1 apply in most cases.

Table 1: Document Conventions

Element	Convention
Key names, menu items, buttons,	Bold
and dialog box titles
File names and application names	Italics
User input, command names, system	Monospace font
responses (output and messages)	COMMAND NAMES are uppercase
	unless they are case sensitive
Variables	Monospace, italic font
Website addresses	Sans serif font (http://www.compaq.com)

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.

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

v

About this Guide

CAUTION: Text set off in this manner indicates that failure to follow directions could result in damage to equipment or data.

IMPORTANT: Text set off in this manner presents clarifying information or specific instructions.

NOTE: Text set off in this manner presents commentary, sidelights, or interesting points of information.

Symbols on Equipment

Any enclosed surface or area of the equipment marked with these symbols indicates the presence of electrical shock hazards. Enclosed area contains no operator serviceable parts.

WARNING: To reduce the risk of injury from electrical shock hazards, do not open this enclosure.

Any RJ-45 receptacle marked with these symbols indicates a network interface connection.

WARNING: To reduce the risk of electrical shock, fire, or damage to the equipment, do not plug telephone or telecommunications connectors into this receptacle.

Any surface or area of the equipment marked with these symbols indicates the presence of a hot surface or hot component. Contact with this surface could result in injury.

WARNING: To reduce the risk of injury from a hot component, allow the surface to cool before touching.

Power supplies or systems marked with these symbols indicate the presence of multiple sources of power.

WARNING: To reduce the risk of injury from electrical shock, remove all power cords to completely disconnect power from the power supplies and systems.

vi	HSG80 Array Controller V8.7 Command Line Interface Reference Guide

About this Guide

Any product or assembly marked with these symbols indicates that the component exceeds the recommended weight for one individual to handle safely.

WARNING: To reduce the risk of personal injury or damage to the equipment, observe local occupational health and safety requirements and guidelines for manually handling material.

Rack Stability

WARNING: To reduce the risk of personal injury or damage to the equipment, be sure that:

•The leveling jacks are extended to the floor.

•The full weight of the rack rests on the leveling jacks.

•In single rack installations, the stabilizing feet are attached to the rack.

•In multiple rack installations, the racks are coupled.

•Only one rack component is extended at any time. A rack may become unstable if more than one rack component is extended for any reason.

Getting Help

If you still have a question after reading this guide, contact service representatives or visit our website.

StorageWorks Technical Support

In North America, call StorageWorks technical support at 1-800-OK-COMPAQ, available 24 hours a day, 7 days a week.

NOTE: For continuous quality improvement, calls may be recorded or monitored.

Outside North America, call StorageWorks technical support at the nearest location. Telephone numbers for worldwide technical support are listed on the StorageWorks website: http://www.compaq.com.

Be sure to have the following information available before calling:

•Technical support registration number (if applicable)

•Product serial numbers

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

vii

About this Guide

•Product model names and numbers

•Applicable error messages

•Operating system type and revision level

•Detailed, specific questions.

StorageWorks Website

The StorageWorks website has the latest information on this product, as well as the latest drivers. Access the StorageWorks website at: http://www.compaq.com/storage. From this website, select the appropriate product or solution.

StorageWorks Authorized Reseller

For the name of your nearest StorageWorks Authorized Reseller:

•In the United States, call 1-800-345-1518.

•In Canada, call 1-800-263-5868.

•Elsewhere, see the StorageWorks website for locations and telephone numbers.

viii	HSG80 Array Controller V8.7 Command Line Interface Reference Guide

1

CLI Command Introduction

Command line interface (CLI) provides a set of commands used to maintain controller parameters and manage storagesets. These CLI commands can be delivered to the controller by any of the following means:

•A local terminal connected to the maintenance port of the controller

•A remote connection by way of the host system terminal

•The StorageWorks Command Console (SWCC)

This chapter provides a general description of the CLI interface and an outline of how to use this interface. Chapter 2 contains a description of each CLI command with the correct syntax and examples of usage.

CLI Overview

Issuing CLI commands via the maintenance port of the controller is the most direct means of communicating with the controller. The CLI commands allow you to manage the subsystem by viewing and modifying the configuration of the controller and the devices attached to them. You can also use the CLI to start controller diagnostic and utility programs.

While the CLI provides the most detailed level of subsystem control, a graphical user interface (GUI) is available for use with the CLI. The GUI that is designed for use in the application of CLI commands is called the StorageWorks Command Console (SWCC). The SWCC replicates most of the functions available within the CLI in graphic form and provides a user-friendly method of executing CLI commands.

Using the CLI

Access the CLI through the following methods:

•Connecting a PC or local terminal to the maintenance port on the front of the controller.

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

1–1

CLI Command Introduction

•Using the diagnostic utility protocol (DUP) utility from a system terminal, enable a remote connection to the controller. After the controller is initially configured and made visible to the host, other configuration tasks can be performed through this remote connection.

•Using the SWCC by way of a PC setup on the subsystem. The SWCC can be used to perform most of the CLI commands that the local terminal can perform.

Command Overview

CLI commands are divided into categories based on the options or structures they control. The following sections list these command categories.

Controller Commands

Controller commands configure the maintenance terminal characteristics, CLI prompt, and so forth. These commands are also used to shut down and restart the controller. There are two types of controller commands: general and failover.

The CLI commands that pertain to the controllers in a general way are:

•CLEAR_ERRORS

•CONFIGURATION

•EXIT

•HELP

•POWEROFF

•RESTART

•SELFTEST

•SET

•SHOW

•RUN

•SHUTDOWN

The CLI commands controlling the failover mode of a controller pair are:

•SET FAILOVER

•SET MULTIBUS_FAILOVER

•SET NOFAILOVER

1–2	HSG80 Array Controller V8.7 Command Line Interface Reference Guide

CLI Command Introduction

•SET NOMULTIBUS_FAILOVER

Device Commands

Device commands create and configure containers made from physical devices attached to the controller. There are two types of device commands: general and spareset/failedset.

The CLI Commands that allow you to add and configure physical devices in general are:

•ADD DISK

•ADD PASSTHROUGH

•CLEAR ERRORS

•DELETE

•INITIALIZE

•LOCATE

•RENAME

•SET

The CLI commands that support sparesets and failedsets include:

•ADD SPARESET

•DELETE FAILEDSET

•DELETE SPARESET

•SET FAILEDSET

•SHOW FAILEDSET

Selective Storage Presentation Commands

Selective Storage Presentation commands enable or disable access to individually selected units from host and controller ports. Paths can be enabled or disabled either all inclusively or specifically on a per-path basis during the addition of new units or as a modification of existing units.

The CLI commands that pertain to the Selective Storage Presentation feature include:

•ADD UNITS (the ENABLE_ACCESS_PATH switch)

•ADD UNITS (the DISABLE_ACCESS_PATH switch)

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

1–3

CLI Command Introduction

•SET unit-number (the ENABLE_ACCESS_PATH switch)

•SET unit-number (the DISABLE_ACCESS_PATH switch)

•ADD CONNECTIONS (the UNIT_OFFSET switch)

•SET connection-name (the UNIT_OFFSET switch)

Storageset Commands

Storageset commands create and configure complex containers made from groups of device containers. These commands group device containers together and allow them to be handled as single units. There are four types of storagesets: stripesets, RAIDsets, striped-mirrorsets, and mirrorsets.

The CLI commands that pertain to storagesets include:

•ADD MIRRORSET

•ADD RAIDSET

•ADD STRIPESET

•DELETE

•INITIALIZE

•LOCATE

•MIRROR

•REDUCE

•RENAME

•SET

•SHOW

•UNMIRROR

Partition Commands

Partition commands create multiple logical disk units from the same container.

The CLI Commands that pertain to partitions include:

•CREATE_PARTITION

•DESTROY_PARTITION

1–4	HSG80 Array Controller V8.7 Command Line Interface Reference Guide

CLI Command Introduction

Logical Unit Commands

Logical unit commands create and optimize access to logical units made from any container type.

The CLI commands that pertain to units include:

•ADD CONCATSETS

•ADD SNAPSHOT_UNITS

•DELETE

•LOCATE

•RENAME

•RETRY_ERRORS UNWRITEABLE_DATA

•SET

•SHOW

Diagnostic and Utility Commands

Diagnostic and utility commands perform general controller support functions.

The commands that pertain to the diagnostics and utilities include:

•DIRECTORY

•RUN

Data Replication Manager (DRM) Commands

DRM uses the peer-to-peer remote copy function of the HSG80 controller to achieve data replication. HSG80 controller pairs at the initiator site are connected to a partner HSG80 controller pair at the target site. Remote copy sets are created from units at the initiator and target sites. These remote copy sets are mirrors of each other.

The HSG80 controllers provide failover and failback capabilities in case of failures. Failover makes the data available at the target site after a failure. Failback is used to move data operations back to the initiator site once the site is back online.

NOTE: All DRM commands are hidden and inoperative until the controller pair is put into remote copy mode by specifying the REMOTE_COPY switch of the SET controller command.

DRM applies only to the HSG80 array controller running ACS version 8.7P.

The CLI commands used to configure a DRM environment and for failover and failback procedures include:

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

1–5

CLI Command Introduction

•ADD ASSOCIATIONS

•ADD REMOTE_COPY_SET

•DELETE association-set-name

•DELETE remote-copy-set-name

•SET association-set-name

•SET remote-copy-set-name

•SITE FAILOVER

Getting Help

To get help with using the CLI commands, enter HELP at the CLI prompt. The resulting display shows an overview of the CLI Help System. To obtain help with a specific command or to determine what switches are available with a command, enter as much of the command syntax that is known, followed by a space and a question mark.

For example, to get information on the switches used with the SET

THIS_CONTROLLER command, enter:

SET THIS_CONTROLLER=?

To see what is allowed for a prompt, enter the following:

SET THIS PROMPT=?

Entering CLI Commands

Use the following tips and techniques for the entering of CLI commands:

•Commands are not case-sensitive.

•For most commands, only enter enough of the command to make the command unique. For example, SHO is the same as entering SHOW.

•The controller processes each command in sequence, regardless of the number of commands entered. A controller experiencing heavy data I/O might respond slowly to CLI commands.

Specific keys or a combination of keys allow the ability to recall and edit the last four commands. This feature can save time and help prevent mistakes when entering similar commands during the configuration process. Table 1–1 lists the keys used to recall and edit commands.

1–6	HSG80 Array Controller V8.7 Command Line Interface Reference Guide

		CLI Command Introduction
	Table 1–1: Recall and Edit Command Keys
	Key	Function
	Up Arrow key or Ctrl+B	Steps forwards or backward through the four most
	keys,	recent CLI commands.
	Down Arrow key or
	Ctrl+N keys
	Left Arrow key or	Moves the cursor left or right in a command line.
	Ctrl+D keys,
	Right Arrow key or
	Ctrl+F keys
	Ctrl+E keys	Moves the cursor to the end of the line.
	Ctrl+H keys	Moves the cursor to the beginning of the line.
	Ctrl+J keys or Linefeed	Deletes the word to the left of the cursor.
	key
	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:
		• The default setting is insert mode allowing you
		to insert characters at the cursor location
		(moving the existing characters to the right).
		• Overstrike mode replaces existing characters.
		The CLI prompt returns to insert mode at the
		beginning of each line.
	Ctrl+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 <PARAMETER_NAME=parameter> SWITCHES

•COMMAND—A word or phrase expressed as a verb that is used to instruct the controller what to do. Commands are represented in this guide in capitalized form.

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

1–7

CLI Command Introduction

•PARAMETER_NAME—The name of a parameter, followed by an equal sign and the parameter variable. If a specific command specifies parameter names, they must be entered in the command string. Parameter names are represented in this guide in capitalized form.

•parameter—When required in the command, parameters are used as one or more words or phrases that supply necessary information to support the action of the COMMAND. Note that not all CLI commands require parameters. Parameters are represented in this guide as lowercase, italicized text.

•SWITCHES—An optional word or phrase that modifies the command/parameter string. Not all CLI commands require switches. Switches are represented in this guide as capitalized, italicized text.

Changing the CLI Prompt

Change the CLI prompt display by using the SET controller PROMPT command. Enter a 1- to 16character string as the new prompt. For example, the prompt could be changed to indicate the array controller type, such as “HSG>.”

1–8	HSG80 Array Controller V8.7 Command Line Interface Reference Guide

2

CLI Command Descriptions

The previous chapter provided a general description of the CLI interface and an outline of how to use the interface. This section contains the CLI command descriptions that contain the description, full syntax, and examples of the use of each command available on the CLI interface.

CLI Command Descriptions

This section contains the descriptions of the available CLI commands used with the ACS versions 8.7F, 8.7G, 8.7P, and 8.7S software. Each command is described using the following format:

•Command name and brief description

•Syntax needed to enable command

•Parameters needed (if any) to further specify the command

•Switches needed (if any) to modify the command

•Example(s) to illustrate the command usage

•A “See Also” section to cross-reference to others with similar usage

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

2–1

CLI Command Descriptions

ADD ASSOCIATIONS

An association set is a group of remote copy sets that shares common attributes (See SET ASSOCIATIONS for the attribute list). This command adds an association set to the controller pair’s configuration. The association set can be initialized with a single remote copy set through the use of the remote-copy-set-name switch. Additional remote copy sets can be added to the association set with the SET association-set-name command.

NOTE: This command is hidden and inoperative until the controller pair is put into remote copy mode by specifying the REMOTE_COPY switch of the SET controller command.

This command is valid only on the node on which the Initiator resides (where remote copy sets are configured).

This command is rejected if the specified remote copy set is unknown to the controller pair.

Syntax

ADD ASSOCIATIONS association-set-name

Parameters

The following parameters are required for the ADD ASSOCIATIONS command:

association-set-name

The association-set-name may consist of a maximum of nine printable characters excluding commas and back-slashes.

NOTE: Association sets cannot be renamed with the RENAME command. If the wrong name is entered, the association set must be deleted and then added again.

Switches

The following switch is available with the ADD ASSOCIATIONS command: remote-copy-set-name

The name of the first member of the association set.

Examples

To create an association set, AS3, from remote copy sets RSC1 and RSC2, enter:

ADD ASSOCIATIONS AS3 RSC1

SET AS3 ADD=RSC2

2–2	HSG80 Array Controller V8.7 Command Line Interface Reference Guide

ADD ASSOCIATIONS

See Also

ADD REMOTE_COPY_SETS

SET association-set-name

SHOW ASSOCIATIONS

SHOW association-set-name

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

2–3

CLI Command Descriptions

ADD CONCATSETS

Creates a specialized volume, called a concatset (short for concatenation set), from a storageset that has been given a unit number. Another storageset can then be added to the concatset by the SET CONCATSETS command, thereby dynamically increasing the size of the unit.

CAUTION: This command should only be executed with host operating systems that support dynamic volume expansion. If the operating system cannot handle one of its disks increasing in size, use of this command could make data inaccessible.

Syntax

ADD CONCATSETS concatset-name storageset-name

Parameters

The following parameters are required for the ADD CONCATSETS command:

•concatset-name

•storageset-name

These parameters are described in the following paragraphs:

concatset-name

The name to be assigned to the concatenation, or concatset.

The concatset-name must consist of a string of up to nine printable characters excluding commas and back-slashes.

storageset-name

Designates the first storageset to be a member of the concatset. The storageset specified must already be configured as a unit.

Switches

There are no switches associated with this command.

2–4	HSG80 Array Controller V8.7 Command Line Interface Reference Guide

ADD CONCATSETS

Examples

To convert unit D0, which consists of stripeset STRIPE1, to a concatset, enter:

ADD CONCATSETS C1 STRIPE1

To add STRIPE2 to the concatset C1, enter:

SET C1 ADD=STRIPE2

See Also

DELETE concatset-name

SET concatset-name

SHOW CONCATSETS

SHOW concatset-name

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

2–5

CLI Command Descriptions

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:

•Physically connecting a host adapter to a controller host port. During Fibre Channel initialization, the controller is aware of the connection and adds it to the table. The controller assigns a default connection name to new connections that are discovered through the physical connection. 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 is assigned a default connection name.

•Adding a connection through the ADD CONNECTIONS command.

NOTE: ADD CONNECTIONS adds an entry to the table whether the connection physically exists or not. The table can be completely filled with fictitious connections.

Syntax

ADD CONNECTIONS connection-name HOST_ID=host-id ADAPTER_ID=adapter-id CONTROLLER=controller PORT=port

ADD CONNECTIONS REJECTED_HOST=index

Parameters

The following parameters support the ADD CONNECTIONS command:

•connection-name

•HOST_ID

•ADAPTER_ID

•CONTROLLER

•PORT

2–6	HSG80 Array Controller V8.7 Command Line Interface Reference Guide

ADD CONNECTIONS

•REJECTED_HOST

These parameters are described in the following paragraphs:

connection-name

The name assigned to the host connection. The connection-name may consist of a maximum of nine printable characters excluding commas and back-slashes.

The controller automatically assigns default connection name when a connection is physically made between a host adapter and a controller port. The form of a default connection name is !NEWCONnn.

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, enter:

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 WWN of AAAA-BBBB-CCCC-DDDD, enter:

ADAPTER_ID=AAAA-BBBB-CCCC-DDDD

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 and OTHER_CONTROLLER.

PORT=port

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

2–7

CLI Command Descriptions

PORT is the parameter name for the port variable that specifies which host port (1 or 2) the connection is on.

REJECTED_HOST=rejected-host-index

To manually add rejected host zero, issue the following command:

ADD CONNECTION REJECTED_HOST=0

NOTE: Use SHOW CONNECTIONS FULL to display the rejected host connections.

This command adds a !NEWCONxx connection to the connection table in an OFFLINE state. The host must issue a FC PLOGI to make the connection active. There are mechanisms to do this in UNIX, VMS, but not NT (except reboot).

For example, to force the connection into an online state, issue the following command:

CLI> SET <THIS | OTHER> PORT_<1|2>_TOPOLOGY = OFFLINE

followed by:

CLI> SET <THIS | OTHER> PORT_<1|2>_TOPOLOGY = FABRIC

This forces all hosts connected to that controller/port to re-login. Additionally, hosts connected to the controller pair through the same switch (regardless of controller | port) re-login as well.

CAUTION: This implementation is the safest, since pinging the fabric name server would result in all hosts re-logging in (up to 96).

When the connection is added, it gets deleted from the reject list. Index numbers for remaining rejected hosts are re-ordered.

Switches

The following switches are available with the ADD CONNECTION command:

•OPERATING_SYSTEM

•RESERVATION_STYLE

•UNIT_OFFSET

These switches are described in the following paragraphs:

OPERATING_SYSTEM=OS_name

2–8	HSG80 Array Controller V8.7 Command Line Interface Reference Guide

ADD CONNECTIONS

Specifies the operating system of the host. The OPERATING_SYSTEM switch tailors the controller's behavior for use with a particular operating system. See your operating system specific Solution Kit to determine which value should be used. The following values are supported: WINNT, TRU64_UNIX, VMS, HP, HP_VSA, IBM, NETWARE, SGI, SNI, SUN, AIX_CAMBEX.

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 that it allows various hosts, with different reservation style requirements, to be connected to the same HSG80 controllers in a SAN environment.

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

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

2–9

CLI Command Descriptions

•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 effects of these offset assignments are as follows:

•Server1 accesses units D0 through D7, which it sees as LUNs 0 through 7.

•Server2 accesses units D10 through D17, which it sees as LUNs 0 through 7.

•Server3 accesses units D120 through D127, which it sees 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.

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

2–10	HSG80 Array Controller V8.7 Command Line Interface Reference Guide

ADD CONNECTIONS

See Also

DELETE connection-name

SET connection-name

RENAME

SHOW connection-name

SHOW CONNECTIONS

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

2–11

CLI Command Descriptions

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 by issuing the RUN CONFIG command.

NOTE: The controller supports a maximum of 84 physical storage devices, even though more than 84 target IDs are available. Do not exceed the maximum number of physical devices in the subsystem.

Syntax

ADD DISKS disk-name scsi-port-target-lun

Parameters

The following parameters are required for the ADD DISKS command:

•disk-name

•scsi-port-target-lun

These parameters are described in the following paragraphs:

disk-name

Assigns a name to the disk device. This disk-name can then be used with the ADD UNITS command to create a logical unit, or a parameter in the adding of a storageset.

The disk-name may consist of a maximum of nine printable characters excluding commas and back-slashes.

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 at least 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.

2–12	HSG80 Array Controller V8.7 Command Line Interface Reference Guide

ADD DISKS

•target—Designates the SCSI target ID of the disk on the port. Valid device target IDs for single controller configurations are 00–15, excluding ID 7. Valid device target IDs for dual controller configurations are 00–15, 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:

•TRANSFER_RATE_REQUESTED

•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.

HSG80 Array Controller V8.7 Command Line Interface Reference Guide

2–13

CLI Command Descriptions

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: StorageWorks 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

2–14	HSG80 Array Controller V8.7 Command Line Interface Reference Guide