background image

RUN

2–53

HSZ40 Array Controller

CLI Reference Manual

RUN

Starts a diagnostic or utility program on T

HIS

_

CONTROLLER

. You can run diagnostics and

utilities only on T

HIS

_

CONTROLLER

.

Format

RUN 

program-name

Parameters

program-name
The name of the diagnostic or utility to be run. DILX and CLONE are examples of utilities
and diagnostics that can be run from the CLI.

Examples

To run the DILX diagnostic:

CLI> RUN DILX

Disk Inline Exerciser - version 2.0 . . .

See also

DIRECTORY

Summary of Contents for HSZ40

Page 1: ...DIGITALStorageWorks HSZ40ArrayController HSOF3 1 CLIReferenceManual Part Number EK CLI40 RM B01 March 1997 Software Version HSOF Version 3 1 Digital Equipment Corporation Maynard Massachusetts ...

Page 2: ...crosystems Corp IBM is a registered trademark of International Business Machines Corp Windows NT is a registered trademark of Microsoft Corporation This equipment has been tested and found to comply with the limits for a Class A digital device pursuant to Part 15 of the FCC Rules These limits are designed to provide reasonable protection against harmful interference when the equipment is operated ...

Page 3: ...he Device PTL 1 5 Syntax 1 6 2 CLI Commands 2 1 ADD CDROM 2 2 ADD DISK 2 3 ADD MIRRORSET 2 5 ADD PASSTHROUGH 2 8 ADD RAIDSET 2 10 ADD SPARESET 2 13 ADD STRIPESET 2 14 ADD UNIT 2 16 CLEAR_ERRORS CLI 2 22 CLEAR_ERRORS INVALID_CACHE 2 23 CLEAR_ERRORS LOST_DATA 2 25 CLEAR_ERRORS UNKNOWN 2 26 CLEAR_ERRORS UNWRITEABLE_DATA 2 27 CREATE_PARTITION 2 28 DELETE container name 2 30 DELETE device name 2 31 DEL...

Page 4: ...ONTROLLER and SELFTEST THIS_CONTROLLER 2 54 SET device name 2 56 SET FAILEDSET 2 58 SET FAILOVER 2 59 SET mirrorset name 2 61 SET MULTIBUS_FAILOVER 2 65 SET NOFAILOVER SET NOMULTIBUS_FAILOVER 2 68 SET THIS_CONTROLLER and SET OTHER_CONTROLLER 2 70 SET RAIDset name 2 75 SET unit number 2 77 SHOW 2 82 SHUTDOWN THIS_CONTROLLER and SHUTDOWN OTHER_CONTROLLER2 86 UNMIRROR 2 88 Glossary Index Figures Figu...

Page 5: ...ons Configuration Guide EK BA350 CG StorageWorks Solutions Shelf and SBB User s Guide EK BA350 UG StorageWorks Solutions SW300 Series RAID Enclosure Installation and User s Guide EK SW300 UG StorageWorks SW500 Series Cabinet Installation and User s Guide EK SW500 UG StorageWorks SW800 Series Data Center Cabinet Installation and User s Guide EK SW800 UG The RAIDBOOK A Source for RAID Technology RAI...

Page 6: ......

Page 7: ...HSZ40 Array Controller CLI Reference Manual 1 Introduction to the CLI CLI Overview How to Access and Exit the CLI Entering CLI Commands ...

Page 8: ...elative terms THIS_CONTROLLER and OTHER_CONTROLLER THIS_CONTROLLER always refers to the controller that is running the current CLI session You may have a maintenance terminal or PC directly connected to the terminal port on the front of the controller or you may be using a virtual terminal connection through the host bus In either case THIS_CONTROLLER is the one that you are interacting with direc...

Page 9: ...g a VAXcluster system console VCS a diagnostic and utility protocol DUP or an HSZterm remote connection You must use a local connection to perform initial controller configuration such as setting the controller ID Once you have completed initial configuration and the controller is visible on the host bus you can perform all other configuration through a remote connection In a dual redundant contro...

Page 10: ... switches for the same device or unit you must use multiple SET commands You can recall and edit the last five commands This feature can save time and help prevent mistakes when you need to enter similar commands during configuration Use the following keys to recall and edit commands Key Function Up Arrow or Ctrl B Down Arrow or Ctrl N Steps backward and forward through the five most recent CLI co...

Page 11: ...hrough 6 for 6 port controllers T Designates the target identification ID number of the device Valid target ID numbers for a single controller configuration are 0 through 6 Valid target ID numbers for a dual redundant controller configuration are 0 through 5 L Designates the LUN of the device must be 0 Place one space between the port number target number and the two digit LUN number when entering...

Page 12: ...Command Instructs the controller to do something For example the SET command instructs the controller to set something Q Parameter The object that receives the command and is assigned the task of processing the command Q Switches Reserved words that have a special function For example the member switch indicates that the term after it is the name or number of the storage member ...

Page 13: ...2 CLI Commands Descriptions of all CLI Commands Required Parameters Optional Switches Examples ...

Page 14: ...ust start with a letter A Z and can then consist of up to eight more characters made up of letters A Z numbers 0 9 periods dashes or underscores _ for a total of nine characters SCSI location The SCSI Location parameter assigns a PTL address to the CD ROM that is used by the controller See page 1 5 Specifying the Device PTL for an explanation of the PTL numbering system Examples To add a CD ROM dr...

Page 15: ...eWorks environments with the data intact __________________________ Note _____________________________ Use the TRANSPORTABLE switch only for disk drives that must be moved to StorageWorks environments with data intact ____________________________________________________________ A TRANSPORTABLE disk drive does not contain any special information space and can be moved to a non StorageWorks environm...

Page 16: ...dd nontransportable DISK100 at port 1 target 0 LUN 0 CLI ADD DISK DISK100 1 0 0 To add transportable disk DISK230 at port 2 target 3 LUN 0 CLI ADD DISK DISK230 2 3 0 TRANSPORTABLE See also DELETE LOCATE SHOW DISKS SET disk name ...

Page 17: ...the disk drives that make up the mirrorset A mirrorset contains 1 to 6 disk drives Switches COPY NORMAL Default COPY FAST __________________________ Note _____________________________ A normal mirrorset member is one whose entire contents are the same as all other normal members ____________________________________________________________ The COPY switch allows you to set the speed at which the co...

Page 18: ...remaining members READ_SOURCE ROUND_ROBIN READ_SOURCE LEAST_BUSY Default READ_SOURCE disk name The READ_SOURCE switch allows you to control which mirrorset member is used by the controller to satisfy a read request Select ROUND_ROBIN to cause the controller to direct read requests to each NORMAL mirrorset member in sequential membership order No preference is given to any NORMAL member Select LEAS...

Page 19: ...ADD MIRRORSET 2 7 HSZ40 Array Controller CLI Reference Manual See also ADD DISK DELETE INITIALIZE MIRROR REDUCE SHOW MIRRORSETS UNMIRROR ...

Page 20: ...er You use this name with the ADD UNIT command to identify the passthrough container as a host addressable unit You may want to use a name that indicates the type of device served by the passthrough container such as TAPE or LOADER The name must start with a letter A Z and can then consist of up to eight more characters made up of letters A Z numbers 0 9 periods dashes or underscores _ for a total...

Page 21: ...IGITAL UNIX requires HSZ passthrough units to be at LUN 0 the third digit in the unit number OpenVMS accepts LUN numbers 0 7 ____________________________________________________________ To add tape drive TAPE230 at port 2 target 3 LUN 0 CLI ADD PASSTHROUGH TAPE230 2 3 0 CLI ADD UNIT P100 TAPE230 See also ADD UNIT DELETE SHOW PASSTHROUGH ...

Page 22: ...choose a replacement device from the spareset that most closely matches the capacities of the remaining members If more than one device in the spareset is the correct size the controller selects the device that gives the best performance Select BEST_PERFORMANCE to choose a replacement device from the spareset that results in the best performance the device should be on a different port than existi...

Page 23: ... up the RAIDset are being specified such as when creating a new RAIDset Examples To create RAIDset RAID9 with disks DISK100 DISK210 and DISK320 CLI ADD DISK DISK100 1 0 0 CLI ADD DISK DISK210 2 1 0 CLI ADD DISK DISK320 3 2 0 CLI ADD RAIDSET RAID9 DISK100 DISK210 DISK320 CLI INITIALIZE RAID9 CLI ADD UNIT D204 RAID9 To create RAIDset RAID8 with disks DISK100 DISK210 and DISK320 and use the BEST_FIT ...

Page 24: ...2 12 ADD RAIDSET See also ADD UNIT DELETE SET RAIDSET SHOW RAIDSET INITIALIZE ...

Page 25: ...replace failing members of RAIDsets and mirrorsets Format ADD SPARESET disk name Parameters disk name The name of the disk drive to add to the spareset You can add only one drive to the spareset with each command Examples To add DISK220 and DISK330 to the spareset CLI ADD DISK DISK220 2 2 0 CLI ADD DISK DISK330 3 3 0 CLI ADD SPARESET DISK220 CLI ADD SPARESET DISK330 See also DELETE SPARESET SET FA...

Page 26: ...eset A stripeset can be made up of from 2 to 14 containers Examples To create stripeset STRIPE1 with three disks DISK100 DISK210 and DISK320 CLI ADD DISK DISK100 1 0 0 CLI ADD DISK DISK210 2 1 0 CLI ADD DISK DISK320 3 2 0 CLI ADD STRIPESET STRIPE1 DISK100 DISK210 DISK320 CLI INITIALIZE STRIPE1 CLI ADD UNIT D403 STRIPE1 The next example shows creating a two member striped mirrorset a stripeset whos...

Page 27: ...ADD STRIPESET 2 15 HSZ40 Array Controller CLI Reference Manual See also ADD UNIT ADD MIRRORSET DELETE INITIALIZE SHOW STRIPESET ...

Page 28: ...h containers created from tape drives and loaders The controller target ID must be in the range 0 to 7 and must be one of the IDs set with the SET THIS_CONTROLLER ID and SET OTHER_CONTROLLER ID commands You must leave out the target ID if it is 0 and only use the logical unit number The logical unit number must be in the range 0 to 7 You can assign up to eight logical units for each controller tar...

Page 29: ...RITEBACK_CACHE NOWRITEBACK_CACHE Default 9 9 9 9 __________________________ Note _____________________________ The RUN NORUN switch cannot be specified for partitioned units ____________________________________________________________ PARTITION partition_number The PARTITION switch allows you to set the unit number for a partition on a storageset or single disk unit Use the partition number to ide...

Page 30: ...are valid only for HSZ controllers in dual redundant multiple bus failover configurations The preferred path for units on dual redundant HSZ controllers is determined by the first digit in the unit number the controller target ID specified in the ADD UNIT command ____________________________________________________________ When the failed controller is restarted the drives automatically return to ...

Page 31: ...o satisfy a reconstruct pass or to reconstruct a newly replaced member ____________________________________________________________ The WRITE_PROTECT switch allows you to ensure that data on a unit is not overwritten Select WRITE_PROTECT to prevent write operations to the unit Select NOWRITE_PROTECT to allow both reads and writes to the unit WRITEBACK_CACHE NOWRITEBACK_CACHE Default ______________...

Page 32: ...e write back cache When restarted the controller attempts to flush any unflushed data within write back cache to the devices However by specifying the IGNORE_ERRORS or IMMEDIATE_SHUTDOWN switch you allow data to reside in write back cache when the controller is turned off regardless of any errors detected RAIDsets and mirrorsets require data to be stored in write back cache to accomodate the write...

Page 33: ...UNIT D102 DISK100 PREFERRED_PATH THIS_CONTROLLER To create disk unit D107 from RAIDset RAID9 and enable write back caching for the unit CLI ADD DISK DISK110 1 1 0 CLI ADD DISK DISK210 2 1 0 CLI ADD DISK DISK310 3 1 0 CLI ADD DISK DISK410 4 1 0 CLI ADD RAIDSET RAID9 DISK110 DISK210 DISK310 DISK410 CLI INITIALIZE RAID9 CLI ADD UNIT D107 RAID9 WRITEBACK_CACHE See also CREATE_PARTITION DELETE unit num...

Page 34: ..._______ The controller displays any error messages before the CLI prompt After you correct the error condition you must issue the CLEAR_ERRORS CLI command or restart the controller to clear the error message Format CLEAR_ERRORS CLI Examples To clear the message All NVPM components initialized to their default settings from the CLI prompt CLI All NVPM components initialized to their default setting...

Page 35: ... CLEAR_ERRORS controller INVALID_CACHE data_retention You must completely spell out INVALID_CACHE Parameters controller Identifies the controller for which to clear the INVALID_CACHE condition You must specify either THIS_CONTROLLER or OTHER_CONTROLLER data_retention Specifies whether to keep the cache data and overwrite the controller information NODESTROY_UNFLUSHED_DATA or keep the controller in...

Page 36: ...CLI CLEAR_ERRORS THIS_CONTROLLER INVALID_CACHE NODESTROY_UNFLUSHED_DATA To clear an invalid cache error on the OTHER_CONTROLLER after replacing a cache module CLI CLEAR_ERRORS OTHER_CONTROLLER INVALID_CACHE DESTROY_UNFLUSHED_DATA See also CLEAR_ERRORS CLI CLEAR_ERRORS LOST_DATA CLEAR_ERRORS UNKNOWN CLEAR_ERRORS UNWRITEABLE_DATA ...

Page 37: ...has not been written to disk a LOST DATA error is reported on the unit The CLEAR_ERRORS LOST_DATA command clears the lost data error but does not recover the lost data It may take up to 5 minutes to clear lost data Format CLEAR_ERRORS unit number LOST_DATA You must completely spell out LOST_DATA Parameters unit number Specifies the unit number that will have the lost data error cleared The unit nu...

Page 38: ...is command for the controller to recognize the device after you correct the condition that caused the device to be marked UNKNOWN Format CLEAR_ERRORS device name UNKNOWN You must completely spell out UNKNOWN Parameters device name Specifies the name of the device with the UNKNOWN error Examples To cause the controller to recognize DISK300 a previously UNKNOWN device CLI CLEAR_ERRORS DISK300 UNKNOW...

Page 39: ...writeable data error The CLEAR_ERRORS UNWRITEABLE_DATA command removes the data from the cache and clears the unwriteable data error Format CLEAR_ERRORS unit number UNWRITEABLE_DATA You must completely spell out UNWRITEABLE_DATA Parameters unit number Specifies the unit number that will have the unwriteable data error cleared The unit number is the name given the unit when it was created using the...

Page 40: ...ommand ADD DISK ADD STRIPESET and so forth You can partition any disk stripeset mirrorset striped mirrorset or RAIDset You must initialize the container before creating partitions SIZE percent SIZE LARGEST Specifies the size of the partition to be created as a percentage of the total size of the disk or storageset Specify a percentage of the total container capacity to set the partition to a parti...

Page 41: ... ADD RAIDSET RAID9 DISK100 DISK210 DISK320 CLI INITIALIZE RAID9 CLI CREATE_PARTITION RAID9 SIZE 25 CLI CREATE_PARTITION RAID9 SIZE 25 CLI CREATE_PARTITION RAID9 SIZE 25 CLI CREATE_PARTITION RAID9 SIZE LARGEST CLI ADD UNIT D101 RAID9 PARTITION 1 CLI ADD UNIT D102 RAID9 PARTITION 2 CLI ADD UNIT D103 RAID9 PARTITION 3 CLI ADD UNIT D104 RAID9 PARTITION 4 See also ADD UNIT DELETE unit number DESTROY PA...

Page 42: ... Parameters container name ___________________________Note ____________________________ You cannot delete the spareset and failedset containers ____________________________________________________________ Specifies a name that identifies the container This is the name given the container when it was created using the ADD command ADD DISK ADD STRIPESET and so forth Examples To delete disk drive DIS...

Page 43: ...ice name Deletes a device from the controller configuration Format DELETE device name Parameters device name The name of the device to delete Examples To delete disk device number 120 CLI DELETE DISK120 To delete tape device number 130 CLI DELETE TAPE130 See also SET device name ...

Page 44: ...edset typically before you remove them physically from the shelf for testing repair or replacement You should consider disk drives in the failedset to be defective Test the disk drives then either repair them or replace them Format DELETE FAILEDSET disk name1 Parameters disk name1 The disk drive name to delete from the failedset You can delete one disk at a time from the failedset Examples To dele...

Page 45: ... available to the controller to replace failing members of RAIDsets and mirrorsets Format DELETE SPARESET disk name1 Parameters disk name1 The names of the disk drive to remove from the spareset You can remove one disk at a timefrom the spareset Examples To remove DISK110 from the spareset CLI DELETE SPARESET DISK230 See also ADD SPARESET SHOW SPARESET ...

Page 46: ... deleting the unit If a unit has cache errors you must first clear the errors with the CLEAR_ERRORS UNWRITEABLE_DATA or CLEAR_ERRORS LOST_DATA commands Format DELETE unit number Parameters unit number Specifies the logical unit number that is to be deleted The unit number is the name given the unit when it was created using the ADD UNIT command Examples To delete passthrough unit number 103 CLI DE...

Page 47: ...at you want to destroy This is the name given the disk or storageset when it was created using the ADD command ADD DISK ADD STRIPESET and so forth partition number __________________________ Note _____________________________ Be sure to use the SHOW command to identify the correct partition before using the DESTROY_PARTITION command ____________________________________________________________ The ...

Page 48: ... utilities may not display in the order shown in the example below Format DIRECTORY Examples To display directory listing CLI DIRECTORY DILX V31Z D DSTAT V31Z D VTDPY V31Z D HSUTIL V31Z D C_SWAP V31Z D DIRECT V31Z D CFMENU V31Z D CHVSN V31Z D CLCP V31Z D CLONE V31Z D CONFIG V31Z D FMU V31Z D See also HELP RUN ...

Page 49: ...nd from a remote connection the connection is broken and control is returned to the host When you enter the EXIT command from a local connection the CLI restarts displaying the copyright notice the controller type and the last fail packet Format EXIT Examples To exit from a virtual terminal connection CLI EXIT Control returned to host ...

Page 50: ...int a list of all available commands For further information you may enter a partial command and type a space followed by a to print a list of all available options at that point in the command For example SET THIS_CONTROLLER Prints a list of all legal SET THIS_CONTROLLER commands To get help on the SET command using the facility CLI SET Your options are FAILOVER OTHER_CONTROLLER NOFAILOVER THIS_C...

Page 51: ...essible to the host You must use the INITIALIZE command before you Create a unit from a newly installed disk Create a unit from a newly created RAIDset stripeset or mirrorset You do not need to use the INITIALIZE command when you Create a new unit from the same disks that were previously initialized as another unit such as when a unit is moved Add a RAIDset with the REDUCED switch Format INITIALIZ...

Page 52: ... on each device in the storageset ___________________________Note ____________________________ DIGITAL recommends that the SAVE_CONFIGURATION switch only be used for single controller configurations Use the SET FAILOVER COPY command to save configuration information for dual redundant configurations ____________________________________________________________ Specify NOSAVE_CONFIGURATION for devic...

Page 53: ...efault chunksize CLI ADD DISK DISK110 1 1 0 CLI ADD DISK DISK210 2 1 0 CLI ADD DISK DISK310 3 1 0 CLI ADD STRIPESET STRIPE1 DISK110 DISK210 DISK310 CLI INITIALIZE STRIPE1 CLI ADD UNIT D204 STRIPE1 To initialize RAIDset RAID9 with a chunk size of 20 CLI ADD DISK DISK120 1 2 0 CLI ADD DISK DISK220 2 2 0 CLI ADD DISK DISK320 3 2 0 CLI ADD RAIDSET RAID9 DISK120 DISK220 DISK320 CLI INITIALIZE RAID9 CHU...

Page 54: ...________ Format LOCATE Switches ALL Turns on the amber device fault LEDs of all configured devices This switch also can be used as a lamp test Use LOCATE CANCEL to turn off the LEDs CANCEL Turns off all amber device fault LEDs that were turned on with the LOCATE command DISKS Turns on the amber device fault LEDs of all configured disk drives Use LOCATE CANCEL to turn off the LEDs UNITS Turns on th...

Page 55: ...e Turns on the amber fault LEDs on the devices that make up container name If a device name is given the device s LED is lit If a storageset name is given all device LEDs that make up the storageset are lit Use LOCATE CANCEL to turn off the LEDs unit number Turns on the amber fault LEDs on the devices that make up unit number Use LOCATE CANCEL to turn off the LEDs Examples To turn on the device fa...

Page 56: ...___Note ____________________________ If you MIRROR the members of a stripeset you cannot use the stripeset with any version of controller software prior to Version 2 5 ____________________________________________________________ Specifies the name of the disk to convert to a one member mirrorset The disk must be part of a unit mirrorset name Specifies a name for the mirrorset The name must start w...

Page 57: ...se a replacement device from the spareset that results in the best performance the device should be on a different port than existing members If more than one device in the spareset has the best performance the controller selects the device that most closely matches the size of the remaining members Select NOPOLICY to prevent the controller from replacing a failed disk drive This causes the mirror...

Page 58: ...OR DISK210 MIRROR2 CLI SET MIRROR2 MEMBERSHIP 2 CLI SET MIRROR2 REPLACE DISK320 CLI MIRROR DISK310 MIRROR3 CLI SET MIRROR3 MEMBERSHIP 2 CLI SET MIRROR3 REPLACE DISK120 See also ADD MIRRORSET REDUCE SHOW MIRRORSETS UNMIRROR ...

Page 59: ...plit off a copy of a striped mirrorset you must reduce all mirrorsets at the same time with one command The CLONE program does this automatically The disks to be removed do not need to be members of the same mirrorset However the devices must be part of the same unit for example the same striped mirrorset The controller pauses I O to the unit while it removes the specified mirrorset members ______...

Page 60: ... Storageset Uses Used by STRIPE1 stripeset MIRR1 MIRR2 MIRR3 CLI SHOW MIRRORSETS Name Storageset Uses Used by MIRR1 mirrorset DISK110 STRIPE1 DISK210 MIRR2 mirrorset DISK120 STRIPE1 DISK250 MIRR3 mirrorset DISK330 STRIPE1 DISK420 CLI REDUCE DISK210 DISK250 DISK420 CLI SHOW MIRRORSETS Name Storageset Uses Used by MIRR1 mirrorset DISK110 STRIPE1 MIRR2 mirrorset DISK120 STRIPE1 MIRR3 mirrorset DISK33...

Page 61: ...t start with a letter A Z and can then consist of up to eight more characters made up of letters A Z numbers 0 9 periods dashes or underscores _ for a total of nine characters Examples To rename DISK0 to DISK100 CLI SHOW DISKS Name Type Port Targ Lun Used by DISK0 disk 1 0 0 D100 DISK110 disk 1 1 0 D110 CLI RENAME DISK0 DISK100 CLI SHOW DISKS Name Type Port Targ Lun Used by DISK100 disk 1 0 0 D100...

Page 62: ...ces Do not perform any hardware changes and do not let the cache batteries run down before the controller can flush the cache ____________________________________________________________ IGNORE_ERRORS NOIGNORE_ERRORS Default The IGNORE_ERRORS and NOIGNORE_ERRORS switches instruct the the controller how to respond to write back cache errors _________________________ Caution ________________________...

Page 63: ...______________________________________ Select IMMEDIATE_SHUTDOWN to instruct the controller to run the self test program immediately without checking for online devices or without flushing user data from write back cache to devices Select NOIMMEDIATE_SHUTDOWN to instruct the controller to flush data from write back cache before running the self test program Examples To restart THIS_CONTROLLER as l...

Page 64: ...RITEABLE_DATA command causes the controller to try to write the unwriteable data No data is lost if the retry fails Format RETRY_ERRORS UNWRITEABLE_DATA unit number Parameters unit number Specifies the logical unit number for which to try the write operation The unit number is the name given the unit when it was created using the ADD UNIT command Examples To attempt to write the cached data that w...

Page 65: ...agnostics and utilities only on THIS_CONTROLLER Format RUN program name Parameters program name The name of the diagnostic or utility to be run DILX and CLONE are examples of utilities and diagnostics that can be run from the CLI Examples To run the DILX diagnostic CLI RUN DILX Disk Inline Exerciser version 2 0 See also DIRECTORY ...

Page 66: ...ite back cache until it restarts and is able to write the data to devices Do not perform any hardware changes and do not let the cache batteries run down before the controller can flush the cache ____________________________________________________________ IGNORE_ERRORS NOIGNORE_ERRORS Default The IGNORE_ERRORS and NOIGNORE_ERRORS switches instruct the the controller how to respond to write back c...

Page 67: ..._________________ Select IMMEDIATE_SHUTDOWN to instruct the controller to run the self test program immediately without checking for online devices or without flushing user data from write back cache to devices Select NOIMMEDIATE_SHUTDOWN to instruct the controller to flush data from write back cache before running the self test program Examples To start the self test on THIS_CONTROLLER as long as...

Page 68: ...to and from StorageWorks environments with the data intact ___________________________Note ____________________________ Use the TRANSPORTABLE switch only for disk drives that must be moved to StorageWorks environments with data intact ____________________________________________________________ A TRANSPORTABLE disk drive does not contain any special information space and can be moved to a non Stor...

Page 69: ...this metadata only StorageWorks controllers can retrieve user data from nontransportable disk drives Examples To set DISK130 to transportable CLI SET DISK130 TRANSPORTABLE To limit the data transfer rate to 5MHz for LOADER200 CLI SET LOADER200 TRANSFER_RATE_REQUESTED 5MHZ See also ADD DISK SHOW DISKS ...

Page 70: ...spareset When a disk drive in the failedset is replaced with a factory fresh drive and this feature is enabled the controller automatically removes that disk drive from the failedset and adds it to the spareset where it is available as a hot spare for RAIDsets and mirrorsets Specify AUTOSPARE to enable the feature Specify NOAUTOSPARE to disable the feature Examples To enable the automatic spare fe...

Page 71: ...____Caution____________________________ The device configuration information from the specified controller will overwrite the information on the target controller Make sure you know which controller has the good configuration information before entering this command ____________________________________________________________ Specifies the controller that contains the source configuration for the ...

Page 72: ...controllers into a dual redundant configuration and copy configuration information from the controller running the current CLI session to the other controller CLI SET FAILOVER COPY THIS_CONTROLLER See also SET MULTIBUS_FAILOVER SET NOFAILOVER ...

Page 73: ...rorset until either the new number of members is reached or there are no more suitable disk drives in the spareset If you increase the number of members and autosparing is turned off by specifying NOPOLICY you must use the REPLACE switch to bring the mirrorset up to the new nominal number of members You cannot set the nominal number of members to be lower than the actual number of members Use the ...

Page 74: ... mirrorset will not have a remaining NORMAL or NORMALIZING member after the disk drive is removed an error is reported and no action is taken NORMALIZING members only exist when a mirrorset is first created One member is identified as NORMAL and all other original mirrorset members are marked as NORMALIZING All new data that is written to the mirrorset is written to all members All data on the NOR...

Page 75: ...e READ_SOURCE switch allows you to control which mirrorset member is used by the controller to satisfy a read request Select ROUND_ROBIN to cause the controller to direct read requests to each NORMAL mirrorset member in sequential membership order No preference is given to any NORMAL member Select LEAST_BUSY to cause the controller to direct read requests to the NORMAL mirrorset member with the le...

Page 76: ...BEST_FIT CLI SET MIRR1 POLICY BEST_FIT The following example removes member DISK300 from mirrorset MIRR1 that was created above If the mirrorset has a replacement policy and an acceptable disk drive is in the spareset the controller automatically adds the spare disk drive to the mirrorset CLI SET MIRR1 REMOVE DISK300 To add disk drive DISK320 to the mirrorset MIRR1 CLI SET MIRR1 REPLACE DISK320 A ...

Page 77: ...any attached to the failed controller become available to and accessible through the remaining operational controller __________________________ Note _____________________________ Partitioned storagesets and single disk units cannot function in multiple bus failover You will have to delete your partitions before setting this switch ____________________________________________________________ This ...

Page 78: ...has the good configuration information before entering this command ____________________________________________________________ COPY THIS_CONTROLLER COPY OTHER_CONTROLLER Specifies the controller that contains the source configuration for the copy The other controller will restart when the command is completed Specify THIS_CONTROLLER to copy all the device configuration information from the contr...

Page 79: ... SET THIS_CONTROLLER ID 0 1 2 3 CLI RESTART THIS_CONTROLLER CLI 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 COPY command If you want to prefer specific units to specific controllers use the following command after setting multiple bus failover command CLI SET D100 PREFERRED ...

Page 80: ... of your dual redundant controllers fails before you can properly shut it down with the SET NOFAILOVER or SHUTDOWN commands you will have to use this switch Under some circumstances the data in a failed controller s write back cache may not failover to the operational controller s write back cache For example if the cache battery has failed on the operational controller failover will not jeopardiz...

Page 81: ...eplace the failed controller The unwritten data of the failed controller may reference devices that may not be present in your new configuration If you do not destroy the old configuration data it could conflict with your new configuration and cause your subsystem to behave unpredictably Examples To remove the two controllers from a dual redundant configuration CLI SET NOFAILOVER See also SET FAIL...

Page 82: ...ptions of the switches follow the table Table 2 3 Switches for SET THIS and SET OTHER Command Switch HSZ Values CACHE_FLUSH_TIMER 1 to 65535 sec default CACHE_POLICY a b HOST_FUNCTION A B C D ID 0 7 x4 INITIAL_CONFIGURATION PREFERRED_ID 0 7 x4 PROMPT 1 to 16 characters TERMINAL_PARITY NOTERMINAL_PARITY odd even TERMINAL_SPEED 4800 9600 19200 TIME dd mmm yyy hh mm ss TRANSFER_RATE_REQUESTED asynchr...

Page 83: ...l Changing this policy on one controller in a dual redundant configuration automatically changes it on the other controller You must restart a controller for a new CACHE_POLICY to take effect Regardless of the CACHE_POLICY a low or bad battery affects other controller operations as follows Stripesets and single disk unit units with write back caching enabled are accessed in write through read cach...

Page 84: ...oller can present up to eight units to the host with each target ID Unit numbers identify both the target ID and the unit For example D203 is target 2 LUN 3 D5 is target 0 LUN 5 ____________________________________________________________ If two HSZ controllers are in a dual redundant configuration both controllers have the same IDs When you change the IDs on one controller the other is updated au...

Page 85: ...e the PREFERRED_IDs on one controller the other controller is automatically updated to support the remaining IDs if any Specifying NOPREFERRED_ID for one controller makes it a hot standby The other controller processes all I O during normal operation However if that controller fails the controller with NOPREFERRED_ID would pick up the targets of the failed controller PROMPT new prompt Specifies a ...

Page 86: ...ate to accommodate long cables between the subsystem and the host system Table 2 4 lists the maximum transfer rates for different lengths of fast and slow SCSI buses These lengths represent cable lengths plus shelf bus lengths Table 2 4 Maximum Data Transfer Rates for Different SCSI Bus Cable Lengths Bus type Bus rate Data transfer rate Meters Feet 8 bit single ended 5 MHz 5 MB Sec 6 19 68 8 bit s...

Page 87: ...e device in the spareset has the best performance the controller selects the device that most closely matches the size of the remaining members Select NOPOLICY to prevent the controller from replacing a failed disk drive This causes the RAIDset to run in a reduced state until a BEST_FIT or BEST_PERFORMANCE policy is selected or a member is manually replaced in the RAIDset see SET RAIDset name RECO...

Page 88: ...ACE disk name ___________________________Note ____________________________ You cannot specify any other switches to the SET RAIDset name command when you use the REPLACE switch ____________________________________________________________ Adds a disk drive into a reduced RAIDset A reconstruct operation begins immediately on the new drive The RAIDset must be reduced missing one member and have NOPOL...

Page 89: ...storageset Descriptions of the switches follow the table Table 2 5 Switches for the SET unit number command Switch RAID set Stripe set Mirror set NoTrans Disk Trans Disk CD ROM Pass through MAXIMUM_CACHED_ TRANSFER 9 9 9 9 9 9 PREFERRED_PATH NOPREFERRED_PATH Default 9 9 9 9 9 9 9 READ_CACHE Default NOREAD_CACHE 9 9 9 9 9 9 RUN Default NORUN 9 9 9 9 9 9 WRITE_PROTECT NOWRITE_PROTECT Default 9 9 9 9...

Page 90: ...ration If one controller fails all the devices are accessed through the remaining controller ignoring the PREFERRED_PATH setting ___________________________Note ____________________________ The PREFERRED_PATH and NOPREFERRED_PATH switches are valid only for HSZ controllers in dual redundant multiple bus failover configurations The preferred path for units on dual redundant HSZ controllers is deter...

Page 91: ...CT Default __________________________ Note _____________________________ Write protect disables the writing of any new data by the host However the controller may still write to a write protected RAIDset to satisfy a reconstruct pass or to reconstruct a newly replaced member ____________________________________________________________ The WRITE_PROTECT switch allows you to ensure that data on a un...

Page 92: ...er flushes the data from the write back cache When restarted the controller attempts to flush any unflushed data within write back cache to the devices However by specifying the IGNORE_ERRORS or IMMEDIATE_SHUTDOWN switch you allow data to reside in write back cache when the controller is turned off regardless of any errors detected RAIDsets and mirrorsets require data to be stored in write back ca...

Page 93: ...SET unit number 2 81 HSZ40 Array Controller CLI Reference Manual CLI SET T47 DEFAULT_FORMAT 1600BPI_9TRACK See also SHOW UNITS SHOW unit number ...

Page 94: ...________________________ Format SHOW device type SHOW device name SHOW storageset type SHOW storageset name SHOW UNITS SHOW unit name SHOW THIS_CONTROLLER SHOW OTHER_CONTROLLER Parameters device type Specifies the type of devices that you want to display DEVICES All devices attached to the controller CDROMS All CD ROM devices attached to the controller DISKS All disk drive devices attached to the ...

Page 95: ... drives that have failed out of RAIDsets and mirrorsets storageset name Specifies the name of a particular storageset that you want to display For example SHOW STRIPE1 displays information about the stripeset named STRIPE1 units Displays information for all units configured to the controller unit name Specifies the name of a particular unit that you want to display For example SHOW D102 displays i...

Page 96: ...ABLE TRANSFER_RATE_REQUESTED 10MHZ synchronous 10 MB SEC negotiated Size 4109470 blocks DISK140 disk 1 4 0 S0 DEC RZ28M C DEC 0616 Switches NOTRANSPORTABLE TRANSFER_RATE_REQUESTED 10MHZ synchronous 10 MB SEC negotiated Size 4109470 blocks DISK200 disk 2 0 0 D501 DEC RZ28 C DEC 435E Switches NOTRANSPORTABLE TRANSFER_RATE_REQUESTED 10MHZ synchronous 10 MB SEC negotiated Size 4109470 blocks DISK220 d...

Page 97: ...LER FULL Controller HSZ40 CX C ZG60300054 Firmware V31Z 0 Hardware 0000 Not configured for dual redundancy SCSI address 6 Time NOT SET Host port SCSI target s 4 5 Preferred target s 5 TRANSFER_RATE_REQUESTED ASYNCHRONOUS Cache No cache Host Functionality Mode A Licensing information RAID RAID Option is ENABLED license key is VALID WBCA Writeback Cache Option is ENABLED license key is VALID MIRR Di...

Page 98: ...he until it restarts and is able to write the data to devices Do not perform any hardware changes and do not let the cache batteries run down before the controller can flush the cache ____________________________________________________________ IGNORE_ERRORS NOIGNORE_ERRORS Default The IGNORE_ERRORS and NOIGNORE_ERRORS switches instruct the the controller how to respond to write back cache errors ...

Page 99: ...________________________________________ Select IMMEDIATE_SHUTDOWN to instruct the controller to run the self test program immediately without checking for online devices or without flushing user data from write back cache to devices Select NOIMMEDIATE_SHUTDOWN to instruct the controller to flush data from write back cache before running the self test program Examples To shut down THIS_CONTROLLER ...

Page 100: ...ity is limited to the size of the smallest member larger members will have unused capacity If a member with unused capacity is the last remaining member of a mirrorset you cannot use the UNMIRROR command to change the device back to a single disk unit because that change would cause a change in reported disk capacity possibly confusing the operating system Format UNMIRROR disk name Parameter disk ...

Page 101: ...HSZ40 Array Controller CLI Reference Manual Glossary ...

Page 102: ...e a replacement block mark the bad block as replaced and move the data from the bad block to the replacement block BBU Battery backup unit A StorageWorks SBB option that extends power availability after the loss of primary ac power or a power supply to protect against the corruption or loss of data block The smallest data unit addressable on a disk Also called a sector In integrated storage elemen...

Page 103: ...res A differential bus is more robust and less subject to electrical noise than is a single ended bus DILX Disk inline exerciser Diagnostic firmware used to test the data transfer capabilities of disk drives in a way that simulates a high level of user activity DSA DIGITAL storage architecture A set of specifications and interfaces describing standards for designing mass storage products DSA defin...

Page 104: ...ECC allows for location and correction of an error in the received retrieved data All ECCs have limited correction power EDC Error detection code One or more checksum words that allow detection of a mismatch between transmitted and received data in a communications system or between stored and retrieved data in a storage system The EDC has no data correction capability ESD Electrostatic discharge ...

Page 105: ...normally mounted in the upper part of the carrier HBVS Host based volume shadowing Also known as Phase 2 volume shadowing HSOF Hierarchical storage operating firmware Software contained on a program card that provides the logic for the HS array controllers HIS Host interconnect services The firmware in the HS array controller that communicates with the host host Any computer to which a storage sub...

Page 106: ... addressable through a target LUNs use their target s bus connection to communicate on the SCSI bus maintenance terminal Any EIA 423 compatible terminal to be plugged into the HS controller This terminal is used to identify the controller enable host paths define the configuration and check controller status It is not required for normal operations It is sometimes referred to as a local terminal m...

Page 107: ...describe memory that can retain data during a power loss to the controller partition A percentage of a storageset or single disk unit that may be presented to the host as a storage unit partitioning Device partitioning is the process of dividing up a single large container into a number of smaller containers port The hardware and software used to connect a host controller to a communication bus su...

Page 108: ...t read cache The cache used to accelerate read operations by retaining data which has been previously read written or erased based on a prediction that it will be reread replacement policy The method by which a spare disk is selected to replace a disk that has failed in a RAIDset SBB StorageWorks building block A modular carrier plus the individual mechanical and electromechanical interface requir...

Page 109: ...erred to as a target ID SCSI A cable A 50 conductor 25 twisted pair cable used for single ended SCSI bus connections SCSI P cable A 68 conductor 34 twisted pair cable used for differential bus connections Small Computer System Interface See SCSI spareset A pool of disk drives used by the controller to replace failed members of a RAIDset SPD Software product description A document that contains the...

Page 110: ...eature that allows a device to have multiple I O requests outstanding to it at one time target A SCSI device that performs an operation requested by an initiator The target number is determined by the device s address on its SCSI bus TILX Tape inline exerciser Diagnostic firmware used to test the data transfer capabilities of tape drives in a way that simulates a high level of user activity TMSCP ...

Page 111: ...the user s perspective the write operation is complete when the data is stored in the cache memory This strategy avoids unnecessary access of the devices write hole Undetectable RAID level 1 or 5 data corruption A write hole is caused by the successful writing of some but not all of the storageset members Write holes occur under conditions such as power outages where the writing of multiple member...

Page 112: ......

Page 113: ...6 AUTOMATIC SPARE POLICY 2 58 B Battery policy 2 71 C Cables SCSI bus cable lengths 2 74 Cache clearing invalid cache errors 2 23 enabling disabling read cache 2 18 2 79 enabling disabling write back cache 2 19 2 80 flush timer 2 71 setting maximum transfer size 2 17 2 79 CD ROM adding to controller 2 2 deleting 2 30 displaying information 2 83 showing 2 83 Chunksize 2 39 CLEAR_ERRORS CLI command ...

Page 114: ...EDUCE 2 47 RENAME 2 49 RESTART OTHER_CONTROLLER 2 50 RESTART THIS_CONTROLLER 2 50 RETRY_ERRORS 2 52 RUN 2 53 SELFTEST 2 54 SET device name 2 56 SET FAILEDSET 2 58 SET FAILOVER 2 59 SET mirrorset name 2 61 SET MULTIBUS_FAILOVER 2 65 SET NOFAILOVER 2 68 SET OTHER_CONTROLLER 2 70 SET RAIDset name 2 76 SET THIS_CONTROLLER 2 70 SET unit number 2 78 SHOW 2 83 SHUTDOWN OTHER_CONTROLLER 2 87 SHUTDOWN THIS...

Page 115: ...56 mirroring 2 44 moving to non Brand environments 2 3 2 56 moving with data intact 2 3 2 56 removing from a failedset 2 32 removing from a mirrorset 2 47 2 61 removing from a RAIDset 2 77 removing from a spareset 2 33 renaming 2 49 showing 2 83 Dual redundant configuration 1 3 disabling 2 68 enabling 2 59 DUP connection 1 3 E Error messages clearing from CLI 2 22 clearing invalid cache 2 23 clear...

Page 116: ...rs 2 47 2 61 renaming 2 49 setting a replacement policy 2 6 setting the actual number of members 2 5 setting the copying speed 2 5 2 45 2 63 setting the read source 2 6 2 63 showing 2 83 striping 2 14 unmirror 2 89 Moving disk drives 2 3 2 56 N normal mirrorset member defined 2 5 2 44 2 63 O Optical disk drive deleting 2 30 displaying information 2 83 showing 2 83 OTHER_CONTROLLER CHANGING PARAMET...

Page 117: ...mmand 2 56 SET FAILEDSET command 2 58 SET FAILOVER command 2 59 SET mirrorset name command 2 61 SET MULTIBUS_FAILOVER command 2 65 SET NOFAILOVER command 2 68 SET OTHER_CONTROLLER command 2 70 SET RAIDset name command 2 76 SET THIS_CONTROLLER command 2 70 SET unit number command 2 78 Setting controller preferred SCSI target IDs 2 73 controller SCSI target IDs 2 72 device data transfer rate 2 56 Ho...

Page 118: ...nit adding 2 16 changing characteristics 2 78 clearing lost data error 2 25 deleting from the configuration 2 34 displaying configured units 2 84 displaying information 2 83 enabling disabling host availability 2 18 2 80 enabling disabling read cache 2 18 2 79 enabling disabling write back cache 2 19 2 80 mirroring 2 44 numbering 2 16 setting write protection 2 19 2 80 showing 2 83 specifying a pr...

Reviews: