LSI cfg1030 Command-Line Utility for Windows Version 1.00.01 CONTENTS --------- 1.0 Overview 2.0 Change History 3.0 Functionality 4.0 Command-line Parameters 5.0 Commands 1.0 Overview: This file provides the information needed to use the Windows version of the cfg1030 command-line program. 1.1 Overview about this code The cfg1030 command-line program is a utility that can configure and manage LSI53C1020/1030 integrated SCSI controllers. 1.2 Limitations - The SETSTATE command will fail if the selected drive has any drive letters assigned to it. - A controller will not be available if there are no devices attached, and the numbering of the controller list will be effected by the absence of the controller. 1.3 Enhancements None 1.4 Level of Recommendations and Prerequisites for the Update: None 1.5 Dependencies: None 2.0 Change History -------------------- 1.00.01 - Initial Release 3.0 Functionality ------------------- You configure the program by entering a command word followed by command specific parameters on the command line. The following commands shall be implemented by the program: · BACKUP · GETCONFIG · GETSTATUS · SETSTATE When typing in a command line, commands and parameters may be uppercase, lowercase, or a mixture of the two. The program shall be case insensitive. The following conventions are used in the command descriptions: · Text in italics is entered exactly as shown on the command line. · Text surrounded by <> must be replaced with a required parameter. · Text surrounded by [] may be replaced by an optional parameter. · Parameters surrounded by {} must be entered one or more times as is appropriate for the command being executed. 4.0 Command-line Parameters ----------------------------- This section describes command line parameters that are common to more than one command. 4.1 Description A unique controller number is assigned by the program to each PCI function found in the system. Only PCI functions on controller chips recognized by this program are assigned numbers (see section 4.1). Because of the current design of LSI Logic’s MPT firmware for SCSI controllers, there is a one-to-one mapping between PCI functions and SCSI busses. Therefore this number can be used to address a particular SCSI bus in the system. For example: an LSI53C1030 dual SCSI bus chip will have two controller numbers assigned to it, an LSI53C1020 single SCSI bus chip will have one controller number assigned to it. The following algorithm shall be used to assign controller numbers: 1. Create a list of all supported controllers found in the system. 2. Sort the list based on PCI bus, device, and function numbers; the list shall be sorted in ascending order. 3. The first controller in the list will be assigned controller number 1; the next shall be assigned controller number 2; and so on and so forth until all controllers have had numbers assigned. Valid Values Decimal 1 to 255. 4.2 Description The channel number is the same as the SCSI bus number. The LSI53C1020/1030 controllers only have one channel. Therefore this number is always the same. Valid Values Decimal 1. 4.3 Description The identification number on the SCSI bus to which the disk drive will respond to when the host attempts a target selection. Valid Values Decimal 0 to 15. 5.0 Commands -------------- 5.1 BACKUP Command Description This command saves the configuration settings for the controller in a file. These settings can be restored to the same or an identically configured controller using the restore command. Only the backup configuration and settings variant of this command are implemented. The backup BIOS and firmware variants can be performed using the LSI Logic flsh1030 utility. Command Line cfg1030 backup [noprompt] Parameters Number of controller targeted by this command. Path and filename of file to store configuration data in; path is optional. noprompt Option ignored. Program Return Value 0x00 SUCCESS: command completed successfully. 0x01 FAILURE: command failed. 0xFE FILE_ERROR: error occurred while writing the configuration file. 0xFF BAD_PATH: path name was bad. 5.2 GETCONFIG Command Description The getconfig command displays information about LSI53C1020/1030 controller configurations. The information displayed includes controller type, firmware version, BIOS version, logical drive/RAID volume information, and physical drive information. An example of the information that will be output by this command is provided below. One MB is 1024 * 1024 bytes. All sizes that are displayed in MB are rounded down to the nearest MB. Logical drive status values are as follows: · Okay (OKY) - Drives are functioning properly and user data is protected if the current RAID level provides data protection. · Degraded (DGD) - The user’s data is not fully protected due to a configuration change or drive failure; a data resync or rebuild may be in progress. Physical device status values are as follows: · Online (ONL) - The drive is operational and is part of a logical drive. · Hot Spare (HSP) - The drive is a hot spare that is available for replacing a failed drive in an array. · Ready (RDY) - The drive is ready for use as a normal disk drive or it can be but has not been assigned to a disk array or hot spare pool. · Available (AVL) - The hard disk drive may or may not be ready, and it is not suitable for inclusion in an array or hot spare pool (i.e., it is not spun up, its block size is incorrect, or its media is removable). · Failed (FLD) - Drive was part of a logical drive or was a hot spare drive, and it failed. It has been taken offline. · Standby (SBY) - This status is used to tag all non-hard disk devices. Command Line cfg1030 getconfig [] Parameters Number of SCSI bus targeted by this command. Option that indicates what information is to be returned. See options below. Program Return Value 0x00 SUCCESS: command completed successfully. 0x01 FAILURE: bad command line arguments or operational failure. Options AD Controller information only. LD Logical drive (RAID volume) information only. PD Physical drive information only. AL All information (default). Sample Output: Read configuration has been initiated for controller 1 -------------------------------------------------------------------------- Controller information -------------------------------------------------------------------------- Controller type : LSI53C1020/1030 BIOS version : 5.02.03.00 Firmware version : 0.01.00.12 SCSI channel description : 1 parallel SCSI wide Initiator IDs (Channel/SCSI ID) : 1/7 Maximum physical devices : 15 Concurrent commands supported : 222 -------------------------------------------------------------------------- Logical drive information -------------------------------------------------------------------------- Logical drive number 1 Status of logical drive : Okay (OKY) RAID level : 1 Size (in MB) : 9015 Physical hard disks (Channel/SCSI ID) : 1/8 1/9 -------------------------------------------------------------------------- Physical device information -------------------------------------------------------------------------- Channel #1 Initiator at SCSI ID 7 Target on SCSI ID 0 Device is a Hard disk SCSI ID : 0 State : Ready (RDY) Size (in MB)/(in sectors) : 9015/18462720 Device ID : QUANTUM ATLAS 10K 9WLS UCH0 Target on SCSI ID 8 Device is a Hard disk SCSI ID : 8 State : Online (ONL) Size (in MB)/(in sectors) : 9015/18462720 Device ID : QUANTUM ATLAS 10K 9WLS UCH0 Target on SCSI ID 9 Device is a Hard disk SCSI ID : 9 State : Online (ONL) Size (in MB)/(in sectors) : 9015/18462720 Device ID : QUANTUM ATLAS 10K 9WLS UCH0 Target on SCSI ID 10 Device is a Hard disk SCSI ID : 10 State : Available (AVL) Size (in MB)/(in sectors) : 9015/18462720 Device ID : QUANTUM ATLAS 10K 9WLS UCH0 Target on SCSI ID 15 Device is a Processor device SCSI ID : 15 State : Standby (SBY) Device ID : LSI 53C040 0400 5.3 GETSTATUS Command Description The GETSTATUS command displays the status of any logical drive synchronization operation that is currently in progress on the controller. If none is in progress, cfg1030 will print a message indicating so before exiting. Command Line cfg1030 getstatus Parameters Number of controller targeted by this command. Program Return Value 0x00 SUCCESS: command completed successfully. 0x01 FAILURE: command failed. Sample Output Example of the status information returned when a drive resynchronization is in progress: Background command progress status for controller 1... Current operation : Synchronize Logical drive in progress : 1 Volume status : Enabled Volume state : Degraded Physical disk I/Os : Not quiesced Logical drive size (in sectors) : 370642 Number of remaining sectors : 188326 Percentage complete : 49.19% Example of the status information returned when no background logical drive operation is in progress: Background command progress status for controller 1... Current operation : None Logical drive in progress : 1 Volume status : Enabled Volume state : Optimal Physical disk I/Os : Not quiesced The status fields in the data displayed can take on the following values: Current operation - Synchronize or None Volume status - Enabled or Disabled Volume state - Optimal, Degraded or Failed Physical disk I/Os - Quiesced or Not quiesced 5.4 SETSTATE Command Description This command will set the drive state to the parameter value. The hot spare option is the only supported state. The hot spare drive will be added to hot spare pool 0. The number of disk drives in a logical drive plus the hot spare disk cannot exceed six. Only one hot spare disk can be created. The user must make sure the capacity of the hot spare disk is greater than or equal to the capacity of the smallest disk in the logical drive. An easy way to verify this is to use the getconfig command. Command Line cfg1030 setstate Parameters Number of SCSI bus targeted by this command. Must be set to one (1). SCSI target ID of drive targeted by this command. State to which the target device is to transition. See the state values below. Program Return Value 0x00 SUCCESS: command completed successfully. 0x01 FAILURE: bad command line arguments or operational failure. State Values HSP Hot spare