ADD Passthrough, Parameter, 16CLI Commands | Compaq HSZ80 specification

5–16CLI Commands

ADD PASSTHROUGH

Creates a passthrough container. A passthrough container bypasses controller processing and allows the host to have direct access to the device. A passthrough device appears as if it were connected directly to the host bus rather than to the controller. Use passthrough containers to communicate with tape devices and tape loaders because they do not require the controller for optimum operation performance.

Passthrough units can be created for passthrough Command Console LUNs to allow SWCC to configure and monitor the controllers and devices on the backend in a remote mirroring implementation. The passthrough devices are automatically configured by the controller if they exist. The unit above the passthrough is not automatically configured by the controller.

Syntax

ADD PASSTHROUGH passthrough-name scsi-port-target-lun

Parameter

Names the device being added to or changed in a subsystem configuration. This is the same name used with the ADD UNIT command to create a host-addressable unit. You may want to use a name indicating the type of device is being added as a passthrough container, such as TAPE or LOADER.

The container name must start with a letter (A through Z) and may consist of a maximum of nine characters including letters A through Z, numbers 0 through 9, periods (.), dashes (-), or underscores (_).

IMPORTANT: It is common to name a tape passthrough device TAPEpttll, where pttll is the tape’s Port-Target-LUN address. Although other naming conventions are acceptable, this naming convention offers the advantage of presenting to the user both the type of device and its SCSI location in an intuitive manner.

Image 202

Compaq HSZ80 manual Parameter, 16CLI Commands, ADD Passthrough passthrough-name scsi-port-target-lun

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 Maintenance Port Precautions Vhdci Cable PrecautionsXvii Typographical Conventions 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 Utilities and Exercisers Fault Management UtilityVirtual Terminal Display Code Load and Code Patch Utility Configuration UtilityDisk Inline Exerciser Clone Utility Change Volume Serial Number Utility Field Replacement UtilityDevice Statistics Utility Cache Module Cache Module Memory Configurations18General 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 2Configuring an HSZ80 Array Controller Configuration RulesIntroduction 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 Optional Steps 22Configuring an HSZ80 Array ControllerChange 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 Restoring Node IDs 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 36Creating Storagesets Device PTL Addressing Convention within ControllerLocate devicename 11. PTL Naming Convention 38Creating Storagesets Device port numbers Target Numbers 13. Locating Devices using PTLs Defining a Partition Planning Partitions40Creating Storagesets Guidelines for Partitioning Storagesets Disk Drives Changing Switches Choosing Switches for Storagesets DevicesEnabling Switches 42Creating Storagesets Replacement Policy RAIDset SwitchesReconstruction Policy Membership 44Creating Storagesets Mirrorset Switches Read Source Copy Speed46Creating Storagesets Disaster Tolerance Support Transportability Device Switches48Creating Storagesets Device Transfer Rate 50Creating Storagesets Local/RemoteDtsupport 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 for Storagesets Unit Switches58Creating 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 Show RAIDset-name Configuring a Striped MirrorsetADD 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 Unit Switches Changing Initialize 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 26Configuring Storagesets Transparent Failover ModeDesignating 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 Getting Help Entering CLI CommandsSET Thiscontroller ? 4CLI Commands Recall and Edit Command KeysUnit Naming Unit Number Command parameter Switches Command Syntax6CLI Commands Changing the CLI Prompt Syntax ADD DiskParameters 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 ADD Mirrorset MIRR1 DISK10000 DISK20100 DISK30200 14CLI CommandsInitialize MIRR1 ADD Unit D104 MIRR1 Initialize Mirror Reduce ADD Disk ADD UnitShow 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 Show Devices Show Passthrough 18CLI CommandsShow passthrough-name ADD Raidset RAIDset-name RECONSTRUCT=NORMAL Default 20CLI CommandsRECONSTRUCT=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 ADD Unit ADD Mirrorset 26CLI CommandsInitialize Show Storageset Show Stripeset ADD Unit unit-number container-name ADD UnitUnit-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 36CLI Commands Clearerrors controller InvalidcacheController Examples Clearerrors DISK30000 Unknown Clearerrors device-nameUNKNOWN38CLI Commands Device-name See also 40CLI Commands Clearerrors unit-numberLOSTDATAClearerrors 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 Delete Failedset Delete Spareset Unmirror 52CLI CommandsDelete RAID9 Delete Failedset DISK20200 Delete FailedsetSET Failedset Show Failedset Delete Spareset DISK20300 Delete Spareset54CLI Commands ADD Spareset Show Spareset Delete unit-number Delete D103 ADD Unit Clearerrors Lostdata 56CLI CommandsDelete Failedsets Delete Sparesets Destroypartition Destroypartition container-name PARTITION=partition-number DestroypartitionPartition-number 58CLI Commands Delete D102 Destroypartition RAID9 PARTITION=2 Directory DirectoryRUN Help 60CLI CommandsHelp Help SET ? Your options are Initialize 62CLI CommandsInitialize 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 D102 Locate DISK10000 Locate CancelLocate Disks Mirror 70CLI CommandsMirror 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 Reduce disk-name1 disk-name2 disk-name3 78CLI CommandsDisk-name1 disk-name2 disk-name3 Show STRIPE1 Show Mirrorsets ADD Mirrorset RUN Clone Show Mirrorset 80CLI CommandsSET mirrorset-name Old-container-name RenameRename old-container-name new-container-name New-container-name 82CLI Commands Rename DISK10000 Mydisk Show Disks Noignoreerrors Default IgnoreerrorsRestart 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 SET controller SwitchesThiscontroller 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 NOPORT1PREFERREDID 98CLI CommandsNOPORT2PREFERREDID 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 105 SET EMUSET EMU FANSPEED=AUTOMATIC Default EMU Set Point Temperatures106CLI Commands FANSPEED=HIGH SET EMU SENSOR2SETPOINT=34 107SET EMU FANSPEED=HIGH SET Failedset 108CLI CommandsSET Failedset Autospare Noautospare Init DISK10000 109SET DISK10000 Transportable SET Failedset Autospare SET Failover 110CLI CommandsThiscontroller Othercontroller SET Failover COPY=THISCONTROLLER 111SET Multibusfailover SET Nofailover SET Nomultibusfailover 112CLI Commands SET mirrorset-name 113 MEMBERSHIP=number-of-members REMOVE=disk-name 114CLI CommandsREPLACE=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 SET Nofailover 121SET Failover SET Multibusfailover SET Nomultibusfailover 122CLI Commands SET Nomultibusfailover SET Nomultibusfailover Destroyunflushabledata 123SET Failover SET Multibusfailover SET Nofailover 124CLI Commands SET RAIDset-name 125 SET RAID9 POLICY=BESTFIT 126CLI CommandsSET RAID9 REMOVE=DISK10000 SET RAID9 REPLACE=DISK20100 127ADD 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 Show MIRR1 140CLI CommandsShow Mirrorset Full 141 Show Thiscontroller Full 142CLI Commands Show EMU Shutdown controller 143 Shutdown Thiscontroller 144CLI CommandsRestart controller Selftest controller 145 UnmirrorUnmirror 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-4 Maximum Nonoperating Environmental Specifications Table B-3 Maximum Operating 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 2Index Batteryoff Poweroff Batteryon PoweroffAUTOSPARE, 4-15SET Failedset Chunksize Initialize CacheupsCapacity CREATEPARTITION, 5-49INITIALIZE Lostdata 4Index SET MULTIBUSFAILOVER, 5-118SET NofailoverPage Copy 6IndexCylinders CREATEPARTITION, 5-49INITIALIZE Destroyunflushabledata SET Nofailover SET Nomultibusfailover Dilx Disableaccesspath ADD Unit8Index Disks Errormode Enableaccesspath ADD UnitECB Index Saveconfiguration NosaveconfigurationADD 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 PORT1ID Show device-type,5-137PathPORT2ID Prompt PreferredpathSET 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 PORT2PREFERREDID PORT2TRANSFERRATEREQUESTE D PORT1PREFERREDID PORT1TRANSFERRATEREQUESTE DWRITEPROTECT, 5-133WRITEBACKCACHE Passthrough Show storageset-name,5-137SHOW storageset-type,5-137 Size Createpartition TRANSFERRATEREQUESTED, 3-49TRANSPORTABLE SET controller, 5-99Tip, defined, xix Tools, xx Topology TimeTRANSFERRATEREQUESTED, 3-49ADD Disk Vtdpy Writeprotect