Page 1 StorageWorks HSG80 Array Controller V8.7 Command Line Interface Reference Guide Part Number: EK–G80CL–RA. B01 Second Edition (August 2002) Product Version: This guide provides detailed descriptions of all CLI commands and step-by-step instructions on how to use each command.
Page 2 © 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.
Page 3: Table Of Contents
Contents About this Guide Document Conventions ........... v Symbols in Text .
Page 4 Contents Glossary Index HSG80 Array Controller V8.7 Command Line Interface Reference Guide...
Page 5: About This 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,...
Page 6: Symbols On Equipment
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.
Page 7: Rack Stability
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.
Page 8: Storageworks Website
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 http://www.compaq.com/storage.
Page 9: Cli Command Introduction
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 •...
Page 10: Command Overview
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.
Page 11: Device Commands
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: •...
Page 12: Storageset Commands
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.
Page 13: Logical Unit Commands
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 •...
Page 14: Getting Help
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.
Page 15: Command Syntax
CLI Command Introduction Table 1–1: Recall and Edit Command Keys 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...
Page 16: Changing The Cli Prompt
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. •...
Page 17: Cli Command Descriptions
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.
Page 18 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.
Page 19 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...
Page 20 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.
Page 21: Show Concatsets
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...
Page 22: Connection-Name
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.
Page 23 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.
Page 24: Add Connection Rejected_Host
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.
Page 25 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.
Page 26 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.
Page 27: Show Connection-Name
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...
Page 28 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.
Page 29 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. •...
Page 30 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.
Page 31: Mirrorset-Name
ADD MIRRORSETS 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...
Page 32 CLI Command Descriptions 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.
Page 33: Show Mirrorset-Name
ADD MIRRORSETS • 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. •...
Page 34 CLI Command Descriptions ADD PASSTHROUGH Names a pass through device and adds it to the controller configuration. This command is typically used when pass through 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.
Page 35 ADD PASSTHROUGH • target—Designates the SCSI target ID of the passthrough device 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 through 7. •...
Page 36: Raidset-Name
CLI Command Descriptions 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 1.024TB StorageWorks RAIDsets are RAID level 3/5 storagesets that use the best characteristics of RAID level 3 and RAID level 5.
Page 37 ADD RAIDSETS Switches The following switches are available with the ADD RAIDSETS command: • POLICY and NOPOLICY • RECONSTRUCT • 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: •...
Page 38 CLI Command Descriptions • 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): •...
Page 39 ADD RAIDSETS See Also ADD UNITS DELETE container-name INITIALIZE SET RAIDSETS SHOW RAIDSETS SHOW RAIDset-name SHOW STORAGESETS HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–23...
Page 40 CLI Command Descriptions 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.7P code.
Page 41 ADD REMOTE_COPY_SETS The name of the initiator unit that is to be the first member of the remote copy set. This unit cannot be involved in a snapshot, and must not be a concatset. 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.
Page 42 CLI Command Descriptions • 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_SETS RCS1 D1 LONDON\D21 See Also...
Page 43 ADD SNAPSHOT_UNITS 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 manually presented to the host. The snapshot unit remains until it is deleted (DELETE command).
Page 44 CLI Command Descriptions • Capacity equal to or greater than the source unit • Initialized • Not a partition or a concatset source-unit The unit whose contents are frozen in time and preserved on the snapshot unit. The source unit must have the following characteristics: •...
Page 45 ADD SPARESETS ADD SPARESETS Adds a disk drive to the spareset and initializes the metadata on the drive.The spareset is a pool of drives available to the controller to replace failing storageset members. Syntax ADD SPARESETS disk-name Parameters disk-name Indicates the name of the disk drive being added to the spareset. Only one disk drive can be added to the spareset with each ADD SPARESETS command.
Page 46 CLI Command Descriptions ADD STRIPESETS Names a stripeset and adds it to the controller configuration. A stripeset can contain from 2 to 24 members. Stripesets are also referred to as RAID level 0 storagesets. The number of members in the stripeset is determined by the number of container-name parameters specified.
Page 47 ADD STRIPESETS Switches There are no switches associated with this command. Examples To create a stripeset named STRIPE1 that contains disks DISK10000, DISK20100, and DISK30200, enter: ADD STRIPESETS STRIPE1 DISK10000 DISK20100 DISK30200 To create a logical unit from STRIPE1, enter: INITIALIZE STRIPE1 ADD UNITS D103 STRIPE1 To create a two-member striped mirrorset (a stripeset whose members are mirrorsets),...
Page 48 CLI Command Descriptions ADD UNITS Creates a logical unit from a specified container. The controller maps all requests from the host to the logical-unit number as requests to the container specified in the ADD UNITS command. Units can be created from all container types: •...
Page 49 ADD UNITS The unit number is the designation by which the controller keeps track of the unit. This number maps to one or more host-accessible LUNs. Unit numbers are prefixed by D and are in the range of 0–199. How units are assigned to ports depends on the failover mode.
Page 50: Container-Name
CLI Command Descriptions container-name Specifies the name of the container (device, storageset, or partition) being used to create the unit. A unit can consist of a maximum of 48 devices. Switches Table 2–1 lists all switches for the ADD UNITS command and identifies which switches may be used with each type of device or storageset.
Page 51 ADD UNITS Table 2–1: ADD UNITS Switches for New Containers (Continued) Switch WRITE_PROTECT NOWRITE_PROTECT WRITEBACK_CACHE NOWRITEBACK_CACHE NOTE: The NORUN switch cannot be specified for partitioned units. ENABLE_ACCESS_PATH= DISABLE_ACCESS_PATH= Determines which host connections can access the unit. The allowable variables are: •...
Page 52 CLI Command Descriptions Sets the largest number of read blocks to be cached by the controller. The controller will not cache any transfers over the size set. Acceptable values are 0 through 2048. The MAXIMUM_CACHED_TRANSFER switch affects both read and write-back cache when set on a controller that has read and write-back caching.
Page 53 ADD UNITS The controllers only use the PREFERRED_PATH setting if they are in a dual-redundant configuration. If one controller fails, all the devices are accessed through the remaining controller ignoring the PREFERRED_PATH setting. You can specify the PREFERRED_PATH switch for a single controller configuration;...
Page 54 CLI Command Descriptions Enables the controller to keep track of read I/Os. If the controller detects sequential read I/Os from the host, it will then try to keep ahead of the host by reading the next sequential blocks of data (those the host has not yet requested) and putting the data in cache.
Page 55 ADD UNITS • Host-Based Logging NOT Specified Indicates that a SET unit-number WRITE_LOG command has never been entered for the specified unit, or Mini-Merge Logging has been disabled for a previously enabled unit through the SET unit-number NOWRITE_LOG command. • Host Based Logging Specified, NOT Enabled Indicates that a prior SET unit-number WRITE_LOG command has been entered for the specified unit but the controller in a single controller...
Page 56 CLI Command Descriptions WRITEBACK_CACHE NOWRITEBACK_CACHE Enable or disable the write-back data caching function of the controller. The controller write-back caching feature improves write performance. NOTE: NOWRITEBACK_CACHE is the default on transportable disks. WRITEBACK_CACHE is the default on notransportable disks. • Specify WRITEBACK_CACHE for all new RAIDsets, mirrorsets, and units that you want to take advantage of the controller write-back caching feature.
Page 57 ADD UNITS To create unit D5 from mirrorset MIRR1, and to let only two host connections (Server1 and Server2) have access to this unit, enter: ADD UNITS D5 MIRR1 DISABLE_ACCESS_PATH=ALL SET UNITS D5 ENABLE_ACCESS_PATH=(SERVER1,SERVER2) • If the controller pair is in transparent failover mode, this unit is on port 1, and is available only to host connections Server1 and Server2.
Page 58 CLI Command Descriptions CLEAR_ERRORS CLI Stops the display of current or previous error messages at the CLI prompt. Errors are displayed (even after the error condition has been rectified) until the controller is restarted or this command is entered. NOTE: This command does not clear the error condition. The command only stops the CLI from displaying the error.
Page 59 CLEAR_ERRORS controller INVALID_CACHE CLEAR_ERRORS controller INVALID_CACHE Clears an invalid cache error and allows the controller and cache to resume operation. If the error is due to a mirrored-cache configuration that is incorrect, the controller indicates mirrored mode status after the error is cleared. Use this command for the following situations: •...
Page 60 CLI Command Descriptions • Specify NODESTROY_UNFLUSHED_DATA to retain the cached data and discard controller information. The controller metadata synchronizes with the cache module data and preserves any unwritten data for eventual flushing to the disk array. The NODESTROY_UNFLUSHED_DATA parameter is used in the following situations: •...
Page 61: Device-Name
CLEAR_ERRORS device-name UNKNOWN CLEAR_ERRORS device-name UNKNOWN Use this command to force the controller to recognize a failed device, regardless of the controller’s prior evaluation of the device’s condition. A device failure may cause the controller to label the device as unknown. When that happens, the controller does not check the device again to see if it has been repaired or if the error condition has been corrected.
Page 62 CLI Command Descriptions CLEAR_ERRORS unit-number LOST_DATA Clears lost data errors on a unit. All partitions on the unit’s container are affected. The controller reports a lost data error on the unit when you remove a write-back cache module or when the cache module contains unflushed data, possibly due to an interruption in the primary power source with no backup power present.
Page 63 CLEAR_ERRORS unit-number LOST_DATA See Also CLEAR_ERRORS CLI CLEAR_ERRORS INVALID_CACHE CLEAR_ERRORS UNKNOWN CLEAR_ERRORS UNWRITEABLE_DATA HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–47...
Page 64 CLI Command Descriptions CLEAR_ERRORS unit-number UNWRITEABLE_DATA Clears an unwriteable data error on a unit. This command affects all partitions on the same container. If a storageset or disk drive fails before its data has been written to it, the controller reports an unwriteable data error.
Page 65 CLEAR_ERRORS unit-number UNWRITEABLE_DATA See Also CLEAR_ERRORS CLI CLEAR_ERRORS INVALID_CACHE CLEAR_ERRORS LOST_DATA CLEAR_ERRORS UNKNOWN RETRY_ERRORS UNWRITEABLE_DATA HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–49...
Page 66: Nomultibus_Failover
CLI Command Descriptions CONFIGURATION RESET Erases the entire subsystem configuration data file stored in the nonvolatile memory (NVRAM) of “this controller.” IMPORTANT: This command sets the controller to a default configuration and shuts down the controller, disabling communication between host and controller. Enter new configuration information through the SET THIS_CONTROLLER command or the CONFIGURATION RESTORE command to make the controller operational.
Page 67 CONFIGURATION RESET Initiate the CONFIGURATION RESET command from the controller operator control panel (OCP) using the following steps: 1. Push and hold port button #5 and then momentarily press the reset (//) button. 2. Continue holding the port button until the port button #5 LED starts F LASHING 3.
Page 68 CLI Command Descriptions CONFIGURATION RESTORE Copies the subsystem configuration information from the configuration file saved on disk into the NVRAM of “this controller.” This command locates the most recent configuration file created on disk and restores it. This command causes a reboot and takes effect immediately.
Page 69 CONFIGURATION RESTORE Parameters There are no parameters associated with this command. Switches There are no switches associated with this command. Example To restore the subsystem configuration into the memory of the controller in a single-controller subsystem, enter: CONFIGURATION RESTORE See Also CONFIGURATION RESET CONFIGURATION SAVE INITIALIZE...
Page 70 CLI Command Descriptions CONFIGURATION SAVE Forces the controller to copy the subsystem configuration information in its NVRAM memory onto a configuration file on the disk array. This allows you to know exactly when a copy of the configuration is saved. The command takes effect immediately. Use the INITIALIZE container-name SAVE_CONFIGURATION command to set up the location of the configuration file on the specified container and to save the current subsystem configuration.
Page 71 CREATE_PARTITION CREATE_PARTITION Divides a non-transportable disk drive or storageset into several separately addressable storage units. The command marks a specified percentage of a disk drive or storageset to be used as a separately addressable unit—a partition. Any non-transportable disk or storageset can be divided into a maximum of eight partitions, then each partition can be separately presented to the host.
Page 72: Initialize
CLI Command Descriptions Switches The following switch is associated with the CREATE_PARTITION command: • SIZE SIZE=percent SIZE=LARGEST Specifies the size of the partition to be created as a percentage of the total container’s storageset size: • Specify SIZE=percent to create a partition on the specified container that is a percentage of the container’s total capacity.
Page 73 CREATE_PARTITION See Also ADD UNITS DELETE unit-number DESTROY_PARTITION SET unit-number SHOW unit-number HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–57...
Page 74 CLI Command Descriptions DELETE association-set-name Deletes an existing association set. NOTE: This command works only in a DRM environment and requires an HSG80 array controller with ACS version 8.7P code. Like all DRM commands, use of this command is heavily restricted.
Page 75 DELETE concatset-name DELETE concatset-name Deletes an existing concatset. If the concatset is associated with a unit, the unit must be deleted before deleting the concatset. Syntax DELETE concatset-name Parameters concatset-name The name of the concatset to be deleted. Switches There are no switches associated with this command. Examples To delete concatset C1, which is associated with unit D0, enter: DELETE D0...
Page 76 CLI Command Descriptions DELETE connection-name Deletes a specified connection from the table of known connections maintained by the controller, whether or not the host adapter is still physically connected to a controller port. The table of known host connections is maintained in the controller’s memory. Once a connection is added to the table, it stays there, even if the physical connection between host adapter and controller port is severed.
Page 77 DELETE connection-name Examples To delete host connection Server1 from the table of known connections (unless the access path to Server1 is specifically enabled for one or more units), enter: DELETE SERVER1 To delete host connection Server4 from the table of known connections when Server4 has explicit access path to unit D7, enter: SET D7 DISABLE_ACCESS_PATH=SERVER4 DELETE SERVER4...
Page 78 CLI Command Descriptions DELETE container-name Deletes a specified container belonging to the controller configuration. IMPORTANT: A container cannot be deleted if the container is in use by a higher-level container. For example, a disk belonging to a member of a RAIDset, or a RAIDset unit, cannot be deleted.
Page 79 DELETE container-name To delete a RAIDset named RAID9, enter: DELETE RAID9 See Also DELETE FAILEDSET DELETE SPARESETS SHOW STORAGESETS UNMIRROR HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–63...
Page 80 CLI Command Descriptions DELETE FAILEDSETS Removes a disk drive from a failedset. The failedset contains disk drives that were: • Removed by the controller from RAIDsets and mirrorsets because they failed • Manually removed using the SET command (for example, SET mirrorset-name REMOVE=disk-name) Enter the DELETE FAILEDSETS command before physically removing failed members from the storage enclosure for testing, repair, or replacement.
Page 81 DELETE remote-copy-set-name DELETE remote-copy-set-name Deletes a specified remote copy set. Upon completion of this command, the target unit will no longer be a member of the remote copy set. NOTE: This command works only in a DRM environment and requires an HSG80 array controller with ACS version 8.7P code.
Page 82 CLI Command Descriptions DELETE SPARESETS Removes a disk drive from the spareset. The spareset contains disk drives that are available for use, but not yet added to the controller configuration. Syntax DELETE SPARESETS disk-name Parameters disk-name Identifies the disk drive being deleted from the spareset. Remove only one disk at a time from a spareset.
Page 83 DELETE unit-number DELETE unit-number Deletes a unit from the subsystem configuration. The DELETE command causes the flushing of any user data from the write-back cache to the disks and deletes the specified unit. The command deletes the association of the unit with its underlying device, storageset, RAIDset, or partition. The container and any data in it are left intact.
Page 84 CLI Command Descriptions DELETE FAILEDSETS DELETE SPARESETS DESTROY_PARTITION 2–68 HSG80 Array Controller V8.7 Command Line Interface Reference Guide...
Page 85 DESTROY_PARTITION DESTROY_PARTITION Removes a partition from a container. Marks the area reserved for a partition as available. The available area is then consolidated with any adjacent free areas. CAUTION: Data contained on a partition is lost when you enter the DESTROY_PARTITION command.
Page 86 CLI Command Descriptions Example To delete the unit for partition 2 on RAIDset RAID9 and destroy the partition, enter: DELETE D102 DESTROY_PARTITION RAID9 PARTITION=2 If partition 2 of RAID9 has not yet been assigned a unit number, to delete partition 2, enter: DESTROY_PARTITION RAID9 PARTITION=2 See Also...
Page 87 DIRECTORY DIRECTORY Displays a list of the diagnostics and utilities available on “this controller.” Syntax DIRECTORY Parameters There are no parameters associated with this command. Switches There are no switches associated with this command. Example To display a directory listing, enter: DIRECTORY The following is an example of the resultant display: HSUTIL...
Page 88 CLI Command Descriptions EXIT This command is used only to terminate a remote virtual terminal connection. Use of this command exits the CLI program and returns control to the host. Syntax EXIT Parameters There are no parameters associated with this command. Switches There are no switches associated with this command.
Page 89 HELP HELP Displays a brief explanation of how to obtain help on any command or CLI function by using the question mark (?) character. IMPORTANT: A character space must precede the question mark. Syntax HELP Parameters There are no parameters associated with this command. Switches There are no switches associated with this command.
Page 90 CLI Command Descriptions INITIALIZE Initializes metadata on the specified container. During initialization, a small amount of disk space is reserved for metadata that the controller uses to keep track of the array. This metadata is inaccessible to the host. Disks made transportable (using the TRANSPORTABLE switch of the ADD DISKS command) do not contain metadata.
Page 91 INITIALIZE — CAPACITY — CYLINDERS — HEADS — SECTORS_PER_TRACK • CHUNKSIZE • DESTROY and NODESTROY • SAVE_CONFIGURATON and NOSAVE_CONFIGURATION These switches are described in the following paragraphs: CAPACITY=n (1 to the maximum container size in blocks) NOTE: When executing the INITIALIZE command with the switch CAPACITY, it appears that the command did not complete because the SHOW DISKxxxxx command does not display any change to the SIZE.
Page 92 CLI Command Descriptions NOTE: The CHUNKSIZE switch is only valid with stripesets and raidsets. The default chunk size for storagesets with less than or equal to nine members is 256 blocks, or 128 kilobytes (K). The default chunk size for storagesets with more than nine members is 128 blocks or 64K.
Page 93 INITIALIZE SAVE_CONFIGURATION for a multi-device storageset, such as a stripeset, the complete controller configuration information is stored on each disk drive in the storageset. • A disk drive initialized with the SAVE_CONFIGURATION switch specified has slightly less storage space available for user data. •...
Page 94 CLI Command Descriptions Name Type Port Targ Used by --------------------------------------------------------------------------- DISK10000 disk RZ28M (C) DEC 1003 Switches: NOTRANSPORTABLE TRANSFER_RATE_REQUESTED=20MHZ (synchronous 10.00 MHZ negotiated) LOCAL Size: 4108970 blocks Configuration being backed up on this container DISK30300 disk RZ28M (C) DEC 1003 Switches: NOTRANSPORTABLE TRANSFER_RATE_REQUESTED=20MHZ (synchronous 10.00 MHZ negotiated)
Page 95 LOCATE LOCATE Facilitates discovery of the physical location of configured units, storagesets, and devices by F the device fault LED on the front of the storage device. A LASHING LED helps to distinguish between located devices and failed devices. LASHING The LOCATE command causes the device fault LED to function as follows: •...
Page 96 CLI Command Descriptions CANCEL Turns O all device fault LEDs turned O with the LOCATE command. container-name Causes the device fault LEDs on the devices within the container-name to F LASH If a device name is given, the device fault LED F .
Page 97 MIRROR MIRROR Creates a one-member mirrorset from a single disk and names it. NOTE: This command is used only on disks already configured as units or members of a stripeset. Use the ADD MIRRORSETS command to create a mirrorset from disk drives not already members of higher-level containers.
Page 98 CLI Command Descriptions Switches The following switches are available for use with the MIRROR command: • COPY • POLICY and NOPOLICY 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 when data is being mirrored to the storageset’s disk drives: •...
Page 99 MIRROR • Specify NOPOLICY to prevent the controller from automatically replacing a failed disk device. This causes the mirrorset to operate in a reduced state until either POLICY=BEST_PERFORMANCE or POLICY=BEST_FIT is selected, or a member is manually placed in the mirrorset (see SET mirrorset-namepage 2–130).
Page 100 CLI Command Descriptions POWEROFF This command only applies to BA370 enclosure configurations for turning O power to the subsystem enclosure. NOTE: Stop all I/O operations between the hosts and controllers before issuing a POWEROFF command. Syntax POWEROFF Parameters There are no parameters for this command. Switches The following switches are available for use with the POWEROFF command: •...
Page 101: Poweroff
POWEROFF • Specify OVERRIDE_BAD_FLUSH to override a failed cache flush and power the enclosure. • Specify NO_OVERRIDE_BAD_FLUSH to prevent a power O when the cache flush fails. SECONDS=nn When the POWEROFF command is entered, all disk units in the enclosure are set to write-through.
Page 102 CLI Command Descriptions Table 2–2: POWEROFF Switch Settings (Continued) Battery Flush Switch Override Switch Results Action BATTERY_OFF NO_OVERRIDE_BAD_FLUSH Success Controller and units in enclosure shut down and the ECB charger turned O BATTERY_OFF NO_OVERRIDE_BAD_FLUSH Failure Nothing is shut down, the ECB charger remains O , and the user is notified of a bad flush.
Page 103 REDUCE REDUCE Removes member disk drives from mirrorsets and decreases the nominal number of members in the mirrorsets. This command does not put reduced members into the failedset (unlike the SET mirrorset-name REMOVE=disk-name command). When using the REDUCE command to take a snapshot of a striped mirrorset, you must reduce all mirrorsets with one command.
Page 104 CLI Command Descriptions Only normal members can be reduced. A normal member is a mirrorset member whose entire contents are the same as all other normal members within the mirrorset. NOTE: An error is displayed if you attempt to reduce any mirrorset so that there would not be any normal member remaining.
Page 105 REDUCE MIRR1 mirrorset DISK10100 STRIPE1 MIRR2 mirrorset DISK10200 STRIPE1 MIRR3 mirrorset DISK30300 STRIPE1 See Also ADD MIRRORSETS MIRROR RUN CLONE SET mirrorset-name SHOW MIRRORSETS HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–89...
Page 106 CLI Command Descriptions RENAME Renames a specified container or specified host connection. NOTE: Units, remote copy sets, and association sets cannot be renamed. Syntax RENAME old-container-name new-container-name Parameters The following parameters are available to the RENAME command: • old-container-name • new-container-name These parameters are described in the following paragraphs: old-container-name...
Page 107: Restart Controller
RESTART controller RESTART controller Flushes all user data from the write-back cache of the specified controller and restarts the controller. Syntax RESTART controller Parameters controller Identifies which controller is to receive the RESTART command. You must specify THIS_CONTROLLER (the one connected to the CLI maintenance terminal) or OTHER_CONTROLLER.
Page 108: Selftest Controller
CLI Command Descriptions Instructs the controller when to shutdown and whether to flush the write-back cache or not. CAUTION: The IMMEDIATE_SHUTDOWN switch instructs the controller to immediately shutdown without regard to any data contained within write-back cache. Do not perform any hardware changes until the controller flushes the cache. •...
Page 109: Unit-Number
RETRY_ERRORS unit-number UNWRITEABLE_DATA RETRY_ERRORS unit-number UNWRITEABLE_DATA Causes the controller to attempt to write previously unwriteable data from the write-back cache to the specified devices. No data is lost if the retry fails. If a container fails in a way that prevents the data in write-back cache to be written to the container, an unwriteable data error is reported.
Page 110 CLI Command Descriptions Runs the specified diagnostic or utility program on “this controller.” Syntax RUN program-name Parameter program-name The program-name parameter specifies the name of the diagnostic or utility program to be run. The following programs can currently be run: •...
Page 111 • Automatically test all of the disk units configured • Automatically perform thorough tests on all units with write operations enabled The standard mode is more flexible and allows you to: • Test disks you select • Perform tests in read-only mode or write-only mode •...
Page 112 CLI Command Descriptions See Also DIRECTORY 2–96 HSG80 Array Controller V8.7 Command Line Interface Reference Guide...
Page 113: Terminal) Or Other_Controller
SELFTEST SELFTEST Flushes the data from the specified controller write-back cache (if present) and shuts down the controller. It then restarts the controller in looping self-test mode. Press the controller reset (//) button to take the controller out of self-test mode. Syntax SELFTEST controller Parameters...
Page 114: Immediate_Shutdown
CLI Command Descriptions IMMEDIATE_SHUTDOWN NOIMMEDIATE_SHUTDOWN (default) Instructs the controller whether to flush the write-back cache. CAUTION: The IMMEDIATE_SHUTDOWN switch instructs the controller to immediately shut down, without regard to any data contained within write-back cache. Do not perform any hardware changes until the controller flushes the cache. •...
Page 115 SET association-set-name SET association-set-name Changes the characteristics of an association set. NOTE: This command works only in a DRM environment and requires an HSG80 array controller with ACS version 8.7P code. Like all DRM commands, use of this command is heavily restricted.
Page 116 CLI Command Descriptions When FAIL_ALL is specified, all the members of the association set assume the same failsafe lock condition if they are in failsafe error mode. Failsafe lock is enabled by the ERROR_MODE switch of the SET remote-copy-set-name command. If one member of the association set becomes failsafe locked, any association set member that has failsafe lock enabled also becomes failsafe locked.
Page 117 SET association-set-name ORDER_ALL NOORDER_ALL When ORDER_ALL is specified: • If one member of the association set starts logging a history of write operations, all members of the association set start logging write operation history. • The order of all asynchronous write operations across all members of the association set is preserved.
Page 118 CLI Command Descriptions SET concatset-name Expands an existing unit by concatenating another storageset of the same type to the storageset that constitutes the unit. NOTE: The maximum size of a concatset is 1.024TB CAUTION: This command should be done only with host operating systems that can support dynamic volume expansion.
Page 119 SET concatset-name Concatenates the storageset specified by storage-set-name to the concatset. 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 ADD CONCATSETS DELETE concatsets SHOW CONCATSETS HSG80 Array Controller V8.7 Command Line Interface Reference Guide...
Page 120: This Table Is Maintained In The Controller's Memory. The Maximum Table Length Is
CLI Command Descriptions SET connection-name Changes the operating characteristics of a host connection. 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.
Page 121 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.
Page 122 CLI Command Descriptions • Logical unit-number (LUN) = 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. Example set !newcon31 operating_system=vms unit_offset=20 See Also...
Page 123 SET controller SET controller Changes specified switch values on the specified controller. “This controller” indicates the controller that is connected to the maintenance terminal while executing CLI commands. “Other controller” is the controller not connected to the maintenance terminal in dual-redundant controller configurations. NOTE: After doing a SET command to either controller, use a SHOW THIS_CONTROLLER and a SHOW OTHER_CONTROLLER command to verify that the changes went into effect.
Page 124 CLI Command Descriptions Table 2–3: SET controller Switches (Continued) Switch Values 0-EF (hexidecimal); factory PORT_1_AL_PA=n defaults: port 1 is 71 and PORT_2_AL_PA=n port 2 is 72 None PORT_1_TOPOLOGY=FABRIC PORT_2_TOPOLOGY=FABRIC None PORT_1_TOPOLOGY=LOOP_HARD PORT_1_TOPOLOGY=LOOP_SOFT PORT_1_TOPOLOGY=OFFLINE PORT_2_TOPOLOGY=LOOP_HARD PORT_2_TOPOLOGY=LOOP_SOFT PORT_2_TOPOLOGY=OFFLINE 1-16 characters PROMPT=”new prompt” None REMOTE_COPY=node-name NOREMOTE_COPY...
Page 125 SET controller response to the SCSI inquiry command and is the same for all units connected to one or both controllers. The allocation class value allows the host to identify the controllers that are a matched dual-redundant pair. This number should be unique for every pair of dual-redundant controllers in the cluster.
Page 126 CLI Command Descriptions • Select CLI> SET <THIS | OTHER> CONNECTIONS_UNLOCKED to unlock the table. NOTE: The CONNECTIONS_LOCKED and CONNECTIONS_UNLOCKED switch must be typed completely to prevent inadvertently changing the state of the lock. NOTE: The ADD CONNECTIONS command is not affected by the state of the lock. IDENTIFIER=n NOIDENTIFIER IDENTIFIER provides an alternative way (other than worldwide name) for some...
Page 127 SET controller to mirrored mode, going from mirrored mode to nonmirrored mode is permitted with a failed cache module. The controller automatically restarts when this switch is specified. NODE_ID=nnnn-nnnn-nnnn-nnnn xx Sets the subsystem worldwide name (node ID). • nnnn-nnnn-nnnn-nnnn is the node id •...
Page 128 CLI Command Descriptions • Controller A port 2 = node ID + 4 When one of the pair of controllers in a dual redundant configuration is replaced, the remaining controller remembers the node ID. When the replacement controller is installed, the in-place controller tells the node ID to the replacement controller, and the replacement controller automatically assumes the correct port IDs.
Page 129 SET controller Specifies the arbitrated loop physical address (AL-PA) for the host ports (used only in Fibre Channel arbitrated loop (FC-AL) topology). This switch works only when LOOP_HARD is specified for the PORT_1_TOPOLOGY or PORT_2_TOPOLOGY switches. The range of addresses allowed is 0-EF (hexadecimal).
Page 130 CLI Command Descriptions The REMOTE_COPY switch names a controller pair (node) and puts the controller pair into remote copy mode. The node-name can be up to eight characters long. It is suggested that the node-name be something meaningful in the context of the DRM setup, such as the location, that distinguishes one controller pair from another.
Page 131 SET controller TERMINAL_PARITY=ODD TERMINAL_PARITY=EVEN NOTERMINAL_PARITY (default) Specifies the parity with which data is transmitted and received. When changed, the new setting for this switch takes effect immediately. TERMINAL_SPEED=baud-rate TERMINAL_SPEED=9600 (default) Sets the terminal transmission and reception speed (baud rate) to 4800, 9600 (default), or 19200 baud.
Page 132: Controller
CLI Command Descriptions Examples To change the “this controller” CLI prompt, enter: SET THIS_CONTROLLER PROMPT=“TOP” To change the “other controller” CLI prompt, enter: SET OTHER_CONTROLLER PROMPT=“CONTROLLER B” To set the name of the controller pair and put the controller pair in remote copy mode, enter: SET THIS_CONTROLLER REMOTE_COPY=LONDON NOTE: The “other controller”...
Page 133 SET controller SMART Error Drive Eject Enabled example: AP_TOP> show this Controller: HSG80 ZG02804912 Software V87S-0, Hardware NODE_ID = 5000-1FE1-FF00-0090 ALLOCATION_CLASS = 1 SCSI_VERSION = SCSI-3 Configured for MULTIBUS_FAILOVER with ZG02804288 In dual-redundant configuration Device Port SCSI address 7 Time: 22-NOV-2001 01:17:47 Command Console LUN is lun 0 (IDENTIFIER = 99) Host Connection Table is NOT locked Smart Error Eject Enabled...
Page 134 CLI Command Descriptions SET device-name Enables changes to the transfer rate and transportable characteristics of the specified disk drive. Syntax SET device-name Parameter device-name Specifies the name of the device to change, such as disk or passthrough device. Switches The following switches are available to the SET device-name command: •...
Page 135 SET device-name • Specify NOTRANSPORTABLE for all disks used in RAIDsets, stripesets, mirrorsets, and sparesets. • Transportable disks do not contain any metadata or restricted areas on the disk. Therefore, transportable disks forfeit the advantage metadata provides. • Transportable disks can be moved to a non StorageWorks environment with their data intact.
Page 136 CLI Command Descriptions SET EMU Sets operating parameters for the environmental monitoring unit (EMU) in a BA370 enclosure. In subsystems with more than one BA370 enclosure, and therefore more than one EMU, the SET EMU command controls both the master and slave EMU settings. The EMU within the primary (master) enclosure instructs the EMUs within the other enclosures to operate at the same settings as the master EMU.
Page 137 SET EMU • Select FANSPEED=HIGH to force the fans in all connected enclosures to operate at high speed continuously. • Select FANSPEED=AUTOMATIC to allow the EMU to control the fan speed for the fans in all connected enclosures. The EMU instructs the fans to operate at high speed when any of the temperature setpoints are exceeded or when one or more fans are not functioning.
Page 138 CLI Command Descriptions Refer to the enclosure documentation for detailed information about setting the EMU temperature set points. Examples This example shows how to set EMU sensor number 2 to 34°C: SET EMU SENSOR_2_SETPOINT=34 This example shows how to set the EMU fan to operate at high speed: SET EMU FANSPEED=HIGH 2–122 HSG80 Array Controller V8.7 Command Line Interface Reference Guide...
Page 139 SET DISABLE_MANAGERS SET DISABLE_MANAGERS This command provides the capability to revoke management rights from selected host connections. A Manager is a host connection that is allowed to issue CLI commands through a LUN. By default all host connections are enabled as managers.
Page 140: Show Managers
CLI Command Descriptions See Also SET ENABLE_MANAGERS SHOW MANAGERS 2–124 HSG80 Array Controller V8.7 Command Line Interface Reference Guide...
Page 141 SET ENABLE_MANAGERS SET ENABLE_MANAGERS This command provides the capability to define a subset of host connections that have management rights. A Manager is a host connection that is allowed to issue CLI commands through a LUN. By default all host connections are enabled as managers.
Page 142 CLI Command Descriptions SET FAILEDSET Enables changes to the automatic replacement policy for the failedset. Syntax SET FAILEDSET Parameters There are no parameters associated with this command. Switches AUTOSPARE NOAUTOSPARE Specifies the policy to be used by the controller when a disk drive is physically replaced in the failedset.
Page 143 SET FAILEDSET 2. Make the disk transportable. SET DISK10000 TRANSPORTABLE. 3. Initialize the disk. INITIALIZE DISK10000 4. Delete the disk. DELETE DISK10000 5. Add disk to the Spareset or remove disk from the enclosure. Example To enable the automatic spare feature, enter: SET FAILEDSET AUTOSPARE To disable the automatic spare feature, enter: SET FAILEDSET NOAUTOSPARE...
Page 144 CLI Command Descriptions SET FAILOVER COPY=controller Configures both controllers to operate in a dual-redundant configuration under transparent failover mode. This command allows both controllers to access the storage devices, providing controller fault-tolerant data processing. If one of the two controllers fail, the devices and any cache attached to the failed controller become available to and accessible through the other controller.
Page 145 SET FAILOVER COPY=controller Example To set the controllers in transparent failover mode and copy the configuration information from “this controller” to “other controller,” enter: SET FAILOVER COPY=THIS_CONTROLLER See Also SET MULTIBUS_FAILOVER SET NOFAILOVER SET NOMULTIBUS_FAILOVER HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–129...
Page 146 CLI Command Descriptions SET mirrorset-name Changes the characteristics of a mirrorset including the addition and removal of members. Syntax SET mirrorset-name Parameter mirrorset-name Specifies the name of the mirrorset to modify. This is the same name given to the mirrorset when it was created with the ADD MIRRORSETS command. Switches The following switches are available to the SET mirrorset-name command: •...
Page 147 SET mirrorset-name • 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. MEMBERSHIP=number-of-members Sets the nominal number of mirrorset members to the number you specify for the number-of-members value.
Page 148 CLI Command Descriptions READ_SOURCE=disk-name READ_SOURCE=LEAST_BUSY (default) READ_SOURCE=ROUND_ROBIN Selects the mirrorset member used by the controller to satisfy a read request. • Specify the READ_SOURCE=disk-name of a specific member to which you want the controller to direct all read requests. If the member fails out of the mirrorset, the controller selects the first normal member it finds to satisfy its read requests.
Page 149 SET mirrorset-name Instructs the controller to add a disk member to an existing mirrorset if the following conditions are met. • The replacement policy is set to NOPOLICY. • The mirrorset is missing at least one member. If these conditions are met, the disk drive specified by disk-name is added to the mirrorset specified by mirrorset-name.
Page 150 CLI Command Descriptions SET MULTIBUS_FAILOVER Places “this controller” and the “other controller” into multiple-bus failover mode. Failover is a process that allows a controller to take over total control of the storage subsystem in the event of the failure of its companion controller. IMPORTANT: Remove all connections that appear using the SHOW CONNECTIONS command prior to establishing multibus failover mode.
Page 151 SET MULTIBUS_FAILOVER Example This example shows how to configure a controller pair to operate in multiple bus failover mode: SET MULTIBUS_FAILOVER COPY=THIS_CONTROLLER The configuration on “this controller” is automatically copied to the “other controller” when you issue the SET MULTIBUS_FAILOVER command. If you want to prefer specific units to specific controllers, use the following command after setting multiple bus failover: SET D100 PREFERRED_PATH=THIS_CONTROLLER...
Page 152 CLI Command Descriptions SET NOFAILOVER SET NOMULTIBUS_FAILOVER The SET NOFAILOVER and SET NOMULTIBUS_FAILOVER commands remove “this controller” and the “other controller” (if currently reachable) from failover mode. Either command can be used to cancel failover, as they both perform exactly the same actions.
Page 153 SET NOFAILOVER SET NOMULTIBUS_FAILOVER Under some circumstances, the data in a failed controller’s write-back cache may not fail over to the operating controller’s write-back cache. For example, cache data will not failover if the operating controller has a failed cache battery because of the risk of data loss if the power is interrupted.
Page 154 CLI Command Descriptions SET RAIDset-name Changes the characteristics of the specified RAIDset. NOTE: The number and type of disk drives that are used to create the storageset determine the maximum size of the RAIDset. Syntax SET RAIDset-name Parameters RAIDset-name Specifies the name of the RAIDset to modify. This is the name used with the ADD UNITS command to identify the RAIDset as a host-addressable unit.
Page 155 SET RAIDset-name If more than one disk drive in the spareset matches the best performance criteria, the controller selects the smallest 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.
Page 156 CLI Command Descriptions • The replacement policy is set to NOPOLICY. • The disk member is not in any configuration, including a spareset. An error is displayed and the command is rejected if the RAIDset is not in a reduced state, if a replacement policy is already specified, or if the disk specified is already being used by a configuration (including a spareset).
Page 157 SET remote-copy-set-name SET remote-copy-set-name Changes the characteristics of a remote copy set. NOTE: This command works only in a DRM environment and requires an HSG80 array controller with ACS version 8.7P code. Like all DRM commands, use of this command is heavily restricted.
Page 158 CLI Command Descriptions Remote-node-name is the name of the controller pair that controls the unit that is to be added. This name is assigned through the REMOTE_COPY switch of the SET controller command. Target-unit-name is the name of the unit to be added to the remote copy set. ERROR_MODE=FAILSAFE ERROR_MODE=NORMAL (default) Two options are available:...
Page 159 SET remote-copy-set-name • 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.
Page 160 CLI Command Descriptions See Also ADD REMOTE_COPY_SETS SET controller REMOTE_COPY SHOW REMOTE_COPY_SETS SHOW remote-copy-set-name 2–144 HSG80 Array Controller V8.7 Command Line Interface Reference Guide...
Page 161: Unit-Number
SET unit-number SET unit-number Changes the characteristics of the specified logical unit. Syntax SET unit-number Parameters unit-number Specifies the logical unit number to modify. The unit-number is the name given to the unit when it was created using the ADD UNITS command. Switches Table 2–5 lists all switches for the SET unit-number command and shows which switches can be used with each type of device and storageset.
Page 162 CLI Command Descriptions Table 2–5: SET unit-number Switches for Existing Containers (Continued) Switch PREFERRED_PATH NOPREFERRED_PATH READ_CACHE NOREAD_CACHE READAHEAD_CACHE NOREADAHEAD_CACHE NORUN WRITE_LOG NOWRITE_LOG WRITE_PROTECT NOWRITE_PROTECT WRITEBACK_CACHE NOWRITEBACK_CACHE ENABLE_ACCESS_PATH=connection-names ENABLE_ACCESS_PATH=ALL (default) DISABLE_ACCESS_PATH=connection-names DISABLE_ACCESS_PATH=ALL Specifies the access path. It can be a single specific host ID, multiple host IDs, or all host IDs (ALL).
Page 163 SET unit-number CAUTION: If the storage subsystem has more than one host connection, access path must be specified carefully to avoid giving undesirable host connections access to the unit. The default condition is that access paths to all host connections are enabled. To restrict host access to a set of host connections, specify DISABLE_ACCESS_PATH=ALL when the unit is added, then use the SET unit command to specify the set of host connections that are to have access to the unit.
Page 164 CLI Command Descriptions MAXIMUM_CACHED_TRANSFER_SIZE switch affects both read and write-back cache when set on a controller that has read and write-back caching. The use of this switch has the effect of setting both the MAX_READ_CACHED_TRANSFER_SIZE and the MAX_WRITE_CACHED_TRANSFER_SIZE switches. PREFERRED_PATH=OTHER_CONTROLLER PREFERRED_PATH=THIS_CONTROLLER NOPREFERRED_PATH (default) This command is only valid when in MULTIBUS_FAILOVER mode.
Page 165 SET unit-number Read caching improves performance in almost all situations. Therefore, it is recommended that you leave its default setting, READ_CACHE, enabled. However, under certain conditions, such as when performing a backup, read caching may not be necessary because the data will probably not be re-read. In such instances, it may be beneficial to disable the read cache function and remove the processing overhead associated with caching data.
Page 166 CLI Command Descriptions To enable a unit as a Host Based Volume Shadowing shadow set member, a single controller or both controllers of a dual redundant pair must be restarted. During the restart, the additional memory structures required for Host Based Logging are allocated and initialized.
Page 167 SET unit-number WRITE_PROTECT NOWRITE_PROTECT (default) Specifies whether data contained on the selected unit can be overwritten. • Specify WRITE_PROTECT to prevent host write operations to the unit. However, the controller may still write to a write-protected RAIDset to satisfy a reconstruct pass or to reconstruct a newly replaced member. Additionally, metadata, reconstruct, and copy writes are still allowed to RAIDsets and mirrorsets.
Page 168 CLI Command Descriptions Examples To enable write protect and turn off the read cache on unit D102, enter: SET D102 WRITE_PROTECT NOREAD_CACHE To allow only a host connection named Roger1 to access unit D0, enter: SET D0 DISABLE_ACCESS_PATH=ALL SET D0 ENABLE_ACCESS_PATH=ROGER1 See Also ADD UNITS SHOW UNITS...
Page 169 SHOW ASSOCIATIONS SHOW ASSOCIATIONS Displays information on all association sets known to the subsystem. Syntax SHOW ASSOCIATIONS Parameters There are no parameters associated with this command. Switches The following switch is available for the SHOW ASSOCIATIONS command: • FULL Example INT_TOP>...
Page 170 CLI Command Descriptions SHOW association-set-name Displays information on the specified association set. Syntax SHOW association-set-name Parameters association-set-name Specifies the name of the association set to be displayed. Switches There are no switches associated with this command. Example INT_TOP> show A1 Name Association Uses...
Page 171 SHOW CONCATSETS SHOW CONCATSETS Displays information on all concatsets known to the subsystem. Syntax SHOW CONCATSETS Parameters There are no parameters associated with this command. Switches The following switch is available for the SHOW CONCATSETS command: • FULL Example show concatsets Name Storageset Uses...
Page 172 CLI Command Descriptions SHOW concatset-name Displays information on the specified concatset. Syntax SHOW concatset-name Parameters concatset-name Specifies the name of the concatset to be displayed. Switches There are no switches associated with this command. Example BOT> show C1 Name Storageset Uses Used by ------------------------------------------------------------------...
Page 173 SHOW CONNECTIONS SHOW CONNECTIONS Displays the following information for all connections: connection name, operating system, controller, controller port, adapter ID address, online or offline status, and unit offset. <<< LOCKED >>> appears in the title area when the connection table is locked. If unlocked, or not supported (HOST_FC only).
Page 174 CLI Command Descriptions Examples The full switch displays rejected hosts with an index. SMV_Top> sho conn full Connection <<<LOCKED>>> Name Operating Controller Port Address Status Offset System REV50A TRU64_UNIX THIS 011000 OL this HOST_ID=2000-0000-C922-556D ADAPTER_ID=1000-0000-C922-556D REV50B TRU64_UNIX OTHER 031000 OL other HOST_ID=2000-0000-C921-0919 ADAPTER_ID=1000-0000-C921-0919 Rejected connections:...
Page 175 SHOW connection-name SHOW connection-name Displays the following information for the specified connection-name: operating system, controller, controller port, adapter ID address, online or offline status, and unit offset. Syntax SHOW connection-name Parameters connection-name Specifies the name of the connection to be displayed. Switches There are no switches associated with this command.
Page 176: Show Controller
CLI Command Descriptions SHOW controller Displays information about the specified controller. Syntax SHOW controller Parameters controller Identifies which controller is displayed. Specify THIS_CONTROLLER (the one connected to the CLI maintenance terminal) or OTHER_CONTROLLER. Switches The following switch is available for the SHOW controller command: •...
Page 177 SHOW controller Cache: 32 megabyte write cache, version 0012 Cache is GOOD Unflushed data in cache CACHE_FLUSH_TIMER = DEFAULT (10 seconds) Mirrored Cache: 32 megabyte write cache, version 0012 Cache is GOOD Unflushed data in cache Battery: NOUPS FULLY CHARGED Expires: 04-DEC-2002 Extended information:...
Page 178: Show Devices
CLI Command Descriptions SHOW DEVICES Displays information about all devices known to the subsystem. Syntax SHOW DEVICES Parameters There are no parameters associated with this command. Switches The following switch is available for the SHOW DEVICES command: • FULL Example BOT>...
Page 179: Show Disks
SHOW DISKS SHOW DISKS Displays information about all disks known to the subsystem. Syntax SHOW DISKS Parameters There are no parameters associated with this command. Switches The following switch is available for the SHOW DISK command: • FULL Example BOT> show disks Name Type Port Targ...
Page 180: Show Disk-Name
CLI Command Descriptions SHOW disk-name Displays information about the specified disks. Syntax SHOW disk-name Parameters disk-name Specifies the name of the association set to be displayed. Switches There are no switches associated with this command. Example BOT> show DISK10000 Name Type Port Targ Used by...
Page 181: Show Emu
SHOW EMU SHOW EMU Displays information regarding the status of the environmental monitoring unit. Syntax SHOW EMU Parameters There are no parameters associated with this command. Switches The following switch is available for the SHOW EMU command: • FULL HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–165...
Page 182 CLI Command Descriptions SHOW FAILEDSETS Displays a list of devices in the failedset. Syntax SHOW FAILEDSETS Parameters There are no parameters associated with this command. Switches There are no switches associated with this command. Example BOT> show failedset Name Storageset Uses Used by ------------------------------------------------------------------...
Page 183: Show Id
SHOW ID SHOW ID Displays a sorted list of any unit associated with an ID. If no units are associated with an ID, the informational message “No Units with Identifiers” is displayed. Syntax SHOW ID Parameters There are no parameters associated with this command. Switches There are no switches associated with this command.
Page 184 CLI Command Descriptions SHOW MANAGERS Displays a list of host connections with management rights. A Manager is a host connection that is allowed to issue CLI commands through a LUN. By default all host connections are enabled as managers. Status as a Manager has no effect on CLI commands issued through the Maintenance Port of the HSG80.
Page 185 SHOW MANAGERS See Also SET ENABLE_MANAGERS SET DISABLE_MANAGERS HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–169...
Page 186 CLI Command Descriptions SHOW MIRRORSETS Displays information about all mirrorsets known to the subsystem. Syntax SHOW MIRRORSETS Parameters There are no parameters associated with this command. Switches The following switch is available for the SHOW MIRRORSETS command: • FULL Example BOT>...
Page 187 SHOW mirrorset-name SHOW mirrorset-name Displays information about the specified mirrorset. Syntax SHOW mirrorset-name Parameters mirrorset-name Specifies the name of the mirrorset to be displayed. Switches There are no switches associated with this command. HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–171...
Page 188 CLI Command Descriptions Example BOT> show M1 Name Storageset Uses Used by ------------------------------------------------------------------ mirrorset DISK10000 DISK20000 DISK20400 Switches: POLICY (for replacement) = BEST_PERFORMANCE COPY (priority) = NORMAL READ_SOURCE = LEAST_BUSY MEMBERSHIP = 3, 3 members present State: RECONSTRUCTING DISK20000 (member 0) is NORMAL DISK20400 (member 1) is NORMAL...
Page 189 SHOW PASSTHROUGH SHOW PASSTHROUGH Displays information about all passthrough devices known to the subsystem. Syntax SHOW PASSTHROUGH Parameters There are no parameters associated with this command. Switches The following switch is available for the SHOW PASSTHROUGH command: • FULL See Also ADD PASSTHROUGH DELETE container-name HSG80 Array Controller V8.7 Command Line Interface Reference Guide...
Page 190 CLI Command Descriptions SHOW RAIDSETS Displays information about all RAIDsets known to the subsystem. Syntax SHOW RAIDSETS Parameters There are no parameters associated with this command. Switches The following switch is available for the SHOW RAIDSETS command: • FULL Example BOT>...
Page 191 SHOW RAIDSETS See Also ADD RAIDSETS DELETE container-name SET RAIDset-name SHOW RAIDset-name HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–175...
Page 192 CLI Command Descriptions SHOW raidset-name Displays information about the specified RAIDset. Syntax SHOW raidset-name Parameters raidset-name Specifies the name of the RAIDset to be displayed. Switches There are no switches associated with this command. Example BOT> show R0 Name Storageset Uses Used by ------------------------------------------------------------------...
Page 193 SHOW raidset-name See Also ADD RAIDSETS DELETE container-name SET RAIDset-name SHOW RAIDSETS HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–177...
Page 194 CLI Command Descriptions SHOW REMOTE_COPY_SETS Displays information on all remote copy sets known to the subsystem. Syntax SHOW REMOTE_COPY_SETS Parameters There are no parameters associated with this command. Switches The following switch is available for the SHOW REMOTE_COPY_SETS command: • FULL Example INT_TOP>...
Page 195 SHOW remote-copy-set-name SHOW remote-copy-set-name Displays information on the specified remote copy set. Syntax SHOW remote-copy-set-name Parameters remote-copy-set-name Specifies the name of the remote copy set to be displayed. Switches There are no switches associated with this command. Example INT_TOP> show RCS1 Name Uses Used by...
Page 196 CLI Command Descriptions See Also ADD ASSOCIATIONS ADD REMOTE_COPY_SETS DELETE remote-copy-set-name SET remote-copy-set-name SHOW ASSOCIATIONS SHOW controller SHOW REMOTE_COPY_SETS 2–180 HSG80 Array Controller V8.7 Command Line Interface Reference Guide...
Page 197 SHOW SPARESETS SHOW SPARESETS Displays infomration on all devices in the spareset. Syntax SHOW SPARESETS Parameters There are no parameters associated with this command. Switches There are no switches associated with this command. Example BOT> show spareset Name Storageset Uses Used by ------------------------------------------------------------------ SPARESET...
Page 198 CLI Command Descriptions SHOW STORAGESETS Specifies the name of a particular storageset to be displayed. For example, SHOW STRIPE1 displays information about the stripeset named STRIPE1. Specifies the type of storageset to be displayed. Valid types include: • CONCATSETS—Shows all concatsets configured to the controller. •...
Page 199 SHOW STORAGESETS Example show storagesets Name Storageset Uses Used by ------------------------------------------------------------------ stripeset mirrorset DISK10000 DISK20000 DISK20400 mirrorset DISK10100 DISK20100 DISK30100 SPARESET spareset FAILEDSET failedset See Also ADD DISKS ADD MIRRORSETS ADD RAIDSETS DELETE container-name SHOW DISKS SHOW MIRRORSETS SHOW RAIDSETS SHOW UNITS HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–183...
Page 200 CLI Command Descriptions SHOW STRIPESETS Displays information about all stripesets known to the subsystem. Syntax SHOW STRIPESETS Parameters There are no parameters associated with this command. Switches The following switch is available for the SHOW STRIPESETS command: • FULL Example BOT>...
Page 201 SHOW stripeset-name SHOW stripeset-name Displays information about the specified stripeset. Syntax SHOW stripeset-name Parameters stripeset-name Specifies the name of the stripeset to be displayed. Switches There are no switches associated with this command. Example BOT> show S1 Name Storageset Uses Used by ------------------------------------------------------------------ stripeset...
Page 202 CLI Command Descriptions SHOW UNITS Displays information for all units known to the subsystem. Syntax SHOW UNITS Parameters There are no parameters associated with this command. Switches The following switch is available for the SHOW UNITS command: • FULL Example BOT>...
Page 203 SHOW unit-number SHOW unit-number Displays information about the specified unit. Syntax SHOW unit-number Parameters unit-number Specifies the unit to be displayed. Switches There are no switches associated with this command. HSG80 Array Controller V8.7 Command Line Interface Reference Guide 2–187...
Page 204 CLI Command Descriptions Example BOT> show D0 Uses Used by ------------------------------------------------------------------ LUN ID: 6000-1FE1-000F-E500-0001-8080-0475-0005 NOIDENTIFIER Switches: NOWRITE_PROTECT READ_CACHE READAHEAD_CACHE WRITEBACK_CACHE MAX_READ_CACHED_TRANSFER_SIZE = 32 MAX_WRITE_CACHED_TRANSFER_SIZE = 32 Access: State: ONLINE to this controller Not reserved NOPREFERRED_PATH Host Based Logging NOT Specified Size: 35529666 blocks Geometry (C/H/S): (10512 / 20 / 169)
Page 205: Shutdown Controller
SHUTDOWN controller SHUTDOWN controller Flushes all user data from the write-back cache (if present) of the specified controller and shuts down the controller. The controller does not automatically restart. All units accessed through the failed controller failover to the surviving controller. Syntax SHUTDOWN controller Parameter...
Page 206 CLI Command Descriptions IMMEDIATE_SHUTDOWN NOIMMEDIATE_SHUTDOWN (default) Instructs the controller when to shutdown. CAUTION: The IMMEDIATE_SHUTDOWN switch causes the controller to keep unflushed data in the write-back cache until it restarts and is able to write the data to devices. Do not perform any hardware changes until the controller flushes the cache. •...
Page 207 SITE_FAILOVER SITE_FAILOVER Performs the site failover function in the event the original initiator site is not operational. NOTE: This command works only in a DRM environment and requires an HSG80 array controller with ACS version 8.7P code. Use of this command is heavily restricted. Refer to the StorageWorks by Compaq Data Replication Manager HSG80 ACS Version 8.7P Operations Guide for an explanation and examples of usage.
Page 208 CLI Command Descriptions UNMIRROR Converts a one-member mirrorset back to a nonmirrored disk drive and deletes the mirrorset from the list of known mirrorsets. This command can only be used on mirrorsets already members of higher-level containers (stripesets or units). The UNMIRROR command is not valid for disk drives having a capacity greater than the capacity of the existing mirrorset.
Page 209 Glossary This glossary defines terms used in this guide or related to this product and is not a comprehensive glossary of computer terms. Array Controller Software. The software component of the HS-series array controller storage systems. ACS executes on the controller and processes input/output requests from the host, performing the device-level operations required to satisfy the requests.
Page 210 Glossary array controller software See ACS association set A group of remote copy sets that share selectable attributes for logging and failover. Members of an association set transition to the same state simultaneously. For example, if one association set member assumes the failsafe locked condition, then other members of the association set also assume the failsafe locked condition.
Page 211 Glossary BIST Built-in self-test. A diagnostic test performed by the array controller software on the controller’s policy processor. A single binary digit having a value of either 0 or 1. A bit is the smallest unit of data a computer can process. block A number of consecutive bytes of data stored on a storage device.
Page 212 Glossary chunk size The number of data blocks, assigned by a system administrator, written to the primary RAIDset or stripeset member before the remaining data blocks are written to the next RAIDset or stripeset member. CI bus Computer Interconnect bus. A serial 70 MHz, dual path, party-line, bus. It is the host bus for the HSJ-series controller-based storage systems.
Page 213 Glossary container Any entity that is capable of storing data, whether it is a physical device or a group of physical devices. (2) A virtual, internal controller structure representing either a single disk or a group of disk drives linked as a storageset. Stripesets and mirrorsets are examples of storageset containers that the controller uses to create units.
Page 214 Glossary Dual data link. The ability to operate on the CI bus using both paths simultaneously to the same remote node. device In its physical form, a magnetic disk that can be attached to a SCSI bus. The term is also used to indicate a physical device that has been made part of a controller configuration;...
Page 215 Glossary Direct Memory Access. DWZZA-on-a-chip. An SYM53C120 SCSI bus extender chip used to connect a SCSI bus in one enclosure to the corresponding SCSI bus in another enclosure. driver A hardware device or a program that controls or regulates another device. For example, a device driver is a driver developed for a specific device that allows a computer to operate with the device, such as a printer or a disk drive.
Page 216 Glossary External Cache Battery. The unit that supplies backup power to the cache module in the event the primary power source fails or is interrupted. Electronic Industries Association. EIA is a standards organization specializing in the electrical and functional characteristics of interface equipment. Environmental Monitoring Unit.
Page 217 Glossary failedset A group of disk drives that have been removed from RAIDsets due to a failure or a manual removal. Disk drives in the failedset should be considered defective and should be tested and repaired before being placed back into the spareset. See also spareset. failover The process that takes place when one controller in a dual-redundant configuration assumes the workload of a failed companion controller.
Page 218 Glossary FC–LE Fibre Channel Link Encapsulation (ISO 8802.2). The mapping of SCSI-3 operations to Fibre Channel. FC–PH specification The Fibre Channel Physical and Signaling standard. FC–SB Fibre Channel Single Byte Command Code Set. FC–SW Fibre Channel Switched Topology and Switch Controls. FD SCSI The fast, narrow, differential SCSI bus with an 8-bit data transfer rate of 10 MB/s.
Page 219 Glossary forced errors A data bit indicating that a corresponding logical data block contains unrecoverable data. frame An invisible unit used to transfer information in Fibre Channel. Field Replaceable Unit. A hardware component that can be replaced at a customer location by StorageWorks authorized service providers.
Page 220 Glossary half-duplex (adj) Pertaining to a communications system in which data can be either transmitted or received but only in one direction at one time. hard address The AL_PA which an NL_Port attempts to acquire during loop initialization. heterogeneous host support Also called noncooperating host support.
Page 221 Glossary HSUTIL Format and Device Code Load Utility. Refers to input and output functions. I/O driver The set of code in the kernel that handles the physical I/O to a device. This is implemented as a fork process. Also called driver. I/O interface See interface I/O module...
Page 222 Glossary IPI-3 Tape Intelligent Peripheral Interface Level 3 for Tape. JBOD Just a bunch of disks. A term used to describe a group of single-device logical units not configured into any other container type. kernel The most privileged processor access mode. L_Port A node or fabric port capable of performing Arbitrated Loop functions and protocols.
Page 223 Glossary loop See arbitrated loop. loop tenancy The period of time between the following events: when a port wins loop arbitration and when the port returns to a monitoring state. Loop_ID A 7-bit value numbered contiguously from zero to 126-decimal and represent the 127 legal AL_PA values on a loop (not all of the 256 hex values are allowed as AL_PA values per FC-AL).
Page 224: Multibus_Failover
Glossary metadata The data written to a disk for the purposes of controller administration. Metadata improves error detection and media defect management for the disk drive. It is also used to support storageset configuration and partitioning. Non transportable disks also contain metadata to indicate they are uniquely configured for StorageWorks environments.
Page 225 Glossary nominal membership The desired number of mirrorset members when the mirrorset is fully populated with active devices. If a member is removed from a mirrorset, the actual number of members may fall below the “nominal” membership. Non-L_Port A node of fabric port that is not capable of performing the Arbitrated Loop functions and protocols.
Page 226 Glossary other controller The controller in a dual-redundant pair that is connected to the controller serving your current CLI session. See also “this controller.” outbound fiber One fiber in a link that carries information away from a port. parallel data transmission A data communication technique in which more than one code element (for example, bit) of each byte is sent or received simultaneously.
Page 227 Glossary peripheral device Any unit, distinct from the CPU and physical memory, that can provide the system with input or accept any output from it. Terminals, printers, tape drives, and disks are peripheral devices. pluggable A replacement method that allows the complete system to remain online during device removal or insertion.
Page 228 Glossary Port-Target-LUN. The controller method of locating a device on the controller device bus. public NL_Port An NL_Port that attempts login with the fabric and can observe the rules of either public or private loop behavior. A public NL_Port may communicate with both private and public NL_Ports.
Page 229 Glossary RAID level 3/5 A specially developed RAID storageset that stripes data and parity across three or more members in a disk array. A RAIDset combines the best characteristics of RAID level 3 and RAID level 5. A RAIDset is the best choice for most applications with small to medium I/O requests, unless the application is write intensive.
Page 230 Glossary regeneration (1) The process of calculating missing data from redundant data. (2) The process of recreating a portion of the data from a failing or failed drive using the data and parity information from the other members within the storageset. The regeneration of an entire RAIDset member is called reconstruction.
Page 231 Glossary SCSI bus signal converter (1) A device used to interface between the subsystem and a peripheral device unable to be mounted directly into the SBB shelf of the subsystem. (2) A device used to connect a differential SCSI bus to a single-ended SCSI bus. (3) A device used to extend the length of a differential or single-ended SCSI bus.
Page 232 Glossary service rate The rate at which an entity is able to service requests. For example, the rate at which an Arbitrated Loop is able to service arbitrated requests. signal converter See SCSI bus signal converter single ended I/O module A 16-bit I/O module.
Page 233 Glossary storageset (1) A group of devices configured with RAID techniques to operate as a single container. (2) Any collection of containers, such as stripesets, mirrorsets, striped mirrorsets, and RAIDsets. storageset expansion The dynamic expansion of the storage capacity (size) of a unit. A storage container is created in the form of a concatenation set which is added to the existing storage set defined as a unit.
Page 234 Glossary synchronous Pertaining to a method of data transmission which allows each event to operate in relation to a timing signal. See also asynchronous. tape A storage device supporting sequential access to variable sized data records. target (1) A SCSI device that performs an operation requested by an initiator. (2) Designates the target identification (ID) number of the device.
Page 235 Glossary ULP process A function executing within a Fibre Channel node which conforms to the ULP requirements when interacting with other ULP processes. Ultra SCSI bus A Fast-20 SCSI bus. See also Wide Ultra SCSI. uninterruptible power supply See UPS unit A container made accessible to a host.
Page 236 Glossary worldwide name A unique 64-bit number assigned to a subsystem by the Institute of Electrical and Electronics Engineers (IEEE) and set by DIGITAL manufacturing prior to shipping. Also called node ID within the CLI. write hole The period of time in a RAID level 1 or RAID level 5 write operation when an opportunity emerges for undetectable RAIDset data corruption.
Page 237 Index UNIT_OFFSET 2–9 syntax 2–6 ADAPTER_ID, parameter for ADD ADD DISKS CONNECTIONS 2–7 command parameters 2–12 ADD ASSOCIATIONS description 2–12 command parameters 2–2 parameters description 2–2 disk-name 2–12 parameters scsi-port-target-lun 2–12 association-set-name 2–2 related commands remote-copy-set-name 2–2 ADD PASSTHROUGH 2–14 syntax 2–2 ADD UNITS 2–14 ADD CONCATSETS...
Page 238 Index DELETE container-name 2–17 SHOW RAIDset-name 2–23 INITIALIZE 2–17 SHOW RAIDSETS 2–23 MIRROR 2–17 STORAGESETS 2–23 REDUCE 2–17 switches SHOW mirrorset-name 2–17 NOPOLICY 2–21 SHOW MIRRORSETS 2–17 NOREDUCED 2–22 SHOW STORAGESETS 2–17 POLICY 2–21 UNMIRROR 2–17 RECONSTRUCT 2–21 switches REDUCED 2–22 COPY 2–16 syntax 2–20 NOPOLICY 2–16...
Page 239 Index command parameters 2–29 NOPREFERRED_PATH 2–36 description 2–29 NOREAD_CACHE 2–37 parameter, disk-name 2–29 NOREADAHEAD_CACHE 2–37 related commands NORUN 2–38 DELETE SPARESETS 2–29 NOWRITE_PROTECT 2–39 SHOW SPARESETS 2–29 NOWRITEBACK_CACHE 2–40 STORAGESETS 2–29 PARTITION 2–36 syntax 2–29 PREFERRED_PATH 2–36 ADD STRIPESETS READ_CACHE 2–37 command parameters 2–30 READAHEAD_CACHE 2–37 descriptions 2–30...
Page 240 Index description 2–45 parameters, device-name 2–45 BATTERY_OFF, switch for POWEROFF 2–84 related commands, CLEAR_ERRORS BATTERY_ON, switch for POWEROFF 2–84 CLI 2–45 button names, convention defined v INVALID_CACHE 2–45 UNWRITEABLE_DATA 2–45 CACHE_FLUSH_TIMER, switch for SET syntax 2–45 controller 2–109 CLEAR_ERRORS unit-number LOST_DATA CANCEL, parameter for LOCATE 2–80 command parameters 2–46 CAPACITY, switch for...
Page 241 Index rules for entering 1–6 FAILEDSETS 2–64 selective presentation 1–3 remote-copy-set-name 2–65 shortcuts 1–6 SPARESETS 2–66 storagesets 1–4 unit-number 2–67 syntax 1–7 DESTROY_PARTITION 2–69 transparent failover 1–2 DIRECTORY 2–71 definition 1–1 EXIT 2–72 overview 1–1 HELP 2–73 program termination 2–72 INITIALIZE 2–74 prompt, changing display appearance 1–8 LOCATE 2–79...
Page 242 Index SHOW connection-name 2–159 CONCATSETS SHOW CONNECTIONS 2–157 description 2–156 SHOW controller 2–160 concatsets, showing 2–182 SHOW DEVICES 2–162 CONFIG, running 2–94 SHOW disk-name 2–164 configuration SHOW DISKS 2–163 modifying controller configurations SHOW EMU 2–165 resetting 2–50 SHOW FAILEDSETS 2–166 restoring 2–52 2–76 SHOW ID 2–167...
Page 243 Index DESTROY_PARTITION 2–69 MULTIBUS_FAILOVER 2–134 INITIALIZE 2–74 CREATE_PARTITION LOCATE 2–80 command parameters 2–55 containers, naming a description 2–55 disk drive 2–12 parameter, container-name 2–55 passthrough device 2–18 related commands unit 2–34 ADD UNITS 2–57 controller DELETE unit-number 2–57 behavior at shutdown 2–190 DESTROY PARTITION 2–57 error handling at shutdown 2–189 SET unit-number 2–57...
Page 244 Index description 2–59 command parameters 2–66 parameter, concatset-name 2–59 description 2–66 related commands parameter, disk-name 2–66 DELETE unit-number 2–59 related commands SET concatsets 2–59 ADD SPARESETS 2–66 syntax 2–59 SHOW SPARESETS 2–66 DELETE connection-name syntax 2–66 command parameters 2–60 DELETE unit-number description 2–60 command parameters 2–67 parameter, connection-name 2–60...
Page 245 Index DESTROY_UNFLUSHABLE_DATA, switch SPARESETS 2–29 DELETE FAILEDSETS 2–64 SET NOFAILOVER 2–136 DELETE SPARESETS 2–66 SET NOMULTIBUS_FAILOVER 2–136 MIRROR 2–81 device-name, parameter for REDUCE 2–88 CLEAR_ERRORS device-name UNMIRROR 2–192 UNKNOWN 2–45 DISKS SET device-name 2–118 parameter for LOCATE 2–80 devices document locating 2–79 conventions v setting data transfer rate 2–13...
Page 246 Index syntax 2–73 help, obtaining vii FAIL_ALL, switch for SET association-set-name HOST_ID, parameter for ADD CONNECTIONS 2–99 2–7 failedsets, deleting members 2–64 hot surface, symbol and definition vi failedsets, showing 2–182 HSUTIL, running 2–95 FANSPEED, switch for SET EMU 2–120 file names, convention defined v finding devices and storagesets 2–79 IDENTIFIER, switch for...
Page 247 Index CAPACITY 2–75 SET unit-number 2–147 CYLINDERS 2–75 MAXIMUM_CACHED_TRANSFER_SIZE, HEADS 2–75 switch for SECTORS_PER_TRACK 2–75 ADD UNITS 2–36 NODESTROY 2–76 SET unit-number 2–147 NOSAVE_CONFIGURATION 2–76 MEMBERSHIP, switch for SET mirrorset-name SAVE_CONFIGURATION 2–76 2–131 syntax 2–74 menu INITIATOR, switch for SET items, convention defined v remote-copy-set-name 2–142 sequences, convention defined v...
Page 248 Index unmirroring 2–192 NOPOLICY, switch for multibus failover mode. See SET ADD MIRRORSETS 2–16 MULTIBUS_FAILOVER. ADD RAIDSETS 2–21 multiple power source, symbol and definition vi MIRROR 2–82 SET mirrorset-name 2–131 SET RAIDset-name 2–138 network interface connection, symbol and NOPREFERRED_PATH, switch for definition vi ADD UNITS 2–36 new-container-name, parameter for RENAME...
Page 249 Index disk-name 2–20 RAIDset-name 2–20 old-container-name, parameter for RENAME ADD REMOTE_COPY_SETS 2–90 initiator-unit-name 2–24 OPERATING_SYSTEM, switch for remote-copy-set-name 2–24 ADD CONNECTIONS 2–8 remote-node-name\target-unit-name SET connection-name 2–105 2–25 OPERATION_MODE, switch for ADD SNAPSHOT_UNITS ADD REMOTE_COPY_SETS 2–25 snapshot-unit 2–27 SET remote-copy-set-name 2–142 source-unit 2–28 ORDER_ALL, switch for SET storageset-name 2–27...
Page 250 Index CREATE_PARTITION, container-name RAIDset-name 2–20 2–138 2–55 REDUCE, disk-name 2–88 data-retention-policy 2–43 REJECTED_HOST 2–8 DELETE remote-copy-set-name 2–2 2–24 2–65 associations, association-set-name 2–58 2–141 2–191 concatsets, concatset-name 2–59 remote-node-name 2–191 connection-name, connection-name 2–60 remote-node-name\target-unit-name 2–25 container-name, container-name 2–62 RENAME FAILEDSETS, disk-name 2–64 new-container-name 2–90 remote-copy-set-name old-container-name 2–90...
Page 251 Index PARTITION, switch for ADD UNITS 2–36 ADD UNITS 2–36 partitioned container, initializing 2–74 SET unit-number 2–148 partition-number, parameter for program-name, parameter for RUN 2–94 DESTROY_PARTITION 2–69 prompt, CLI. See CLI prompt. 1–8 partitions PROMPT, switch for SET controller 2–113 creating 2–55 ptl, parameter for LOCATE 2–80 general commands 1–4...
Page 252 Index SET unit-number 2–149 old-container-name 2–90 recall and edit command keys (table) 1–7 syntax 2–90 RECONSTRUCT, switch for renaming 2–90 ADD RAIDSETS 2–21 REPLACE, switch for SET RAIDset-name 2–139 SET mirrorset-name 2–132 REDUCE SET RAIDset-name 2–139 command parameters 2–88 RESERVATION_STYLE, switch for description 2–87 ADD CONNECTIONS 2–9 parameter, disk-name 2–88...
Page 253 Index CLCP 2–94 syntax 2–97 CLI 2–94 SENSOR_n_SETPOINT, switch for SET EMU CLONE 2–94 2–121 CLONEW 2–94 SET association-set-name CONFIG 2–94 command parameters 2–99 DILX 2–94 description 2–99 DIRECT 2–95 parameter, association-set-name 2–99 DSTAT 2–95 related commands FMU 2–95 ADD ASSOCIATIONS 2–101 FRUTIL 2–95 ADD REMOTE_COPY_SET 2–101 HSUTIL 2–95...
Page 254 Index UNIT_OFFSET 2–105 switches syntax 2–104 NOTRANSPORTABLE 2–118 SET controller TRANSFER_RATE_REQUESTED command parameters 2–107 2–118 description 2–107 TRANSPORTABLE 2–118 parameter, controller 2–107 syntax 2–118 related commands SET DISABLE_MANAGERS ADD REMOTE_COPY_SETS 2–117 description 2–123 SET remote-copy-set-name 2–117 SET EMU SHOW controller 2–117 description 2–120 switches related command, SHOW 2–123...
Page 255 Index MIRROR 2–133 description 2–138 REDUCE 2–133 parameter, RAIDset-name 2–138 SHOW MIRRORSET 2–133 related commands UNMIRROR 2–133 ADD RAIDSETS 2–140 switches SHOW RAIDSETS 2–140 COPY 2–130 switches MEMBERSHIP 2–131 NOPOLICY 2–138 NOPOLICY 2–131 POLICY 2–138 POLICY 2–131 RECONSTRUCT 2–139 READ_SOURCE 2–132 REMOVE 2–139 REMOVE 2–132 REPLACE 2–139...
Page 256 Index MAXIMUM_CACHED_TRANSFER_ mirrorset members 2–131 SIZE 2–147 unit partitions 2–36 NOIDENTIFIER 2–147 number of blocks cached by controller 2–36 NOPREFERRED_PATH 2–148 2–147 NOREAD_CACHE 2–148 partition size 2–43 2–56 NOREADAHEAD_CACHE 2–149 RAIDsets NORUN 2–149 member reconstruct policy 2–21 2–139 NOWRITE_LOG 2–149 member replacement policy 2–16 2–21 NOWRITE_PROTECT 2–151...
Page 257 Index description 2–157 description 2–171 switch, FULL 2–157 SHOW MIRRORSETS syntax 2–157 description 2–170 SHOW controller switch, FULL 2–170 syntax 2–160 syntax 2–170 SHOW controller SHOW PASSTHROUGH command parameters 2–160 description 2–173 description 2–160 switch, FULL 2–173 switch, FULL 2–160 syntax 2–173 SHOW DEVICES SHOW raidset-name...
Page 258 Index description 2–184 showing 2–182 switch, FULL 2–184 storageset expansion. See ADD CONCATSETS. syntax 2–184 2–4 SHOW UNIT storageset-name, parameter for description 2–186 ADD CONCATSETS 2–4 switch, FULL 2–186 ADD SNAPSHOT_UNITS 2–27 SHOW unit-name storagesets description 2–187 general commands 1–4 SHOW unit-number initializing 2–74 syntax 2–187...
Page 259 Index TRANSFER_RATE_REQUESTED CHUNKSIZE= 2–75 2–19 COMMAND_CONSOLE_LUN 2–109 ADD RAIDSETS CONNECTIONS_LOCKED 2–109 NOPOLICY 2–21 CONNECTIONS_UNLOCKED 2–109 NOREDUCED 2–22 COPY= 2–16 2–82 2–130 POLICY 2–21 CREATE_PARTITION RECONSTRUCT 2–21 SIZE 2–56 REDUCED 2–22 CYLINDERS= 2–75 ADD REMOTE_COPY_SETS DESTROY 2–76 OPERATION_MODE 2–25 DISABLE_ACCESS_PATH= 2–34 2–146 OUTSTANDING_IO 2–25 DISABLE_MANAGERS= 2–125...
Page 260 Index MIRROR POWEROFF COPY 2–82 BATTERY_OFF 2–84 NOPOLICY 2–82 BATTERY_ON 2–84 POLICY 2–82 NO_OVERRIDE_BAD_FLUSH 2–84 MIRRORED_CACHE 2–110 OVERRIDE_BAD_FLUSH 2–84 NO_OVERRIDE_BAD_FLUSH 2–84 SECONDS 2–85 NOCOMMAND_CONSOLE_LUN 2–109 PREFERRED_PATH= 2–34 2–148 NODE_ID= 2–111 PROMPT= 2–113 NODESTROY 2–76 READ_CACHE 2–34 2–148 NOFAIL_ALL 2–99 READ_SOURCE= 2–16 2–132 NOIDENTIFIER 2–110 READAHEAD_CACHE 2–34...
Page 261 Index SET connection-name MEMBERSHIP 2–131 OPERATING_SYSTEM 2–105 NOPOLICY 2–131 RESERVATION_STYLE 2–105 POLICY 2–131 UNIT_OFFSET 2–105 READ_SOURCE 2–132 SET controller REMOVE 2–132 ALLOCATION_CLASS 2–108 REPLACE 2–132 CACHE_FLUSH_TIMER 2–109 SET MULTIBUS_FAILOVER, COPY COMMAND_CONSOLE_LUN 2–109 2–134 IDENTIFIER 2–110 SET NOFAILOVER MIRRORED_CACHE 2–110 DESTROY_UNFLUSHABLE_DATA NOCOMMAND_CONSOLE_LUN 2–136 2–109...
Page 262 Index MAXIMUM_CACHED_TRANSFER_ TIME= 2–115 SIZE 2–147 TRANSFER_RATE_REQUESTED= 2–13 NOIDENTIFIER 2–147 2–19 2–118 NOPREFERRED_PATH 2–148 TRANSPORTABLE 2–13 2–118 NOREAD_CACHE 2–148 UNIT_OFFSET. (See also SET NOREADAHEAD_CACHE 2–149 connection-name 2–105 NORUN 2–149 UNIT_OFFSET=. See also ADD NOWRITE_LOG 2–149 CONNECTIONS. 2–9 NOWRITE_PROTECT 2–151 UPS= 2–115 NOWRITEBACK_CACHE 2–151 WRITE_PROTECT 2–35 2–151...
Page 263 Index concatsets 2–59 SHOW CONCATSETS 2–155 connection-name 2–60 SHOW connection-name 2–159 container-name 2–62 SHOW CONNECTIONS 2–157 FAILEDSETS 2–64 SHOW controller 2–160 remote-copy-set-name 2–65 SHOW DEVICES 2–162 SPARESETS 2–66 SHOW disk-name 2–164 unit-number 2–67 SHOW DISKS 2–163 DESTROY_PARTITION 2–69 SHOW EMU 2–165 DIRECTORY 2–71 SHOW FAILEDSETS 2–166 EXIT 2–72...
Page 264 Index testing controllers 2–97 UNMIRROR text symbols v command parameters 2–192 this controller description 2–192 starting diagnostic or utility programs 2–94 parameter, disk-name 2–192 TIME, switch for SET controller 2–115 related commands transfer rate, setting device 2–13 2–19 2–118 ADD MIRRORSET 2–192 TRANSFER_RATE_REQUESTED, switch for MIRROR 2–192 ADD DISKS 2–13...
Page 265 Index network interface connection symbol, See also read requests. defined vi WRITE_LOG, switch for rack stability vii ADD UNITS 2–38 symbol and definition v SET unit-number 2–149 website addresses, convention defined v WRITE_PROTECT, switch for websites ADD UNITS 2–39 Compaq storage viii SET unit-number 2–151 Compaq technical support vii write-back caching, setting the flush timer 2–109...

HP storageworks HSG80 Reference Manual

Table of Contents

About this Guide

151 CLI Command Introduction

151 CLI Command Descriptions

Restart Controller

Quick Links

Chapters

Related Manuals for HP storageworks HSG80

Summary of Contents for HP storageworks HSG80

Table of Contents