CLI Commands | Compaq HSZ80 specification

5–1

Chapter 5

CLI Commands

This appendix contains the Command Line Interpreter (CLI) commands you can use to interact with your controller. Each command description contains the full syntax and examples of the use of the command. The Overview provides a general description of the CLI and how to use it.

Compaq HSZ80 Array Controller ACS Version 8.3 Configuration and CLI Reference Guide

Image 187

Compaq HSZ80 manual CLI Commands

Contents

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