********************************************************************* * RAIDSEL command-line utility for SCSI HostRAID * * README.TXT * * Version 3.00 * ********************************************************************* CONTENTS ________ 1.0 Overview 2.0 User's Reference 2.1 Switch Definitions 2.2 Notes for command line parameters 2.3 Usage Limitations 2.4 Error Status Codes 2.5 Examples 3.0 Web Site and Support Phone Number 4.0 Trademarks and Notices 5.0 Disclaimer 1.0 Overview _____________ The utility allows command-line access to administer the RAID configuration for SCSI HostRAID in addition to the GUI-menu access. This file describes the usage of the command line interface switches/options. 2.0 User's Reference _______________________ 2.1 Switch Definitions _______________________ [blank] ..... Invoke DOS-GUI menu version of this utility. -? or ? ..... Display help on command line switches. -L < controller | physical | logical | raid | all > ..... List type information: -L controller: list controllers or SCSI cards. -L physical: list physical devices in current HostRAID/SCSI channel. -L logical: list logical devices (i.e. array) in current channel. -L raid/array: list array organization in current HostRAID channel. -L all: a combination of listing controller, physical and raid. -l < 0 | 1 | 10 > [RaidName] ..... Specify the raid type and raid name (optional) to create. Remark: to be used together with "-g" switch. -g d d [d] [d] ..... Create logical drive where "d" is a device id. Remark: to be used together with -l switch. -S + d ..... Add spare d. d denotes spare drive ID. -S - d ..... Delete spare d. d denotes spare drive ID. -a < build | rebuild | verify > d ..... Perform action on an array: -a build: do build action for create NEW array (RAID-1/RAID-10). -a rebuild: do rebuild action for RAID-1 (copy drive X to Y) OR rebuilding degraded array using its spare. Remark: sometimes build and rebuild can be used interchangeably. -a verify: do verify action (applies to RAID-1/RAID-10 in optimal state only). -B + d ..... Mark bootable on raid array d. -B - d ..... Unmark bootable on raid array d. -D < d | all > ..... Delete array or logical drive: -D d ..... delete array/logical drive ID d. -D all ..... delete all arrays in current HostRAID channel. -Z < d | all > ..... Zap disk operation: -Z d ..... zap single disk d. -Z all ..... zap all disks in current HostRAID channel. Remark: Zap disk means wipe out meta data and partition table. -q ..... Quiet mode (to disable output). Remark: 1) Heading, progress bar and status code will not be suppressed. 2) Error (if any) will not be suppressed either. Remark: This option is normally used together with other options simply to suppress information output. -d ..... Specify the card/controller number to operate on. If the user does not specify, then the default value of 0 will be assumed. Remark: This option is normally used together with "-L < physical | logical | raid >" option, "-D all" option and "-Z all" option. -b ..... Specify the bus/channel number. If user does not specify, then the default setting of 0 will be used. Remark: This option is normally used together with "-L < physical | logical | raid >" option, "-D all" option and "-Z all" option. -z < 16KB | 32KB | 64KB > ..... Set the required stripe size when creating RAID-0 or RAID-10 array. If user does not specify, then the default value of 64KB will be used. It is used together with "-l" and "-g" switches. -p < high | medium | low > ..... Specify driver background task priority. If user does not specify, then the default setting of medium will be used. It is used together with switch "-a". -F ..... Force creation of array. It's normally used on a drive where a partition table is detected. Remark: This option is normally used together with "-l" and "-g" switches when creating an array. Autofix ..... Set autofix to ON during verify action (default=OFF) Remark: If user does not specify this during verify operation, then default setting for autofix will be OFF. It is used together with "-a verify" option. -delinfo ..... Set delete information option when deleting RAID-1. The options available are deleting information on: a) primary drive (pri) b) secondary drive (sec) c) both drives (all) d) none Remark: If user does not specify this during deletion of RAID-1 array, then the default setting for -delinfo will be "none". It is used together with "-D" option. Save ..... Save the RAID Configuration on to a file. Load ..... Load/create RAID Configuration based on the options specified in the file. LoadB .... Load/create and build RAID Configuration based on the options specified in the file. Remark: Build is applicable to RAID-1 and RAID-10 only. 2.2 Notes for command line parameters ______________________________________ <...> : Mandatory unless otherwise specified. [...] : Optional HostRAID/SCSI Channel Addressing: o If you have more than one HostRAID/SCSI channel in your system, you may need to use command line switches "-d" and/or "-b" to specify or select a HostRAID/SCSI channel. Both switches are normally used together with "-L < physical | logical | raid >", "-D all" or "-Z all" switches. Device/Array Addressing (d, d1 and d2 specified as part of command line option): Device/Array is addressed using the d#b#t#l#, which means: d# Card Number - starting from 0 to N-1 where N = total number of cards b# Bus Number - 0 for single channel card, 0 or 1 for multi-channel card t# Target ID - from 0 to F in hexadecimal l# Lun Number - usually 0 For example: d0b0t1l0 means addressing the device (physical/logical) at Card 0, Bus 0, Target ID 1 and Lun 0. For RAID-0 to take effect, user is required to reboot the system after creation. For RAID-1/RAID-10 to take effect, user is required to reboot the system after completion of the build/rebuild process. 2.3 Usage Limitations ______________________ o The following addressing is NOT SUPPORTED: 1) Use of d#b# to specify all devices on a specific bus. 2) Use of d# to specify all devices on a controller. o Some limitations on creating RAID array: 1) When creating RAID-10, simply specify the required 4 drives. 2) When creating RAID-0, simply specify from 2 to 4 drives. 3) When creating RAID-1, simply specify the required 2 drives. 4) Creating RAID-1 or RAID-10 is a two step process. Example: a) create the array: raidsel -l 1 -g d0b0t0l0, d0b0t1l0 b) build the array: raidsel -a build d0b0t0l0 5) When creating RAID-1, user has the option of copying from one drive to another by using the following options: For example (create RAID-1, copy drive 0 to drive 1): raidsel -l 1 -g Master d0b0t0l0 Slave d0b0t1l0 2.4 Error Status Codes _______________________ Status Code 0 : Success Status Code 1 : Command Failed Status Code 2 : Command line syntax error Status Code 3 : Invalid parameter following the argument Status Code 4 : SCSI BIOS Error 2.5 Examples _____________ (list all information - in all HostRAID/SCSI channels) - raidsel -L all (list all array information - in the default HostRAID channel which is card #0 and its channel/bus #0) - raidsel -L raid (list all array information - in the HostRAID channel specified by card #1 and its channel/bus #1) - raidsel -L raid -d 1 -b 1 (create new RAID-1) - raidsel -l 1 -g d0b0t0l0 d0b0t1l0 (create RAID-1, copy drive 0 to drive 1) - raidsel -l 1 -g Master d0b0t0l0 Slave d0b0t1l0 (create RAID-0 with 32KB stripe Size) - raidsel -l 0 -g d0b0t0l0 d0b0t1l0 -z 32KB (create RAID-10 and 16KB stripe Size). - raidsel -l 10 -g d0b0t0l0 d0b0t1l0 d0b0t2l0 d0b0t3l0 -z 16KB (Add a spare drive to current HostRAID Channel) - raidsel -S + d0b0t0l0 (delete a spare drive) - raidsel -S - d0b0t0l0 (build new array [create NEW] and set driver priority to High) - raidsel -a build d0b0t0l0 -p High Remark: - if "-p" is not set, then raidsel will set driver priority to Medium by default. (rebuild array [copy drive X to Y] and set driver priority to Medium) - raidsel -a rebuild d0b0t0l0 -p Medium (verify array with autofix OFF) - raidsel -a verify d0b0t0l0 (verify array with autofix ON) - raidsel -a verify d0b0t0l0 autofix (mark bootable on array ID d0b0t0l0) - raidsel -B + d0b0t0l0 (unmark bootable on array ID d0b0t0l0) - raidsel -B - d0b0t0l0 (delete array ID d0b0t0l0) - raidsel -D d0b0t0l0 (delete all arrays - in the default HostRAID channel which is card #0 and its channel/bus #0) - raidsel -D all (delete all arrays - in the HostRAID channel specified by card #1 and its channel/bus #0) - raidsel -D all -d 1 -b 0 (deleting RAID-1 array with ALL drive information deleted) - raidsel -D d0b0t0l0 -delinfo all (deleting RAID-1 array with no information deleted) - raidsel -D d0b0t0l0 (zap all disks - in the default HostRAID channel which is card #0 and its channel/bus #0) - raidsel -Z all (zap a single disk - specified by the device address) - raidsel -Z d0b0t5l0 (save current RAID configuration to a file) - raidsel save raidcfg.xml (load/create RAID configuration from a file) - raidsel load raidcfg.xml (load/create and build RAID configuration from a file) - raidsel loadB raidcfg.xml (save list information to a file) - raidsel -L controller > view.txt - raidsel -L all -q > view.txt (remark: "-q" is required to save all information to a file.) 3.0 Web Sites and Support Phone Number _______________________________________ o You can download new and updated files for the IBM ServeRAID and Clustering products from the IBM Support Web site: http://www.ibm.com/pc/support/ o For the latest list of supported operating systems, see the IBM Server Proven - SCSI and RAID Controllers Web site: http://www.pc.ibm.com/us/compat/controllers/matrix.html For supported operating systems on legacy (non-shipping) controllers, see: http://www.pc.ibm.com/us/compat/machines/index.html o With the original purchase of an IBM hardware product, you have access to extensive support coverage. During the IBM hardware product warranty period, you may call the IBM Personal Computer HelpCenter (1-800-772-2227 in the U.S.) for hardware product assistance covered under the terms of the IBM hardware warranty. 4.0 Trademarks and Notices ___________________________ The following terms are trademarks of the IBM Corporation in the United States or other countries or both: HelpCenter PC Server IBM ServeRAID UNIX is a registered trademark in the United States and other countries and is licensed exclusively through The Open Group. Microsoft, Windows, Windows Server 2003, Windows XP, Windows 2000, and Windows NT are trademarks or registered trademarks of Microsoft Corporation. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. HostRAID is a trademark of Adaptec, Inc. Other company, product, and service names may be trademarks or service marks of others. 5.0 Disclaimer _______________ THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.