1. Manuals
  2. Brands
  3. Digital Equipment Manuals
  4. Controller
  5. HSZ40
  6. Reference manual

Digital Equipment HSZ40 Reference Manual

Array controller
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
DIGITAL StorageWorks
HSZ40 Array Controller
HSOF 3.1
CLI Reference Manual
Part Number: EK–CLI40–RM. B01
March 1997
Software Version:
HSOF Version 3.1
Digital Equipment Corporation
Maynard, Massachusetts

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the HSZ40 and is the answer not in the manual?

Questions and answers

Related Manuals for Digital Equipment HSZ40

Summary of Contents for Digital Equipment HSZ40

  • Page 1 DIGITAL StorageWorks HSZ40 Array Controller HSOF 3.1 CLI Reference Manual Part Number: EK–CLI40–RM. B01 March 1997 Software Version: HSOF Version 3.1 Digital Equipment Corporation Maynard, Massachusetts...
  • Page 2 March 1997 While Digital Equipment Corporation believes the information included in this manual is correct as of the date of publication, it is subject to change without notice. DIGITAL makes no representations that the interconnection of its products in the manner described in this document will not infringe existing or future patent rights, nor do the descriptions contained in this document imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.

  • Page 3: Table Of Contents

    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 DELETE FAILEDSET..................2–32 HSZ40 Array Controller CLI Reference Manual...
  • Page 4 SET unit-number....................2–77 SHOW ........................2–82 SHUTDOWN THIS_CONTROLLER and SHUTDOWN OTHER_CONTROLLER2–86 UNMIRROR......................2–88 Glossary Index Figures Figure 1–1 Identifying T ......1–2 CONTROLLER THER CONTROLLER Figure 2–1 Controller Connections in Multiple Bus Failover Configuration ..2–66 CLI Reference Manual HSZ40 Array Controller...
  • Page 5 Technology Board Polycenter Console Manager User's Guide Computer Associates VAXcluster Systems Guidelines for VAXcluster EK–VAXCS–CG System Configurations 16-Bit SBB User’s Guide EK-SBB16-UG 7-Bit SBB Shelf (BA356 Series) User’s Guide EK-BA356-UG SBB User’s Guide EK-SBB35-UG HSZ40 Array Controller CLI Reference Manual...

  • Page 7: Introduction To The Cli

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

  • Page 8: Cli Overview

    Figure 1–1 Identifying T CONTROLLER THER CONTROLLER OTHER_CONTROLLER THIS_CONTROLLER CXO-5193A-MC always refers to the controller that is not running the current CLI THER CONTROLLER sessionthe one that is not connected to a terminal or terminal session. CLI Reference Manual HSZ40 Array Controller...

  • Page 9: Accessing And Exiting The Cli

    If you are using a remote DUP connection to the CLI, enter the command at the CLI EXIT prompt to close the connection. You do not need to exit from a local connection. HSZ40 Array Controller CLI Reference Manual...

  • Page 10: Capturing Your Cli Session

    Overstrike mode replaces existing characters when you type. The CLI returns to insert mode at the beginning of each line. Ctrl/R Recalls the contents of the command line. This is especially helpful if the system issues a message that interrupts your typing. CLI Reference Manual HSZ40 Array Controller...

  • Page 11: Specifying The Device Ptl

    PTL address. An example of a PTL address follows: 1 02 00 __________________________ Note _____________________________ ® DIGITAL UNIX requires passthrough units to be at LUN 0. OpenVMS accepts LUN numbers 0 through 7. ____________________________________________________________ HSZ40 Array Controller CLI Reference Manual...

  • Page 12: Syntax

    Parameter—The object that receives the command and is assigned the task of processing the command. 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. CLI Reference Manual HSZ40 Array Controller...

  • Page 13: Cli Commands

    CLI Commands Descriptions of all CLI Commands Required Parameters Optional Switches Examples...

  • Page 14: Add Cdrom

    2–2 ADD CDROM ADD CDROM Adds a CD–ROM drive to the controller configuration and names the drive. Format ADD CDROM CDROM-name SCSI-location Parameters CDROM-name Specifies a name for the CD−ROM drive. You use this name with the command ADD UNIT to identify the CD−ROM drive as a host-addressable unit.

  • Page 15: Add Disk

    The controller makes a small portion of nontransportable disk drives inaccessible to the host and uses the space to store information (metadata) that improves data reliability, error detection, and recovery. Because of this metadata, only StorageWorks controllers can retrieve user data from nontransportable disk drives. HSZ40 Array Controller CLI Reference Manual...
  • Page 16 2–4 ADD DISK Examples To add 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...

  • Page 17: Add Mirrorset

    Select when the copy operation must take precedence over other controller FAST operations. The controller uses more resources and the copy takes less time, but overall controller performance is reduced during the copy. HSZ40 Array Controller CLI Reference Manual...
  • Page 18 2–6 ADD MIRRORSET POLICY=BEST_FIT POLICY=BEST_PERFORMANCE (Default) NOPOLICY switch allows you to set the criteria the controller uses to choose a replacement POLICY member from the spareset when a mirrorset member fails. Select to choose a replacement device from the spareset that most closely BEST matches the capacities of the remaining members.
  • Page 19 ADD MIRRORSET 2–7 See also ADD DISK DELETE INITIALIZE MIRROR REDUCE SHOW MIRRORSETS UNMIRROR HSZ40 Array Controller CLI Reference Manual...

  • Page 20: Add Passthrough

    2–8 ADD PASSTHROUGH ADD PASSTHROUGH Creates a passthrough container (command disk) to allow direct access to a device. HSZ controllers use passthrough containers to communicate with tape drives and tape loaders. Format For tape drives and loaders attached to HSZ controllers: ADD PASSTHROUGH passthrough-name SCSI-location Parameters passthrough-name...
  • Page 21 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 HSZ40 Array Controller CLI Reference Manual...

  • Page 22: Add Raidset

    2–10 ADD RAIDSET ADD RAIDSET Creates a RAIDset from 3 to 14 disks. Format ADD RAIDSET RAIDset-name disk-name1 disk-name2 [disk-nameN] Parameters RAIDset-name Specifies a name for the RAIDset. You use this name with the command to ADD UNIT identify the RAIDset as a host-addressable unit. 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 of nine characters.
  • Page 23 CLI> ADD DISK DISK100 1 3 0 CLI> ADD DISK DISK210 2 4 0 CLI> ADD DISK DISK320 3 5 0 CLI> ADD RAIDSET RAID6 DISK130 DISK240 DISK350 REDUCED CLI> ADD UNIT D205 RAID6 HSZ40 Array Controller CLI Reference Manual...
  • Page 24 2–12 ADD RAIDSET See also ADD UNIT DELETE SET RAIDSET SHOW RAIDSET INITIALIZE...

  • Page 25: Add Spareset

    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 FAILEDSET SHOW SPARESET HSZ40 Array Controller CLI Reference Manual...

  • Page 26: Add Stripeset

    2–14 ADD STRIPESET ADD STRIPESET Creates a stripeset out of 2 to 14 disks or mirrorsets. Format ADD STRIPESET stripeset-name container-name1 [container-nameN] Parameters stripeset-name Specifies a name for the stripeset. You use this name with the command to ADD UNIT identify the stripeset as a host-addressable unit.
  • Page 27 ADD STRIPESET 2–15 See also ADD UNIT ADD MIRRORSET DELETE INITIALIZE SHOW STRIPESET HSZ40 Array Controller CLI Reference Manual...

  • Page 28: Add Unit

    2–16 ADD UNIT ADD UNIT Identifies a device, container, or partition as a host-addressable logical unit. The controller maps all requests from the host to the logical unit number as requests to the container specified in the ADD UNIT command. You must initialize the disk drive or container before you can add it as a unit.
  • Page 29 MAXIMUM_CACHED_TRANSFER=32 (Default) switch allows you to set the largest transfer (in blocks) MAXIMUM CACHED TRANSFER to be cached by the controller. The controller will not cache any transfers over this size. Valid values are 1–1024. HSZ40 Array Controller CLI Reference Manual...
  • Page 30 2–18 ADD UNIT PREFERRED_PATH=THIS_CONTROLLER PREFERRED_PATH=OTHER_CONTROLLER NOPREFERRED_PATH (Default) ___________________________ Note ____________________________ All partitions on a container must be addressed through the same controller. If you set for one partition, all partitions on that container will PREFERRED PATH inherit the same path. ____________________________________________________________ switch allows you to balance I/O load by specifying the controller PREFERRED...
  • Page 31 Select for all new RAIDsets and mirrorsets, and for all other units for WRITEBACK CACHE which you want this feature. The write-back cache improves performance for write operations to the unit. HSZ40 Array Controller CLI Reference Manual...
  • Page 32 2–20 ADD UNIT ___________________________ Note ____________________________ It may take up to 5 minutes for the controller to flush unwritten data from the cache once you disable write-back caching. ____________________________________________________________ Select for those units for which you want all writes to go directly to NOWRITEBACK CACHE devices without being cached.
  • Page 33 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-number SET unit-number SHOW UNITS HSZ40 Array Controller CLI Reference Manual...

  • Page 34: Clear_Errors Cli

    2–22 CLEAR_ERRORS CLI CLEAR_ERRORS CLI Stops the display of current or previous error messages at the CLI prompt. ___________________________ Note ____________________________ This command does not clear the error conditions, it only stops displaying the errors at the CLI prompt. ____________________________________________________________ The controller displays any error messages before the CLI prompt.

  • Page 35: Clear_Errors Invalid_Cache

    You removed the cache module while there was unflushed data. Use the parameter in the following situations: DESTROY UNFLUSHED DATA • You have replaced the cache module. • Any other reason not listed above. HSZ40 Array Controller CLI Reference Manual...
  • Page 36 2–24 CLEAR_ERRORS INVALID_CACHE Examples To clear an invalid cache error on T after replacing a controller module: CONTROLLER CLI> CLEAR_ERRORS THIS_CONTROLLER INVALID_CACHE NODESTROY_UNFLUSHED_DATA To clear an invalid cache error on the O after replacing a cache module: THER CONTROLLER CLI> CLEAR_ERRORS OTHER_CONTROLLER INVALID_CACHE DESTROY_UNFLUSHED_DATA See also CLEAR_ERRORS CLI...

  • Page 37: Clear_Errors Lost_Data

    ADD UNIT Examples To clear the lost data error on disk unit D103: CLI> CLEAR_ERRORS D103 LOST_DATA See also CLEAR_ERRORS CLI CLEAR_ERRORS INVALID_CACHE CLEAR_ERRORS UNKNOWN CLEAR_ERRORS UNWRITEABLE_DATA HSZ40 Array Controller CLI Reference Manual...

  • Page 38: Clear_Errors Unknown

    2–26 CLEAR_ERRORS UNKNOWN CLEAR_ERRORS UNKNOWN Clears the UNKNOWN error from a device. If a device has a failure such that the controller marks the device as UNKNOWN, the controller does not check the device again to see if it has been repaired or if the failure condition has been rectified.
  • Page 39 ADD UNIT Examples To clear the unwriteable data error on disk unit D103: CLI> CLEAR_ERRORS D103 UNWRITEABLE_DATA See also CLEAR_ERRORS CLI CLEAR_ERRORS INVALID_CACHE CLEAR_ERRORS LOST_DATA CLEAR_ERRORS UNKNOWN RETRY_ERRORS UNWRITEABLE_DATA HSZ40 Array Controller CLI Reference Manual...

  • Page 40: Create_Partition

    2–28 CREATE_PARTITION CREATE_PARTITION Marks part of a disk or storageset to be used as a separately addressable unit. You can divide any disk or storageset into as many as six partitions, each of which can be separately presented to the host. Format CREATE_PARTITION container-name SIZE= n Parameters...
  • Page 41 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 PARTITION SHOW HSZ40 Array Controller CLI Reference Manual...

  • Page 42: Delete Container-Name

    2–30 DELETE container-name DELETE container-name Deletes a container from the list of known containers. You cannot delete a container that is in use by a higher-level container. For example, you cannot delete a disk that is a member of a RAIDset, or a RAIDset that is declared as a unit. You must first delete the higher- level containers.

  • Page 43: Delete Device-Name

    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 HSZ40 Array Controller CLI Reference Manual...

  • Page 44: Delete Failedset

    2–32 DELETE FAILEDSET DELETE FAILEDSET Removes a disk drive from the failedset. The failedset contains the drives that were removed from RAIDsets and mirrorsets either because they failed or were manually removed via the command. The command removes disk drives from DELETE FAILEDSET the failedset, typically before you remove them physically from the shelf for testing, repair, or replacement.

  • Page 45: Delete Spareset

    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 HSZ40 Array Controller CLI Reference Manual...

  • Page 46: Delete Unit-Number

    2–34 DELETE unit-number DELETE unit-number Deletes a logical unit from the controller configuration. The device, storageset, or partition will no longer be addressable by the host. If write-back caching was enabled for the unit, the controller flushes any user data from the cache to the devices before deleting the unit.

  • Page 47: Destroy_Partition

    SHOW find partition numbers. Examples To delete the unit for partition 2 on RAIDset RAID9 and destroy the partition: CLI> DELETE D102 CLI> DESTROY_PARTITION RAID9 PARTITION=2 See also CREATE_PARTITION DELETE unit-number SHOW HSZ40 Array Controller CLI Reference Manual...

  • Page 48: Directory

    2–36 DIRECTORY DIRECTORY Lists the diagnostics and utilities available on T . The diagnostics and CONTROLLER utilities may not display in the order shown in the example below. Format DIRECTORY Examples To display directory listing: CLI> DIRECTORY DILX V31Z DSTAT V31Z VTDPY V31Z...

  • Page 49: Exit

    EXIT 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 HSZ40 Array Controller CLI Reference Manual...

  • Page 50: Help

    2–38 HELP HELP Displays a brief description of using the question mark (?) to obtain help on any command or CLI function. Format HELP Examples To see help about using the HELP command: CLI> HELP Help may be requested by typing a question mark (?) at the CLI prompt.

  • Page 51: Initialize

    Specifies the chunksize to be used for RAIDsets and stripesets. You can specify the chunk size in blocks ( =n), or you can let the controller determine the optimal chunk CHUNKSIZE size ( ). The switch does not apply to mirrorsets. CHUNKSIZE DEFAULT CHUNKSIZE HSZ40 Array Controller CLI Reference Manual...
  • Page 52 ONFIGURATION perform inter-platform conversions. For example, you cannot use S ONFIGURATION to upgrade from HSOF V3.1 to V5.1 or from an HSZ40 array controller to an HSZ50 array controller.
  • Page 53 CLI> ADD UNIT D301 RAID9 To initialize DISK440 and preserve the data after removing it ( ) from a mirrorset: REDUCE CLI> REDUCE DISK440 CLI> INITIALIZE DISK440 NODESTROY CLI> ADD UNIT D201 DISK440 See also ADD UNIT HSZ40 Array Controller CLI Reference Manual...

  • Page 54: Locate

    2–42 LOCATE LOCATE Identifies configured units, storagesets, and devices by flashing the amber device fault LED on the front of the StorageWorks building block (SBB). The device fault LED will flash once per second until turned off with the command. You also can use LOCATE CANCEL command as a lamp test.
  • Page 55 To turn on the device fault LEDs on all devices that make up disk unit number 102: CLI> LOCATE D102 To turn on the device fault LEDs on all configured disk devices: CLI> LOCATE DISKS To turn off the device fault LEDs on all devices: CLI> LOCATE CANCEL HSZ40 Array Controller CLI Reference Manual...

  • Page 56: Mirror

    2–44 MIRROR MIRROR Creates a one-member mirrorset from a single disk. Use this command on devices that are already members of higher level containers (stripesets or units). Use the ADD MIRRORSET command to create a mirrorset from devices that are not already members of higher level containers.
  • Page 57 CLI> ADD DISK DISK310 3 1 0 CLI> ADD STRIPESET STRIPE1 DISK110 DISK210 DISK310 LI> INITIALIZE STRIPE1 CLI> ADD UNIT D102 STRIPE1 CLI> MIRROR DISK110 MIRROR1 CLI> SET MIRROR1 MEMBERSHIP=2 CLI> SET MIRROR1 REPLACE=DISK220 HSZ40 Array Controller CLI Reference Manual...
  • Page 58 2–46 MIRROR CLI> MIRROR 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: Reduce

    Note that for each mirrorset that you reduce, there must be at least one remaining NORMAL member after the reduction. If this is not true for all disk-names specified, then none of the mirrorsets are reduced. Format REDUCE disk-name1 [disk-nameN] HSZ40 Array Controller CLI Reference Manual...
  • Page 60 2–48 REDUCE Parameters disk-name1 The name of the mirrorset member to be removed. NORMAL [disk-nameN] The name of additional mirrorset members to be removed from the same unit. NORMAL Examples To remove DISK210, DISK250, and DISK420 from their respective mirrorsets: CLI>...

  • Page 61: Rename

    CLI> SHOW DISKS Name Type Port Targ Used by ----------------------------------------------------------- DISK0 disk D100 DISK110 disk D110 CLI> RENAME DISK0 DISK100 CLI> SHOW DISKS Name Type Port Targ Used by ----------------------------------------------------------- DISK100 disk D100 DISK110 disk D110 HSZ40 Array Controller CLI Reference Manual...

  • Page 62: Restart This_Controller And Restart Other_Controller

    2–50 RESTART THIS_CONTROLLER and RESTART OTHER_CONTROLLER RESTART THIS_CONTROLLER and RESTART OTHER_CONTROLLER Flushes all user data from the specified controller's write-back cache (if present) and restarts the controller. is the controller that is running the current CLI THIS CONTROLLER session. The O is the controller that is not running the current CLI THER CONTROLLER...
  • Page 63 CONTROLLER CLI> RESTART THIS_CONTROLLER To restart the O even if there are units online to the THER CONTROLLER THER CONTROLLER CLI> RESTART OTHER_CONTROLLER OVERRIDE_ONLINE See also SELFTEST OTHER_CONTROLLER SELFTEST THIS_CONTROLLER SHUTDOWN OTHER_CONTROLLER SHUTDOWN THIS_CONTROLLER HSZ40 Array Controller CLI Reference Manual...

  • Page 64: Retry_Errors Unwriteable_Data

    2–52 RETRY_ERRORS UNWRITEABLE_DATA RETRY_ERRORS UNWRITEABLE_DATA If a container fails in a way that data in the write-back cache cannot be written to the container, an unwriteable data error is reported. If possible, correct the condition that is causing the unwriteable data and try the write operation again. The RETRY ERRORS command causes the controller to try to write the unwriteable data.

  • Page 65: Run

    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 HSZ40 Array Controller CLI Reference Manual...

  • Page 66: Selftest Other_Controller And Selftest This_Controller

    2–54 SELFTEST OTHER_CONTROLLER and SELFTEST THIS_CONTROLLER SELFTEST OTHER_CONTROLLER and SELFTEST THIS_CONTROLLER Flushes all user data from the specified controller's write-back cache (if present) and shuts down the controller, then restarts it in self-test mode. You must press the controller reset (//) button to take the controller out of self-test mode.
  • Page 67 To start the self-test on the O even if the controller cannot flush all data THER CONTROLLER from the write-back cache: CLI> SELFTEST OTHER_CONTROLLER IGNORE_ERRORS See also RESTART OTHER_CONTROLLER RESTART THIS_CONTROLLER SHUTDOWN OTHER_CONTROLLER SHUTDOWN THIS_CONTROLLER HSZ40 Array Controller CLI Reference Manual...

  • Page 68: Set Device-Name

    2–56 SET device-name SET device-name Changes the transportable characteristics of a disk drive, or sets the maximum data transfer rate between the controller and a device. Format SET device-name Parameters device-name The name of the device to change. Switches TRANSFER_RATE_REQUESTED=ASYNCHRONOUS TRANSFER_RATE_REQUESTED=DEFAULT (Default: 10MHZ) TRANSFER_RATE_REQUESTED=10MHZ TRANSFER_RATE_REQUESTED=5MHZ...
  • Page 69 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 HSZ40 Array Controller CLI Reference Manual...

  • Page 70: Set Failedset

    2–58 SET FAILEDSET SET FAILEDSET Changes the automatic spare policy for the failedset. Format SET FAILEDSET Switches AUTOSPARE NOAUTOSPARE (Default) switch allows you to enable automatic moving of replaced disk drives AUTOSPARE from the failedset to the 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.

  • Page 71: Set Failover

    (the controller CONTROLLER that is running the current CLI session). Due to the amount of information that must be passed between the two controllers, this command may take up to 1 minute to complete. HSZ40 Array Controller CLI Reference Manual...
  • Page 72 2–60 SET FAILOVER Examples To place the 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: Set Mirrorset-Name

    Adds a disk member into an existing mirrorset provided the following conditions are met: • The replacement policy is set to NOPOLICY • The nominal number of members is greater than the actual number of members. HSZ40 Array Controller CLI Reference Manual...
  • Page 74 2–62 SET mirrorset-name • The disk member to be replaced is as large as the existing members of the mirrorset. If these conditions are met, the device specified by disk-name is added to the mirrorset specified by mirrorset-name. The nominal number of members does not change. REMOVE=disk-name ___________________________ Note ____________________________ You cannot specify any other switches to the...
  • Page 75 Select to prioritize other controller operations over the copy operation. The NORMAL controller uses relatively few resources to perform the copy, and there is little impact on performance. HSZ40 Array Controller CLI Reference Manual...
  • Page 76 2–64 SET mirrorset-name Select when the copy operation must take precedence over other controller FAST operations. The controller uses more resources and the copy takes less time, but overall controller performance is reduced during the copy. Examples To change the replacement policy of mirrorset MIRR1 to BEST CLI>...

  • Page 77: Set Multibus_Failover

    Figure 2–1. The host operating system must be configured to recognize that all units can be accessed through either adapter/controller. If your host operating system does not support such a configuration, use the command instead. SET FAILOVER HSZ40 Array Controller CLI Reference Manual...

  • Page 78: Figure 2-1 Controller Connections In Multiple Bus Failover Configuration

    2–66 SET MULTIBUS_FAILOVER Figure 2–1 Controller Connections in Multiple Bus Failover Configuration Host system S C S I S C S I a d a p t e r a d a p te r S C S I b u s A S C S I b u s B CXO-5227A-MC Format...
  • Page 79 FAILOVER COPY want to prefer specific units to specific controllers, use the following command after setting multiple bus failover command: CLI> SET D100 PREFERRED=THIS_CONTROLLER CLI> SET D101 PREFERRED=OTHER_CONTROLLER See also SET FAILOVER SET NOFAILOVER HSZ40 Array Controller CLI Reference Manual...

  • Page 80: Set Nofailover (Set Nomultibus_Failover)

    2–68 SET NOFAILOVER (SET NOMULTIBUS_FAILOVER) SET NOFAILOVER (SET NOMULTIBUS_FAILOVER) Takes T and O (if reachable) out of dual-redundant CONTROLLER THER CONTROLLER (failover) mode. Immediately after entering this command, you should remove one controller from the shelf because the sharing of devices is not supported by nonredundant controllers.
  • Page 81 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 FAILOVER HSZ40 Array Controller CLI Reference Manual...

  • Page 82: Set This_Controller And Set Other_Controller

    2–70 SET THIS_CONTROLLER and SET OTHER_CONTROLLER SET THIS_CONTROLLER and SET OTHER_CONTROLLER Changes parameters on the specified controller. T is the controller that is CONTROLLER running the current CLI session. The O is the controller that is not THER CONTROLLER running the current CLI session. Format SET THIS_CONTROLLER SET OTHER_CONTROLLER...

  • Page 83: Set This_Controller And Set Other_Controller

    • If the batteries are bad or missing, RAIDsets and mirrorsets are made inoperative. • Write-back caching automatically resumes when the cache batteries are fully recharged or replaced. HSZ40 Array Controller CLI Reference Manual...
  • Page 84 2–72 SET THIS_CONTROLLER and SET OTHER_CONTROLLER HOST_FUNCTION=(ID, mode) Sets the host compatibility mode for a controller target ID. Each controller or pair of dual- redundant controllers can service two host modes simultaneously. You must repeat the command if you want to set different modes for each target ID, such as to support hosts with different operating systems on a single SCSI bus.
  • Page 85 Specifies the parity transmitted and expected. TERMINAL_SPEED=baud_rate Sets the terminal speed to 4800, 9600 (default), or 19200. TIME=dd-mmm-yyyy:hh:mm:ss switch sets the date and time. The time is set on both controllers in a dual- TIME redundant configuration. HSZ40 Array Controller CLI Reference Manual...
  • Page 86 2–74 SET THIS_CONTROLLER and SET OTHER_CONTROLLER TRANSFER_RATE_REQUESTED=ASYNCHRONOUS TRANSFER_RATE_REQUESTED=DEFAULT (Default: 10MHz) TRANSFER_RATE_REQUESTED=10MHZ TRANSFER_RATE_REQUESTED=5MHZ ___________________________ Note ____________________________ Set the same transfer rate for both controllers in a dual-redundant configuration. ____________________________________________________________ Specifies the maximum data transfer rate that HSZ controllers use when communicating with a SCSI host.

  • Page 87: Set Raidset-Name

    Select when the reconstruct operation must take precedence over other controller FAST operations. The controller uses more resources and the reconstruct takes less time, but overall controller performance is reduced during the reconstruct. HSZ40 Array Controller CLI Reference Manual...
  • Page 88 2–76 SET RAIDset-name REMOVE=disk-name ___________________________ Note ____________________________ You cannot specify any other switches to the set-name command when SET RAID you use the switch. REMOVE ____________________________________________________________ Removes a disk member from a RAIDset and adds it to the failedset. If the RAIDset is already in a reduced state, an error is displayed and the command is not carried out.

  • Page 89: Set Unit-Number

    Disk MAXIMUM_CACHED_ TRANSFER ' ' ' PREFERRED_PATH NOPREFERRED_PATH (Default) READ_CACHE (Default) NOREAD_CACHE RUN (Default) NORUN WRITE_PROTECT NOWRITE_PROTECT (Default) WRITEBACK_CACHE NOWRITEBACK_CACHE (Default) __________________________ Note _____________________________ The RUN/NORUN switch cannot be specified on partitioned units. ____________________________________________________________ HSZ40 Array Controller CLI Reference Manual...
  • Page 90 2–78 SET unit-number MAXIMUM_CACHED_TRANSFER=n MAXIMUM_CACHED_TRANSFER=32 (Default) switch allows you to set the largest transfer (in blocks) MAXIMUM CACHED TRANSFER to be cached by the controller. The controller will not cache any transfers over this size. Valid values are 1–1024. PREFERRED_PATH=THIS_CONTROLLER PREFERRED_PATH=OTHER_CONTROLLER NOPREFERRED_PATH (Default) ___________________________ Note ____________________________...
  • Page 91 RITEBACK CACHE subsystem and that the licensed feature be enabled through FLS. ____________________________________________________________ switch allows you to enable or disable the use of write-back cache WRITEBACK CACHE with a unit. HSZ40 Array Controller CLI Reference Manual...
  • Page 92 2–80 SET unit-number Select for all new RAIDsets and mirrorsets, and for all other units for WRITEBACK CACHE which you want this feature. The write-back cache improves performance for write operations to the unit. ___________________________ Note ____________________________ It may take up to 5 minutes for the controller to flush unwritten data from the cache once you disable write-back caching.
  • Page 93 SET unit-number 2–81 CLI> SET T47 DEFAULT_FORMAT=1600BPI_9TRACK See also SHOW UNITS unit-number SHOW HSZ40 Array Controller CLI Reference Manual...

  • Page 94: Show

    2–82 SHOW SHOW Displays information about controllers, storagesets, devices, and partitions. ___________________________ Note ____________________________ command may not display some information for devices accessed SHOW through the companion controller in a dual-redundant configuration. When device or parameter information does not appear, enter the same SHOW command from the other controller.
  • Page 95 Switches FULL Displays additional information about each device or controller. Examples To show a basic listing of CDROMs: CLI> SHOW CDROM Name Type Port Targ Used by ----------------------------------------------------------- CDROM230 cdrom D623 CDROM240 cdrom D624 HSZ40 Array Controller CLI Reference Manual...
  • Page 96 2–84 SHOW To show a full listing of devices attached to the controller: CLI> SHOW DEVICES FULL Name Type Port Targ Used by ------------------------------------------------------------------------------ DISK100 disk D500 RZ28 (C) DEC 435E Switches: NOTRANSPORTABLE TRANSFER_RATE_REQUESTED = 10MHZ (synchronous 10 MB/SEC negotiated) Size: 4109470 blocks DISK120 disk...
  • Page 97 0) is NORMAL Size: 4109470 blocks To show the full information for a controller: CLI> SHOW THIS_CONTROLLER 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)

  • Page 98: Shutdown This_Controller And Shutdown Other_Controller2-86

    2–86 SHUTDOWN THIS_CONTROLLER and SHUTDOWN OTHER_CONTROLLER SHUTDOWN THIS_CONTROLLER and SHUTDOWN OTHER_CONTROLLER Flushes all user data from the specified controller's write-back cache (if present) and shuts down the controller. The controller does not restart. All units accessed through the controller failover to the surviving controller. is the controller that is running the current CLI session.
  • Page 99 CLI> SHUTDOWN THIS_CONTROLLER To shut down the other controller even if it cannot write all write-back cache data to units: CLI> SHUTDOWN OTHER_CONTROLLER IGNORE_ERRORS See also RESTART THIS_CONTROLLER RESTART OTHER_CONTROLLER SELFTEST THIS_CONTROLLER SELFTEST OTHER_CONTROLLER HSZ40 Array Controller CLI Reference Manual...

  • Page 100: Unmirror

    2–88 UNMIRROR UNMIRROR Converts a one-member mirrorset back to a single device and deletes the mirrorset from the list of known mirrorsets. You can use this command on mirrorsets that are already members of higher level containers (stripesets or units). command is not valid for devices that have a capacity greater than the UNMIRROR capacity of the mirrorset.

  • Page 101: Glossary

    Glossary HSZ40 Array Controller CLI Reference Manual...
  • Page 102 CI bus Computer interconnect bus. Uses two serial paths, each with a transfer rate of 70 Mb/s (8.75 MB/s). Command line interpreter. Operator command line interface for the HS family controller firmware. CLI Reference Manual HSZ40 Array Controller...
  • Page 103 4 MB/s. dual-redundant configuration Two controllers in one controller shelf providing the ability for one controller to take over the work of the other controller in the event of a failure of the other controller. HSZ40 Array Controller CLI Reference Manual...
  • Page 104 Disk drives in the failedset should be considered defective and should be tested, repaired, and then placed into the spareset. failover The process that takes place when one controller in a dual-redundant configuration assumes the workload of a failed controller. CLI Reference Manual HSZ40 Array Controller...
  • Page 105 The device being replaced is the only device that cannot perform operations during a hot swap. initiator A SCSI device that requests an I/O process to be performed by another SCSI device (a target). This is always the controller. HSZ40 Array Controller CLI Reference Manual...
  • Page 106 Two or more physical disks configured to present one highly reliable virtual unit to the host. MSCP Mass storage control protocol. The protocol by which blocks of information are transferred between the host and the controller. CLI Reference Manual HSZ40 Array Controller...
  • Page 107 (1-6), T designates the target ID of the device (0-6), and L designates the LUN of the device (0-7). qualified device A device that has been fully tested in an approved StorageWorks configuration, (that is, shelf, cabinet, power supply, cabling, and so forth) and is in complete compliance with HSZ40 Array Controller CLI Reference Manual...
  • Page 108 StorageWorks building block shelf. A StorageWorks shelf, such as the BA350--Sx, designed to house plug-in SBB modules. System communication services. A delivery protocol for packets of information (commands or data) to or from the host. CLI Reference Manual HSZ40 Array Controller...
  • Page 109 A storage unit can be any entity that is capable of storing data, whether it is a physical device or a group of physical devices. HSZ40 Array Controller CLI Reference Manual...
  • Page 110 RAIDset. unwritten cached data Data in the write-back cache which has not yet been written to the physical device, but the user has been notified that the data has been written. CLI Reference Manual HSZ40 Array Controller...
  • Page 111 This operation may update, invalidate, or delete data from the cache memory accordingly, to ensure that the cache does not contain obsolete data. The user sees the operation as complete only after the backup storage device has been updated. HSZ40 Array Controller CLI Reference Manual...
  • Page 113 2–14 2–23 unit, 2–16 CLEAR_ERRORS LOST_DATA command, 2–25 , 2–58 CLEAR_ERRORS UNKNOWN command, 2–26 UTOMATIC SPARE POLICY CLEAR_ERRORS UNWRITEABLE_DATA command, 2–27 Battery policy, 2–71 abbreviating commands, 1–4 accessing, 1–3 capturing your session, 1–4 HSZ40 Array Controller CLI Reference Manual...
  • Page 114 2–16 LOCATE, 2–42 passthrough container, 2–8 MIRROR, 2–44 RAIDsets, 2–10 REDUCE, 2–47 single-disk unit, 2–21 RENAME, 2–49 striped mirrorset, 2–14 stripeset, 2–14 RESTART OTHER_CONTROLLER, 2–50 RESTART THIS_CONTROLLER, 2–50 unit, 2–16 RETRY_ERRORS, 2–52 CLI Reference Manual HSZ40 Array Controller...
  • Page 115 2–40 removing from a failedset, 2–32 INITIALIZE command, 2–39 removing from a mirrorset, 2–47, 2–61 Invalid cache error removing from a RAIDset, 2–77 clearing, 2–23 removing from a spareset, 2–33 renaming, 2–49 showing, 2–83 HSZ40 Array Controller CLI Reference Manual...
  • Page 116 2–77 showing, 2–83 adding while missing a member, 2–11 striping, 2–14 changing characteristics, 2–76 unmirror, 2–89 choosing a replacement member, 2–10 Moving creating, 2–10 disk drives, 2–3, 2–56 deleting, 2–30 CLI Reference Manual HSZ40 Array Controller...
  • Page 117 SET device-name command, 2–56 renaming, 2–49 SET FAILEDSET command, 2–58 showing, 2–83 SET FAILOVER command, 2–59 specifying chunksize, 2–39 SET mirrorset-name command, 2–61 SET MULTIBUS_FAILOVER command, 2–65 SET NOFAILOVER command, 2–68 SET OTHER_CONTROLLER command, 2–70 Tape drive HSZ40 Array Controller CLI Reference Manual...
  • Page 118 2–16 Write-back cache changing characteristics, 2–78 enabling/disabling, 2–19, 2–80 clearing lost data error, 2–25 setting the battery policy, 2–71 deleting from the configuration, 2–34 setting the flush timer, 2–71 displaying configured units, 2–84 CLI Reference Manual HSZ40 Array Controller...

Table of Contents