132CLI Commands, Errormode=Normal Errormode=Failsafe | Compaq HSZ80

5–132CLI Commands

Select PREFERRED_PATH=THIS_CONTROLLER to instruct “this controller” to bring the unit online.

Select PREFERRED_PATH=OTHER_CONTROLLER to instruct the “other controller” to bring the unit online.

See Chapter 2 for information regarding multiple bus failover.

ERROR_MODE=NORMAL

ERROR_MODE=FAILSAFE

Valid only on mirrorsets that have been enabled for DT_SUPPORT. Controls how the mirroring software treats member failure.

Specify NORMAL and the mirroring software will fail any I/O—forcing the mirrorset inoperative—when the normal/normalizing local membership falls to zero.

Specify FAILSAFE and the mirroring software will fail any I/O—forcing the mirrorset inoperative—whenever either normal/normalizing remote membership or normal/normalizing local membership falls to zero.

If FAILSAFE is specified, the DT_SUPPORT must be enabled on the mirrorset and there must be at least one normal/normalizing local member and one normal/ normalizing remote member, otherwise an error is displayed.

READ_CACHE (Default)

NOREAD_CACHE

Sets the controller’s read-cache function.

Read caching improves performance in almost all situations. Therefore, it is recommended to leave its default setting, READ_CACHE, enabled. However, under certain conditions, such as when performing a backup, read-caching may not be necessary since only a small amount of data is cached. In such instances, it may be beneficial to disable read cache and remove the processing overhead associated with caching.

Image 318

Compaq HSZ80 manual 132CLI Commands, Errormode=Normal Errormode=Failsafe

Contents

HSZ80 Array Controller ACS Version Page Japan USA Page Chapter Creating Storagesets CLI Commands Vii Viii Appendix a Page Figures Xii Tables Xiii Xiv Getting Help Compaq Website Telephone Numbers Component Precaution PrecautionsElectrostatic Discharge Precautions Xvi About This Guide Vhdci Cable Precautions Maintenance Port PrecautionsXvii Conventions Typographical ConventionsXviii About This Guide Special Notices Xix Required Tools Xx About This Guide Related Publications Xxi Revision History Xxii About This Guide General Description Typical Installation 2General Description Basic Building Block Basic Building Blocks List 4General Description Summary of HSZ80 Features Summary of Controller Features 6General Description HSZ80 Array Controller Bridging the Gap Between the Host and Its Storage Subsystem 8General Description HSZ80 Array Controller HSZ80 Array Controller Description of Parts 10General Description Description of Parts Parts of the Optional Maintenance Port Cable 12General Description Operator Control Panel EMU PVA Maintenance Port 14General Description Fault Management Utility Utilities and ExercisersVirtual Terminal Display Code Load and Code Patch Utility Configuration UtilityDisk Inline Exerciser Clone Utility Field Replacement Utility Change Volume Serial Number UtilityDevice Statistics Utility Cache Module Memory Configurations Cache Module18General Description Location of Cache Module Parts Read-Ahead Caching Caching TechniquesRead Caching 20General Description Write-Through Caching Write-Back Caching Cache Policies Resulting from Cache Module Failures Fault-Tolerance for Write-Back CachingNonvolatile Memory 22General Description Cache Policies and Cache Module Status 24General Description Failover to controller B Resulting Cache Policies and ECB Status 26General Description Through caching to its units Less than 28General Description External Cache Battery 10 ECB Capacity Based on Memory Size 11 Location of Parts 30General Description Charging Diagnostics Battery HysteresisPage Configuring an HSZ80 Array Controller Configuration Rules 2Configuring an HSZ80 Array ControllerIntroduction Configuring an HSZ80 Array Controller Few Tips 4Configuring an HSZ80 Array Controller Configuring a Single Controller Location of Parts for a Single Controller Configuration 6Configuring an HSZ80 Array Controller SET Thiscontroller HOSTFUNCTION= ID, Mode 8Configuring an HSZ80 Array Controller Connecting a Single Controller to the Host 10Configuring an HSZ80 Array Controller Location of Parts for Transparent Failover 12Configuring an HSZ80 Array Controller SET Failover Copy = Thiscontroller Restart Othercontroller Restart Thiscontroller 14Configuring an HSZ80 Array Controller Connecting in Transparent Failover Mode to the Host 16Configuring an HSZ80 Array Controller Location of Parts for Multiple-Bus Failover 18Configuring an HSZ80 Array Controller SET Multibusfailover Copy = Thiscontroller Restart Othercontroller Restart Thiscontroller 20Configuring an HSZ80 Array Controller Connecting in Multiple-Bus Failover Mode to the Host 22Configuring an HSZ80 Array Controller Optional StepsChange the CLI prompt Set the maximum data-transfer rate 24Configuring an HSZ80 Array Controller UPS Support Setting the PVA Module ID Switch 26Configuring an HSZ80 Array Controller Establishing a Local Connection to Controller PC/Terminal to Maintenance Port Connection 28Configuring an HSZ80 Array Controller This Controller and Other Controller Selecting a Failover Mode Using Transparent Failover Mode Using Multiple-Bus Failover Mode 30Configuring an HSZ80 Array Controller Selecting a Cache Mode Enabling Mirrored Write-Back Cache Fault-Tolerance 32Configuring an HSZ80 Array Controller Setting Scsi Target ID Numbers Host Scsi Bus 34Configuring an HSZ80 Array Controller Device Scsi Bus Using Preferred ID Numbers Page Creating Storagesets 2Creating Storagesets Disk drives Planning and Configuring Storagesets 4Creating Storagesets Creating a Storageset and Device Profile Creating Storagesets Type of Storageset Determining Storage Requirements 8Creating Storagesets Choosing a Storageset TypeA Comparison of Different Kinds of Storagesets For Disk Array Technology Using Stripesets to Increase I/O Performance Considerations for Planning a Stripeset 10Creating Storagesets Distribute Members across Ports Using Mirrorsets to Ensure Availability 12Creating Storagesets Considerations for Planning a Mirrorset Mirrorsets Maintain Two Copies of the Same Data 14Creating Storagesets First Mirrorset Members on Different Buses Using RAIDsets to Increase Performance Availability Considerations for Planning a RAIDset 16Creating StoragesetsPage 18Creating Storagesets Striping and Mirroring in the Same Storageset Considerations for Planning a Striped Mirrorset Cloning Data for Backup 20Creating Storagesets Clone Steps for Duplicating Unit Members Example 22Creating Storagesets Use available device DISK20400size=832317 for member 24Creating Storagesets DISK20000size=832317 y,n y ? y Backing Up Your Subsystem Configuration Saving Subsystem Configuration Information to a Single Disk Saving Subsystem Configuration Information to a Storageset 26Creating Storagesets Displaying the Status of the Save Configuration Feature Controller 28Creating Storagesets Cache Notransportable Node IDs Restoring Node IDs30Creating Storagesets Page Assigning Unit Numbers for Host Access to Storagesets 32Creating Storagesets Unit Numbering Examples LUN Creating a Storageset Map 34Creating Storagesets 10. Storageset Map Device PTL Addressing Convention within Controller 36Creating StoragesetsLocate devicename 11. PTL Naming Convention 38Creating Storagesets Device port numbers Target Numbers 13. Locating Devices using PTLs Planning Partitions Defining a Partition40Creating Storagesets Guidelines for Partitioning Storagesets Disk Drives Changing Switches Choosing Switches for Storagesets DevicesEnabling Switches 42Creating Storagesets RAIDset Switches Replacement PolicyReconstruction Policy Membership 44Creating Storagesets Mirrorset Switches Copy Speed Read Source46Creating Storagesets Disaster Tolerance Support Device Switches Transportability48Creating Storagesets Device Transfer Rate Local/Remote 50Creating StoragesetsDtsupport Initialize Switches Chunk Size Increasing the Request Rate 52Creating Storagesets Increasing the Data Transfer Rate 16. Chunk Size Smaller than the Request Size Maximum Chunk Sizes for a RAIDset Increasing Sequential Write PerformanceMaximum Chunk Size for RAIDsets 54Creating Storagesets Save Configuration Considerations for Saving the Configuration 56Creating Storagesets Destroy/Nodestroy Unit Switches Unit Switches for Storagesets58Creating Storagesets Configuring Storagesets Adding Disk Drives 2Configuring StoragesetsADD Disk DISKnnnn ptl-location switchvalue Adding One Disk Drive at a Time Configuring a Stripeset ADD Mirrorset mirrorset-name DISKnnnn DISKnnnn switch Configuring a Mirrorset4Configuring Storagesets Initialize mirrorset-name switch ADD Unit unit-number mirrorset-name switch Show mirrorset-name ADD Raidset RAIDset-name DISKnnnn DISKnnnn DISKnnnn switch Configuring a RAIDset6Configuring Storagesets Initialize RAIDset-name switch Configuring a Striped Mirrorset Show RAIDset-nameADD Stripeset stripeset-name mirrorset1 mirrorset2 8Configuring Storagesets Configuring a Single-Disk Unit ADD Unit unit-number DISKnnnn switchvalue 10Configuring Storagesets Partitioning a Storageset or Disk Drive Initialize storageset-name switch Show storageset-name 12Configuring Storagesets Adding a Disk Drive to the Spareset Removing a Disk Drive from the Spareset 14Configuring Storagesets Enabling Autospare Delete unit-number 16Configuring StoragesetsDeleting a Storageset Delete storageset-name Changing RAIDset and Mirrorset Switches Changing Switches for a Storageset or DeviceDisplaying the Current Switches Changing Device Switches Changing Initialize Switches Changing Unit Switches18Configuring Storagesets Configuring with the Command Console LUN Enabling and Disabling the CCL 20Configuring Storagesets SCSI-2 ModeSCSI-3 Mode Finding the CCL Location Troubleshooting with the CCL Adding Storage Units with the CCL 22Configuring Storagesets Configuring Units with Multiple Hosts Host Modes 24Configuring Storagesets IBM AIX Setting Host Modes Transparent Failover Mode 26Configuring StoragesetsDesignating the Port Accessing Units on a Given Port 28Configuring Storagesets Designating the Host Scsi ID Number Scsi ID 30Configuring Storagesets Designating the Port and Designating the Host Scsi ID Number SET this PORT1ID = SET this PORT2ID = Multiple-Bus Failover Mode 32Configuring Storagesets Assigning Units through Multiple Host Adapters 34Configuring Storagesets Moving Storagesets Moving a Storageset from one Subsystem to Another Delete disk-name 36Configuring StoragesetsLocate disk-name ADD Disk disk-name PTL-location ADD storageset-name disk-name disk-name ADD Unit unit-number storageset-name 38Configuring Storagesets Move disk drives to their new location CLI Commands 2CLI Commands Using the CLICommand Overview CLI Overview Entering CLI Commands Getting HelpSET Thiscontroller ? Recall and Edit Command Keys 4CLI CommandsUnit Naming Unit Number Command parameter Switches Command Syntax6CLI Commands Changing the CLI Prompt ADD Disk SyntaxParameters Transportable Switches8CLI Commands Remote TRANSFERRATEREQUESTED=10MHZ TRANSFERRATEREQUESTED=5MHZ TRANSFERRATEREQUESTED=20MHZ DefaultTRANSFERRATEREQUESTED=ASYNCHRONOUS ADD Disk DISK40200 4 2 0 Transportable Initialize DISK20000 2 0 ADD Unit D199 DISK20000 10CLI CommandsSee also ADD Disk DISK200 2 0 0 Remote ADD Mirrorset COPY=FAST Dtsupport Nodtsupport 12CLI CommandsPOLICY=BESTPERFORMANCE Default POLICY=BESTFIT READSOURCE=disk-name READSOURCE=LEASTBUSY Default READSOURCE=ROUNDROBIN 14CLI Commands ADD Mirrorset MIRR1 DISK10000 DISK20100 DISK30200Initialize MIRR1 ADD Unit D104 MIRR1 ADD Disk ADD Unit Initialize Mirror ReduceShow Mirrorsets Show Storagesets Unmirror Parameter 16CLI CommandsADD Passthrough ADD Passthrough passthrough-name scsi-port-target-lun ADD Passthrough TAPE20300 2 3 ADD Unit P100 TAPE20300 18CLI Commands Show Devices Show PassthroughShow passthrough-name ADD Raidset RAIDset-name 20CLI Commands RECONSTRUCT=NORMAL DefaultRECONSTRUCT=FAST ADD Raidset RAID9 DISK10000 DISK20100 DISK30200 Noreduced DefaultReduced Initialize RAID8 ADD Raidset RAID6 DISK10300 DISK20400 DISK30200 Reduced 22CLI CommandsADD Unit D70 RAID8 SET Raidset Show Raidset Delete Spareset Show Spareset Show Storagesets ADD SparesetADD Spareset DISK20200 ADD Spareset DISK30300 Disk-name Stripeset-name 24CLI CommandsADD Stripeset Container-name1 container-name2 container-nameN ADD Stripeset STRIPE1 DISK10000 DISK20100 DISK30200 Initialize STRIPE1 ADD Unit D103 STRIPE1 26CLI Commands ADD Unit ADD MirrorsetInitialize Show Storageset Show Stripeset ADD Unit ADD Unit unit-number container-nameUnit-number ADD Unit Switches for Storagesets 28CLI CommandsPage Nopreferredpath Default 30CLI CommandsMAXIMUMCACHEDTRANSFER=32 Default MAXIMUMCACHEDTRANSFER=n PARTITION=partitionnumber Noreadcache Readcache DefaultReadaheadcache Default Noreadaheadcache Nowriteprotect 32CLI CommandsNorun Nowritebackcache ADD Unit D102 DISK10000 PREFERREDPATH=THISCONTROLLER Delete unit-number SET unit-number 34CLI CommandsCreatepartition Show Units Clearerrors CLI Clearerrors CLIClearerrors CLI Clearerrors Clearerrors Clearerrors Clearerrors Clearerrors controller Invalidcache 36CLI CommandsController Examples Clearerrors DISK30000 Unknown Clearerrors device-nameUNKNOWN38CLI Commands Device-name See also Clearerrors unit-numberLOSTDATA 40CLI CommandsClearerrors D103 Lostdata See also Clearerrors D103 Unwriteabledata Clearerrors unit-number42CLI Commands Unwriteabledata See also Configuration Reset Configuration Reset44CLI Commands Configuration Restore Configuration Save Initialize Configuration Restore Configuration Restore 46CLI Commands Configuration Reset Configuration Save Initialize Configuration Save Configuration Reset Configuration Restore Initialize Createpartition container-name SIZE=percent 48CLI CommandsCreatepartition SIZE=percent CAPACITY= CYLINDERS= HEADS= SECTORSPERTRACK= 50CLI Commands Destroy Partition Show Delete DISK10000 Delete STRIPE1 52CLI Commands Delete Failedset Delete Spareset UnmirrorDelete RAID9 Delete Failedset Delete Failedset DISK20200SET Failedset Show Failedset Delete Spareset DISK20300 Delete Spareset54CLI Commands ADD Spareset Show Spareset Delete unit-number Delete D103 56CLI Commands ADD Unit Clearerrors LostdataDelete Failedsets Delete Sparesets Destroypartition Destroypartition Destroypartition container-name PARTITION=partition-numberPartition-number 58CLI Commands Delete D102 Destroypartition RAID9 PARTITION=2 Directory DirectoryRUN Help 60CLI CommandsHelp Help SET ? Your options are 62CLI Commands InitializeInitialize container-name CHUNKSIZE=DEFAULT Default CHUNKSIZE=n Saveconfiguration 64CLI CommandsDestroy Default Nosaveconfiguration Default Initialize DISK10000 Saveconfiguration Show Devices Full 66CLI Commands Reduce DISK40400 Initialize DISK40400 Nodestroy Locate parameter CancelLocate ALL PTL SCSI-location 68CLI CommandsDisks Units Locate DISK10000 Locate Cancel Locate D102Locate Disks 70CLI Commands MirrorMirror disk-name mirrorset-name Nopolicy Default POLICY=BESTFIT POLICY=BESTPERFORMANCE 72CLI Commands ADD Mirrorset Reduce Show Mirrorsets Unmirror Battery on Poweroff74CLI Commands Overridebadflush Poweroff Switch Settings SECONDS=nn 76CLI Commands Poweroff SECONDS=10 Reduce 78CLI Commands Reduce disk-name1 disk-name2 disk-name3Disk-name1 disk-name2 disk-name3 Show STRIPE1 Show Mirrorsets 80CLI Commands ADD Mirrorset RUN Clone Show MirrorsetSET mirrorset-name Old-container-name RenameRename old-container-name new-container-name New-container-name 82CLI Commands Rename DISK10000 Mydisk Show Disks Ignoreerrors Noignoreerrors DefaultRestart controller Restart Thiscontroller 84CLI CommandsImmediateshutdown Restart Othercontroller Retryerrors unit-number Retryerrors D103 Unwriteabledata RUN program-name 86CLI CommandsRUN Program-namePage 88CLI Commands RUN Dilx Selftest controller Selftest controller Selftest Thiscontroller 90CLI CommandsSelftest Othercontroller Ignoreerrors Restart controller Shutdown controller SET controller Switches SET controllerThiscontroller 92CLI Commands Allocationclass CACHEFLUSHTIMER=n CACHEFLUSHTIMER=10 DefaultNocacheups Default Cacheups Nocommandconsolelun Default 94CLI CommandsCommandconsolelun HOSTFUNCTION=mode HOSTFUNCTION=ID,mode NODEID=nnnn-nnnn-nnnn-nnnn checksum NOPORT2ID 96CLI CommandsNOPORT1ID MirroredcachePage 98CLI Commands NOPORT1PREFERREDIDNOPORT2PREFERREDID SCSIVERSION=SCSI-3 SCSIVERSION=SCSI-2 DefaultTERMINALSPEED=baudrate TERMINALSPEED=9600 Default TERMINALPARITY=ODD TERMINALPARITY=EVEN 100CLI Commands Maximum SCSI-Bus Lengths for Given Data Transfer Rate SET Thiscontroller PORT1ID=2,5 101SET Othercontroller PROMPT=CONTROLLER B Show Thiscontroller Show Othercontroller 102CLI Commands SET device-name 103 SET DISK10300 Transportable 104CLI CommandsSET DISK20000 TRANSFERRATEREQUESTED=5MHZ SET DISK10300 Remote SET EMU 105SET EMU FANSPEED=AUTOMATIC Default EMU Set Point Temperatures106CLI Commands FANSPEED=HIGH 107 SET EMU SENSOR2SETPOINT=34SET EMU FANSPEED=HIGH SET Failedset 108CLI CommandsSET Failedset Autospare Noautospare Init DISK10000 109SET DISK10000 Transportable SET Failedset Autospare 110CLI Commands SET FailoverThiscontroller Othercontroller 111 SET Failover COPY=THISCONTROLLERSET Multibusfailover SET Nofailover SET Nomultibusfailover 112CLI Commands SET mirrorset-name 113 MEMBERSHIP=number-of-members 114CLI Commands REMOVE=disk-nameREPLACE=disk-name 115 116CLI Commands SET MIRR1 POLICY=BESTFIT SET MIRR1 REPLACE=DISK30200 117SET MIRR1 REMOVE=DISK30000 ADD Mirrorset Reduce Show Mirrorset Unmirror 118CLI Commands SET Multibusfailover 119 SET Failover SET Nofailover SET Nomultibusfailover SET Nofailover 120CLI CommandsNodestroyunflushabledata Default Destroyunflushabledata 121 SET NofailoverSET Failover SET Multibusfailover SET Nomultibusfailover 122CLI Commands SET Nomultibusfailover 123 SET Nomultibusfailover DestroyunflushabledataSET Failover SET Multibusfailover SET Nofailover 124CLI Commands SET RAIDset-name 125 126CLI Commands SET RAID9 POLICY=BESTFITSET RAID9 REMOVE=DISK10000 127 SET RAID9 REPLACE=DISK20100ADD Raidset Show Raidsets 128CLI Commands SET unit-number 129 130CLI Commands MAXIMUMCACHEDTRANSFER=n MAXIMUMCACHEDTRANSFER=32 Default 131 132CLI Commands ERRORMODE=NORMAL ERRORMODE=FAILSAFE 133 134CLI Commands 135 SET D102 Writeprotect Noreadcache Show controller Show device-name Show device-type 136CLI CommandsShow Show EMU EMU 137Device-type Storageset-name 138CLI Commands Full 139 140CLI Commands Show MIRR1Show Mirrorset Full 141 Show Thiscontroller Full 142CLI Commands Show EMU Shutdown controller 143 144CLI Commands Shutdown ThiscontrollerRestart controller Selftest controller Unmirror 145Unmirror DISK10300 146CLI Commands ADD Mirrorset Reduce RUN Clone System Profiles Device Profile 2System Profiles Storageset Profile Reduced Membership Enclosure Template 4System Profiles Controller Specifications Physical and Electrical Specifications for Controller 2Controller Specifications Environmental Specifications Optimum Operating Environmental Specifications Table B-3 Maximum Operating Environmental Specifications Table B-4 Maximum Nonoperating Environmental Specifications4Controller Specifications Glossary GL-2Glossary Bit CSR GL-4Glossary Data striping Dual-simplex See ECB GL-6Glossary FD Scsi IBR GL-8Glossary Operation Mist GL-10Glossary Normal member PCM GL-12Glossary PTL RAIDset GL-14Glossary RFI SCSI-P cable GL-16Glossary Storage subsystem GL-17 Synchronous GL-18Glossary Vhdci GL-19 Page ADD Stripeset stripeset-name container- nameN ADD Passthrough passthrough-name scsi-port-target-lun,5-16ADD Raidset RAIDset-name container- nameN ADD Unit unit-number container-name,5-27Adding Batteryoff Poweroff Batteryon Poweroff 2IndexAUTOSPARE, 4-15SET Failedset Chunksize Initialize CacheupsCapacity CREATEPARTITION, 5-49INITIALIZE Lostdata 4Index SET MULTIBUSFAILOVER, 5-118SET NofailoverPage 6Index CopyCylinders CREATEPARTITION, 5-49INITIALIZE Destroyunflushabledata SET Nofailover SET Nomultibusfailover Dilx Disableaccesspath ADD Unit8Index Disks Enableaccesspath ADD Unit ErrormodeECB Index Nosaveconfiguration SaveconfigurationADD Disk Membership PTL SCSI-location,5-68unit-number,5-68UNITSMaximumcachedtransfer ADD Unit SET mirrorset-name,5-113Membership INVALIDCACHE, 5-36NODTSUPPORT Nooverridebadflush Poweroff Noautospare SET FailedsetNodeid Nopolicy ADD RAIDSET, 5-20NOPORT1ID Nopreferredpath Overridebadflush PoweroffNOPORT2TRANSFERRATEREQUEST ED Noreadcache Show device-type,5-137Path PORT1IDPORT2ID Preferredpath PromptSET controller, 5-98Protocol Rename old-container-name new-container SET mirrorset-name,5-114SET RAIDset-name,5-125 SET mirrorset-name,5-116 RUN program name PORT1PREFERREDID PORT1TRANSFERRATEREQUESTE D PORT2PREFERREDID PORT2TRANSFERRATEREQUESTE DWRITEPROTECT, 5-133WRITEBACKCACHE Passthrough Show storageset-name,5-137SHOW storageset-type,5-137 Size Createpartition TRANSFERRATEREQUESTED, 3-49TRANSPORTABLE Time SET controller, 5-99Tip, defined, xix Tools, xx TopologyTRANSFERRATEREQUESTED, 3-49ADD Disk Vtdpy Writeprotect