Digital Equipment Corporation HSZ50 Service Manual

DIGITAL StorageWorksHSZ50 Array ControllerHSOF Version 5.1CLI Reference ManualPart Number: EK–HSCLI–RM. B01March 1997Software Version: HSOF 5.1Digita

1–4 Introduction to the CLICLI Reference Manual HSZ50 Array ControllerCapturing Your CLI SessionIf you are using a remote terminal connection via DUP

2-86 SHUTDOWN THIS_CONTROLLER and SHUTDOWN OTHER_CONTROLLERCLI Reference Manual HSZ50 Array ControllersSHUTDOWN THIS_CONTROLLER and SHUTDOWNOTHER_CONT

SHUTDOWN THIS_CONTROLLER and SHUTDOWN OTHER_CONTROLLER 2-87HSZ50 Array Controllers CLI Reference Manual IMMEDIATE_SHUTDOWNNOIMMEDIATE_SHUTDOWNThe IMME

2-88 UNMIRRORCLI Reference Manual HSZ50 Array ControllersUNMIRRORConverts a one-member mirrorset back to a single device and deletes the mirrorset fr

HSZ50 Array Controller CLI Reference ManualGlossary

G-2 GlossaryCLI Reference Manual HSZ50 Array ControlleradapterA device that converts the protocol and hardware interface of one bus type into that ofa

Glossary G-3HSZ50 Array Controller CLI Reference Manualcontroller shelfA StorageWorks shelf designed to contain controller and cache memory modules.CR

G-4 GlossaryCLI Reference Manual HSZ50 Array ControllerECCError correction code. One or more cyclic redundancy check (CRC) words that allowdetection o

Glossary G-5HSZ50 Array Controller CLI Reference ManualHBVSHost-based volume shadowing. Also known as Phase 2 volume shadowing.HSOFHierarchical storag

G-6 GlossaryCLI Reference Manual HSZ50 Array ControllerLUNA logical unit number is a physical or virtual peripheral device addressable through atarget

Glossary G-7HSZ50 Array Controller CLI Reference ManualportThe hardware and software used to connect a host controller to a communication bus, suchas

Introduction to the CLI 1–5HSZ50 Array Controller CLI Reference ManualEntering CLI CommandsUse the following tips and techniques when entering CLI c

G-8 GlossaryCLI Reference Manual HSZ50 Array ControllerSBBStorageWorks building block. A modular carrier plus the individual mechanical andelectromech

Glossary G-9HSZ50 Array Controller CLI Reference ManualSPDSoftware product description. A document that contains the legal description of a product.st

G-10 GlossaryCLI Reference Manual HSZ50 Array ControllerTILXTape inline exerciser. Diagnostic firmware used to test the data transfer capabilities of

Glossary G-11HSZ50 Array Controller CLI Reference Manualwrite-through cacheA cache write strategy in which the destination of the write data is the pr

HSZ50 Array Controller CLI Reference ManualIndexAADD CDROM command, 2-2ADD DISK command, 2-3ADD MIRRORSET command, 2-5ADD PASSTHROUGH command, 2-8ADD

I-2 IndexCLI Reference Manual HSZ50 Array ControllerCLEAR_ERRORS UNWRITEABLE_DATAcommand, 2-26CLI, G-2abbreviating commands, 1–5accessing, 1–3capturin

Index I-3HSZ50 Array Controller CLI Reference Manualhost-addressable unit, 2-15passthrough container, 2-8RAIDsets, 2-9single-disk unit, 2-19striped mi

I-4 IndexCLI Reference Manual HSZ50 Array ControllerHHalf-height device, G-4HBVS, G-5HELP command, 2-37HIS, G-5Host, G-5Host compatibility mode, 2-71H

Index I-5HSZ50 Array Controller CLI Reference ManualREMOVING FROM DUAL-REDUNDANTCONFIGURATION, 2-67SELF-TEST, 2-53PPartitionadding as a unit, 2-15crea

1–6 Introduction to the CLICLI Reference Manual HSZ50 Array ControllerSpecifying the Device PTLUnits accessed by the controller are commonly called lo

I-6 IndexCLI Reference Manual HSZ50 Array Controllerdevice data transfer rate, 2-55Host data transfer rate, 2-73maximum cached transfer size, 2-16, 2-

Index I-7HSZ50 Array Controller CLI Reference ManualUNMIRROR command, 2-88Unwriteable data errorclearing, 2-26retrying, 2-51UPSsetting cache policy, 2

Introduction to the CLI 1–7HSZ50 Array Controller CLI Reference ManualSwitches—Reserved words that have a special function. For example, themember s

2 CLI CommandsDescriptions of all CLI CommandsRequired ParametersOptional SwitchesExamples

2-2 ADD CDROMCLI Reference Manual HSZ50 Array ControllersADD CDROMAdds a CD–ROM drive to the controller configuration and names the drive.FormatADD CD

ADD DISK 2-3HSZ50 Array Controllers CLI Reference Manual ADD DISKAdds a disk drive to the controller configuration and names the drive.FormatADD DISK

2-4 ADD DISKCLI Reference Manual HSZ50 Array ControllersExamplesTo add nontransportable DISK100 at port 1, target 0, LUN 0:CLI> ADD DISK DISK100 1

ADD MIRRORSET 2-5HSZ50 Array Controllers CLI Reference Manual ADD MIRRORSETAdds a mirrorset to the controller configuration and names the mirrorset. T

CLI Reference Manual HSZ50 Array ControllerMarch 1997While Digital Equipment Corporation believes the information included in this manual is correct a

2-6 ADD MIRRORSETCLI Reference Manual HSZ50 Array ControllersPOLICY=BEST_FITPOLICY=BEST_PERFORMANCE (Default)NOPOLICYThe POLICY switch allows you to s

ADD MIRRORSET 2-7HSZ50 Array Controllers CLI Reference Manual See alsoADD DISKDELETEINITIALIZEMIRRORREDUCESHOW MIRRORSETSUNMIRROR

2-8 ADD PASSTHROUGHCLI Reference Manual HSZ50 Array ControllersADD PASSTHROUGHCreates a passthrough container (command disk) to allow direct access to

ADD RAIDSET 2-9HSZ50 Array Controllers CLI Reference Manual ADD RAIDSETCreates a RAIDset from 3 to 14 disks.FormatADD RAIDSET RAIDset-name disk-name1

2-10 ADD RAIDSETCLI Reference Manual HSZ50 Array ControllersSelect NORMAL to balance other controller operations against the reconstruct operation.The

ADD RAIDSET 2-11HSZ50 Array Controllers CLI Reference Manual See alsoADD UNITDELETESET RAIDSETSHOW RAIDSETINITIALIZE

2-12 ADD SPARESETCLI Reference Manual HSZ50 Array ControllersADD SPARESETAdds a disk drive to the spareset and initializes the metadata on the drive.

ADD STRIPESET 2-13HSZ50 Array Controllers CLI Reference Manual ADD STRIPESETCreates a stripeset out of 2 to 14 disks or mirrorsets.FormatADD STRIPESET

2-14 ADD STRIPESETCLI Reference Manual HSZ50 Array ControllersSee alsoADD UNITADD MIRRORSETDELETEINITIALIZESHOW STRIPESET

ADD UNIT 2-15HSZ50 Array Controllers CLI Reference Manual ADD UNITIdentifies a device, container, or partition as a host-addressable logical unit. The

iiiHSZ50 Array Controller CLI Reference ManualTable of Contents1 CLI Overview...

2-16 ADD UNITCLI Reference Manual HSZ50 Array ControllersSwitchesTable 2–2 lists all switches for the ADD UNIT command and shows which switches can be

ADD UNIT 2-17HSZ50 Array Controllers CLI Reference Manual The PREFERRED_PATH switch allows you to balance I/O load by specifying the controllerthrough

2-18 ADD UNITCLI Reference Manual HSZ50 Array ControllersSelect RUN to make a unit available to the host.NoteThe RUN and NORUN switches cannot be spec

ADD UNIT 2-19HSZ50 Array Controllers CLI Reference Manual Considerations When Using Write-back CachingThe following list summarizes considerations you

2-20 ADD UNITCLI Reference Manual HSZ50 Array ControllersSee alsoCREATE_PARTITIONDELETE unit-numberSET unit-numberSHOW UNITS

CLEAR_ERRORS CLI 2-21HSZ50 Array Controllers CLI Reference Manual CLEAR_ERRORS CLIStops the display of current or previous error messages at the CLI p

2-22 CLEAR_ERRORS INVALID_CACHECLI Reference Manual HSZ50 Array ControllersCLEAR_ERRORS INVALID_CACHEClears an INVALID_CACHE error and allows the cont

CLEAR_ERRORS INVALID_CACHE 2-23HSZ50 Array Controllers CLI Reference Manual ExamplesTo clear an invalid cache error on THIS_CONTROLLER after replacing

2-24 CLEAR_ERRORS LOST_DATACLI Reference Manual HSZ50 Array ControllersCLEAR_ERRORS LOST_DATAClears the lost data error on a unit.____________________

CLEAR_ERRORS UNKNOWN 2-25HSZ50 Array Controllers CLI Reference Manual CLEAR_ERRORS UNKNOWNClears the UNKNOWN error from a device.If a device has a fai

ivCLI Reference Manual HSZ50 Array ControllerDELETE unit-number ...

2-26 CLEAR_ERRORS UNWRITEABLE_DATACLI Reference Manual HSZ50 Array ControllersCLEAR_ERRORS UNWRITEABLE_DATAClears the unwriteable data error on a unit

CREATE_PARTITION 2-27HSZ50 Array Controllers CLI Reference Manual CREATE_PARTITIONMarks part of a disk or storageset to be used as a separately addres

2-28 CREATE_PARTITIONCLI Reference Manual HSZ50 Array ControllersCLI> INITIALIZE RAID9CLI> CREATE_PARTITION RAID9 SIZE=25CLI> CREATE_PARTITIO

DELETE container-name 2-29HSZ50 Array Controllers CLI Reference Manual DELETE container-nameDeletes a container from the list of known containers. You

2-30 DELETE device-nameCLI Reference Manual HSZ50 Array ControllersDELETE device-nameDeletes a device from the controller configuration.FormatDELETE d

DELETE FAILEDSET 2-31HSZ50 Array Controllers CLI Reference Manual DELETE FAILEDSETRemoves a disk drive from the failedset. The failedset contains the

2-32 DELETE SPARESETCLI Reference Manual HSZ50 Array ControllersDELETE SPARESETRemoves a disk drive from the spareset. The spareset is a pool of driv

DELETE unit-number 2-33HSZ50 Array Controllers CLI Reference Manual DELETE unit-numberDeletes a logical unit from the controller configuration. The d

2-34 DESTROY_PARTITIONCLI Reference Manual HSZ50 Array ControllersDESTROY_PARTITIONMarks a used partition as free, and consolidates it with any adjace

DIRECTORY 2-35HSZ50 Array Controllers CLI Reference Manual DIRECTORYLists the diagnostics and utilities available on THIS_CONTROLLER.The diagnostics a

vHSZ50 Array Controller CLI Reference ManualRelated DocumentsThe following table lists some of the documents related to the use of this product.Docu

2-36 EXITCLI Reference Manual HSZ50 Array ControllersEXITExits the CLI and breaks the remote connection.When you enter the EXIT command from a remote

HELP 2-37HSZ50 Array Controllers CLI Reference Manual HELPDisplays a brief description of using the question mark (?) to obtain help on any commandor

2-38 INITIALIZECLI Reference Manual HSZ50 Array ControllersINITIALIZEInitializes a container so that you can create a logical unit from it. During ini

INITIALIZE 2-39HSZ50 Array Controllers CLI Reference Manual DESTROY(Default)NODESTROYThe NODESTROY switch instructs the controller not to overwrite th

2-40 INITIALIZECLI Reference Manual HSZ50 Array ControllersExamplesTo initialize single-disk container DISK100 and save a copy of the controller confi

LOCATE 2-41HSZ50 Array Controllers CLI Reference Manual LOCATEIdentifies configured units, storagesets, and devices by flashing the amber device fault

2-42 LOCATECLI Reference Manual HSZ50 Array ControllersWhen entering the PTL, you must put at least one space between the port, target, and LUNnumbers

MIRROR 2-43HSZ50 Array Controllers CLI Reference Manual MIRRORCreates a one-member mirrorset from a single disk. Use this command on devices that area

2-44 MIRRORCLI Reference Manual HSZ50 Array ControllersThe COPY switch allows you to set the speed at which the controller copies data fromnormal mirr

MIRROR 2-45HSZ50 Array Controllers CLI Reference Manual CLI> MIRROR DISK210 MIRROR2CLI> SET MIRROR2 MEMBERSHIP=2CLI> SET MIRROR2 REPLACE=DISK

2-46 REDUCECLI Reference Manual HSZ50 Array ControllersREDUCE__________________________ Note _____________________________The nominal number of member

REDUCE 2-47HSZ50 Array Controllers CLI Reference Manual Parametersdisk-name1The name of the NORMAL mirrorset member to be removed.[disk-nameN]The name

2-48 RENAMECLI Reference Manual HSZ50 Array ControllersRENAMERenames a container.FormatRENAME old-name new-nameParametersold-nameThe existing name for

RESTART THIS_CONTROLLER and RESTART OTHER_CONTROLLER 2-49HSZ50 Array Controllers CLI Reference Manual RESTART THIS_CONTROLLER and RESTARTOTHER_CONTROL

2-50 RESTART THIS_CONTROLLER and RESTART OTHER_CONTROLLERCLI Reference Manual HSZ50 Array ControllersIMMEDIATE_SHUTDOWNNOIMMEDIATE_SHUTDOWNThe IMMEDIA

RETRY_ERRORS UNWRITEABLE_DATA 2-51HSZ50 Array Controllers CLI Reference Manual RETRY_ERRORS UNWRITEABLE_DATAIf a container fails in a way that data in

2-52 RUNCLI Reference Manual HSZ50 Array ControllersRUNStarts a diagnostic or utility program on THIS_CONTROLLER. You can run diagnostics andutilities

SELFTEST OTHER_CONTROLLER and SELFTEST THIS_CONTROLLER 2-53HSZ50 Array Controllers CLI Reference Manual SELFTEST OTHER_CONTROLLER and SELFTESTTHIS_CON

2-54 SELFTEST OTHER_CONTROLLER and SELFTEST THIS_CONTROLLERCLI Reference Manual HSZ50 Array ControllersIMMEDIATE_SHUTDOWNNOIMMEDIATE_SHUTDOWNThe IMMED

SET device-name 2-55HSZ50 Array Controllers CLI Reference Manual SET device-nameChanges the transportable characteristics of a disk drive, or sets the

1 CLI OverviewCLI OverviewHow to Access and Exit the CLIEntering CLI Commands

2-56 SET device-nameCLI Reference Manual HSZ50 Array Controllersdetection, and recovery. Because of this metadata, only StorageWorks controllers canre

SET FAILEDSET 2-57HSZ50 Array Controllers CLI Reference Manual SET FAILEDSETChanges the automatic spare policy for the failedset.FormatSET FAILEDSETSw

2-58 SET FAILOVERCLI Reference Manual HSZ50 Array ControllersSET FAILOVER__________________________ Note _____________________________Both controllers

SET FAILOVER 2-59HSZ50 Array Controllers CLI Reference Manual ExamplesTo place the controllers into a dual-redundant configuration and copy configurat

2-60 SET mirrorset-nameCLI Reference Manual HSZ50 Array ControllersSET mirrorset-nameChanges the characteristics of a mirrorset, including adding and

SET mirrorset-name 2-61HSZ50 Array Controllers CLI Reference Manual If these conditions are met, the device specified by disk-name is added to the mir

2-62 SET mirrorset-nameCLI Reference Manual HSZ50 Array ControllersSelect BEST_PERFORMANCE to choose a replacement device from the spareset that resul

SET mirrorset-name 2-63HSZ50 Array Controllers CLI Reference Manual ExamplesTo change the replacement policy of mirrorset MIRR1 to BEST_FIT:CLI> SE

2-64 SET MULTIBUS_FAILOVERCLI Reference Manual HSZ50 Array ControllersSET MULTIBUS_FAILOVER__________________________ Note ___________________________

SET MULTIBUS_FAILOVER 2-65HSZ50 Array Controllers CLI Reference Manual Figure 2–1 Controller Connections in Multiple Bus Failover ConfigurationCXO-52

1–2 Introduction to the CLICLI Reference Manual HSZ50 Array ControllerCLI OverviewThe command line interpreter (CLI) is one of the user interfaces to

2-66 SET MULTIBUS_FAILOVERCLI Reference Manual HSZ50 Array ControllersDue to the amount of information that must be passed between the two controllers

SET NOFAILOVER (SET NOMULTIBUS_FAILOVER) 2-67HSZ50 Array Controllers CLI Reference Manual SET NOFAILOVER (SET NOMULTIBUS_FAILOVER)Takes THIS_CONTROLLE

2-68 SET NOFAILOVER (SET NOMULTIBUS_FAILOVER)CLI Reference Manual HSZ50 Array ControllersUse the SET NOFAILOVER DESTROY_UNFLUSHABLE_DATA if you want t

SET THIS_CONTROLLER and SET OTHER_CONTROLLER 2-69HSZ50 Array Controllers CLI Reference Manual SET THIS_CONTROLLER and SET OTHER_CONTROLLERChanges para

2-70 SET THIS_CONTROLLER and SET OTHER_CONTROLLERCLI Reference Manual HSZ50 Array ControllersCACHE_FLUSH_TIMER=nCACHE_FLUSH_TIMER=DEFAULTSpecifies how

SET THIS_CONTROLLER and SET OTHER_CONTROLLER 2-71HSZ50 Array Controllers CLI Reference Manual CACHE_UPSNOCACHE_UPS (Default)Specifies whether the cont

2-72 SET THIS_CONTROLLER and SET OTHER_CONTROLLERCLI Reference Manual HSZ50 Array ControllersID=nSpecifies from one to four SCSI target IDs (0–7). Mul

SET THIS_CONTROLLER and SET OTHER_CONTROLLER 2-73HSZ50 Array Controllers CLI Reference Manual Specifying NOPREFERRED_ID for one controller makes it a

2-74 SET THIS_CONTROLLER and SET OTHER_CONTROLLERCLI Reference Manual HSZ50 Array Controllers8-bit, single ended 10 MHz 10 MB/Sec 3 9.8416-bit, differ

SET RAIDset-name 2-75HSZ50 Array Controllers CLI Reference Manual SET RAIDset-nameChanges the characteristics of a RAIDset.FormatSET RAIDset-nameParam

Introduction to the CLI 1–3HSZ50 Array Controller CLI Reference ManualAccessing and Exiting the CLI__________________________ Note__________________

2-76 SET RAIDset-nameCLI Reference Manual HSZ50 Array ControllersREMOVE=disk-name__________________________ Note _____________________________You cann

SET unit-number 2-77HSZ50 Array Controllers CLI Reference Manual SET unit-numberChanges the characteristics of a unit.FormatSET unit-numberParametersu

2-78 SET unit-numberCLI Reference Manual HSZ50 Array ControllersMAXIMUM_CACHED_TRANSFER=nMAXIMUM_CACHED_TRANSFER=32 (Default)The MAXIMUM_CACHED_TRANSF

SET unit-number 2-79HSZ50 Array Controllers CLI Reference Manual Read caching improves performance in almost all situations, so it is generally good t

2-80 SET unit-numberCLI Reference Manual HSZ50 Array ControllersWRITEBACK_CACHENOWRITEBACK_CACHE (Default)__________________________ Note ____________

SET unit-number 2-81HSZ50 Array Controllers CLI Reference Manual When restarted, the controller attempts to flush any unflushed data within the write-

2-82 SHOWCLI Reference Manual HSZ50 Array ControllersSHOWDisplays information about controllers, storagesets, devices, and partitions.________________

SHOW 2-83HSZ50 Array Controllers CLI Reference Manual storageset-typeSpecifies the type of storageset that you want to display: STORAGESETS—all stora

2-84 SHOWCLI Reference Manual HSZ50 Array ControllersCLI> SHOW DEVICES FULLName Type Port Targ Lun Used by---

SHOW 2-85HSZ50 Array Controllers CLI Reference Manual MIRR1 mirrorset DISK130 D202 Switches: NOPOLICY (for