Home » Adaptec Manuals » Storage Adapters » Adaptec 2410SA » Manual Viewer

Adaptec 2410SA User Guide - Page 96

Error Handling, can test for a specific error using a series

UPC - 760884142103

Add to My Manuals
Save this manual to your list of manuals

Page 96 highlights

DOS Utilities Error Handling Because the ACU scripting feature is designed to run without user interaction, the ACU handles errors during record and playback by simply exiting immediately whenever an error is detected. Whenever the ACU encounters an error during record or playback-for example, an unrecognized keyword in a script file- it reports the error and exits. If a log file is opened, the ACU writes the error message to the log file. Otherwise, it displays the message on the screen. Upon exit, the ACU returns its exit status in the DOS environment variable ERRORLEVEL. When the ACU is run within a DOS batch file, that batch file can examine the ACU's exit status using the DOS command IF ERRORLEVEL n. The batch file can use this command to test the ACU success or failure status. The batch file can test for a specific error using a series of If ERRORLEVEL n commands. The table below lists the possible error codes returned by the ACU. Code 0 1 2 3 4 5 6 7 8 Description ACU ran without changes-The ACU exited with no errors (success) and no report is required. No controller found-The ACU did not detect any controllers in the system. Syntax or logical error in the script file-The ACU encountered an invalid command or keyword in the specified script file. Unable to open file-The ACU was unable to open the specified script or log file. Error in the command line parameters-You passed an invalid command-line switch to the ACU. (See Using the Scripting Features on page B-18 for the list of valid command switches.) Unable to read system configuration-The ACU was unable to get the configuration information from the specified controller. No drives detected-The ACU did not detect any devices attached to the selected controller. Specified drive not found in system-The device you specified does not exist on the selected controller. Specified array size too small-You specified an array size that is smaller than the minimum size allowed for this array. B-32

Section	Page
Adaptec Serial ATA RAID 2410SA	2
Installation and User’s Guide	2
Contents	9
1	13
Introduction	13
Read this First	13
System Requirements	14
Operating System Compatibility	14
Storage Requirements	14
Motherboard Compatibility	14
Device Compatibility	14
Kit Contents	15
Adaptec 2410SA Controller	15
About the Documentation	16
Installing the Adobe Acrobat Reader	16
Controller Features	17
Adaptec’s Advanced RAID Technology Features	17
Array Migration	18
Drive Enclosures	18
Hot Spares	18
Automatic Failover	19
Overview of the Installation Process	19
Storage Management Software Overview	20
Safety Information	21
Notes and Cautions	21
Electrostatic Discharge	21
2	23
Installing the Controller	23
Overview	23
Installing the Controller	24
Checking Your Controller and Devices	25
Determining the Boot Controller	25
3	26
Installing the Driver	26
Creating the Driver Disk	27
Creating the Linux Driver Disk	27
Windows	28
Installing the Driver in a New System	28
Adding the Driver to an Existing System	29
Linux	30
Installing the Driver in a New Red Hat System	30
Adding the Driver to an Existing System	31
UnixWare and OpenUNIX	32
Installing the Driver on a New System	32
Adding the Driver to an Existing System	32
4	33
Installing Adaptec Storage Manager – Browser Edition	33
Overview	33
Supported Browsers	34
Typical, Custom, and Compact Installations	34
Remote and Managed Systems	35
Installing Adaptec Storage Manager on Windows	36
Configuring Internet Browsers on Windows	37
Configuring Internet Explorer for Local Management	38
Configuring Internet Explorer for Remote Management	39
Configuring Netscape Navigator for Local Management	39
Configuring Netscape Navigator for Remote Management	39
Installing Adaptec Storage Manager on Linux	40
Installing Adaptec Storage Manager on UNIX	41
5	42
Using Adaptec Storage Manager – Browser Edition	42
Overview	43
Architecture Overview	44
Logging In	45
Installing a Security Certificate	47
Registering Your Software	47
The Basics	48
Pop-Up Tool Tips	49
Physical Devices	49
Changing How Drives are Displayed	50
View	50
Logical Devices	51
A	53
Adaptec RAID Configuration Utility	53
Using the Array Configuration Utility	54
Managing Arrays	54
Viewing Array Properties	55
Making an Array Bootable	55
Deleting Arrays	56
Managing Failover Drive Assignments	57
Creating Arrays	58
Assigning Array Properties	59
Initializing Disk Drives	60
Rescanning Disk Drives	61
Using SATASelect	61
Using the Disk Utilities	63
Viewing the Event Log	64
B	65
DOS Utilities	65
Using the Adaptec Flash Utility (AFU)	65
Overview of the AFU	66
System Requirements	66
Firmware Floppy Disk Kit	67
Running the AFU	68
Accessing the AFU from the GUI	68
Accessing the AFU from the Command Line	68
Flashing the Firmware Using AFU	69
AFU Commands	71
HELP	71
LIST	71
SAVE	72
UPDATE	72
VERIFY	73
VERSION	73
AFU Error Handling	74
Using the Array Configuration Utility (ACU)	75
Interactive Versus Script Mode	75
Running the ACU	76
Using Interactive Mode	76
Creating an Array with ACU	76
Selecting Segments for New Arrays	77
Assigning Array Properties	77
Managing Arrays	79
Viewing Array Properties	79
Assigning Hot Spares	79
Removing Hot Spare Drives	80
Initializing a Hard Drive	80
Making an Array Bootable	81
Deleting Arrays	82
Using the Scripting Features	82
Playback Mode	84
Initializing Drives	85
Record Mode	86
Determining Build/Verify/Clear Status	86
Build/Verify Operations on RAID10 Arrays	88
Script File Syntax	88
Array Definition Block Properties	89
Array Keyword	90
Drives Keyword	90
Type Keyword	91
End Keyword	91
HotspareDrives Keyword	91
InitializeAll Keyword	92
Method Keyword	93
ReadCache Keyword	93
Size Keyword	94
StripeSize Keyword	94
Wait Keyword	95
WaitForBuild Keyword	95
WriteCache Keyword	95
Error Handling	96
Playback and Record Notes	98
Invoking the ACU and Using a Script	98
C	100
Command Line Interface (CLI)	100
Introduction	100
Terminology	101
Accessing the CLI	101
Accessing the CLI in MS-DOS	102
Accessing the CLI in Windows	102
Accessing the CLI in UNIX	102
Using the CLI	102
Opening and Closing a Controller	103
Displaying Information about Your Disks	104
Displaying Information about Your Array	104
Creating a Volume Set	104
Creating a RAID 0	105
Creating a RAID 1	105
Creating a RAID 5	105
Deleting an Array	106
Managing Failover Options and Hot Spares	106
Displaying the Controller’s Automatic Failover Status	107
Enabling Automatic Failover	107
Displaying Controller Information	108
Displaying Disk Information	110
Displaying Array Information	111
CLI Command Dictionary	114
General Control Commands	114
Container (Array) Commands	115
Controller Commands	124
Disk Commands	127
Logfile Commands	131
Task Commands	132
Enclosure Commands	133
Using Automated Command Scripts	137
D	138
Supported RAID Types	138
RAID 0	139
RAID 1	139
RAID5	140
RAID 10	141
Simple Volume	141
Spanned Volume	141
E	142
Specifications	142
DC Power Requirements	142
Current Requirements	142
Environmental Specifications	142