Page 1 Adaptec SCSI RAID 2120S/2200S Software Reference Guide...
Page 2 Adaptec SCSI RAID Software Reference Guide Copyright © 2000 - 2002 Adaptec, Inc. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the prior written consent of Adaptec, Inc., 691 South Milpitas Blvd., Milpitas, CA 95035.
Page 3: Table Of Contents
Getting Started Audience 1-2 Supported Platforms 1-2 Organization 1-2 Conventions 1-3 Related Documentation 1-4 Accessing the Command Line Interface Accessing the CLI from the MS-DOS Prompt 2-2 Accessing the CLI from the Windows Start Button 2-2 To access the CLI from the UNIX/Linux prompt, display a window and type aaccli in any directory.
Page 4 Adaptec SCSI RAID Software Reference Guide Syntax and Conventions for CLI Commands CLI Features 3-1 CLI Command Syntax 3-2 Class 3-3 Action 3-3 Object 3-3 Switch 3-3 Value 3-4 Parameter 3-4 Blank Space 3-4 CLI Parameter and Switch Value Types 3-4...
Page 5 Adaptec SCSI RAID Software Reference Guide General Control Commands close 4-2 Syntax 4-2 exit 4-2 Syntax 4-2 help, ? 4-2 Syntax 4-2 Parameters 4-2 Switches 4-2 history_size 4-3 Command Availability 4-3 Syntax 4-3 Parameters 4-3 open 4-3 Syntax 4-3 Parameters 4-3...
Page 6 Adaptec SCSI RAID Software Reference Guide container Commands container add_level 5-3 Syntax 5-3 Parameters 5-3 Examples 5-3 Related Information 5-4 container create mirror 5-5 Syntax 5-5 Parameters 5-5 Switches 5-6 Examples 5-6 Related Information 5-8 container create mmirror 5-9 Notes 5-9...
Page 7 Adaptec SCSI RAID Software Reference Guide Switches 5-25 Examples 5-27 Related Information 5-29 container create stripe 5-30 Notes 5-30 Syntax 5-30 Parameters 5-30 Switches 5-31 Examples 5-32 Related Information 5-34 container create volume 5-35 Notes 5-35 Syntax 5-35 Parameters 5-35...
Page 8 Adaptec SCSI RAID Software Reference Guide container extend volume 5-50 Command And Switch Availability 5-50 Syntax 5-50 Parameters 5-50 Examples 5-51 Related Information 5-53 container list 5-54 Syntax 5-54 Parameters 5-54 Switches 5-54 Examples 5-55 Related Information 5-64 container lock 5-65...
Page 9 Adaptec SCSI RAID Software Reference Guide Examples 5-74 Related Information 5-75 container reconfigure 5-76 Notes 5-77 Syntax 5-77 Parameters 5-78 Switches 5-78 Examples 5-81 Related Information 5-82 container release_cache 5-83 Syntax 5-83 Parameters 5-83 Examples 5-83 Related Information 5-83 container remove drive_letter 5-84...
Page 10 Adaptec SCSI RAID Software Reference Guide Syntax 5-92 Parameters 5-92 Examples 5-92 Related Information 5-93 container scrub 5-94 Syntax 5-94 Parameters 5-94 Switches 5-94 Examples 5-95 Related Information 5-96 container set cache 5-97 Notes 5-97 Syntax 5-97 Parameters 5-98 Switches 5-98...
Page 11 Adaptec SCSI RAID Software Reference Guide container show cache 5-110 Syntax 5-110 Parameters 5-110 Examples 5-110 Related Information 5-115 container show failover 5-116 Syntax 5-116 Parameters 5-116 Examples 5-116 Related Information 5-116 container split 5-117 Syntax 5-117 Parameters 5-118 Examples 5-118...
Page 12 Adaptec SCSI RAID Software Reference Guide controller Commands controller details 6-2 Syntax 6-2 Examples 6-2 Related Information 6-6 controller firmware compare 6-7 Syntax 6-7 Switches 6-7 Examples 6-7 Related Information: 6-7 controller firmware save 6-8 Syntax 6-8 Switches 6-8 Examples 6-8...
Page 13 Adaptec SCSI RAID Software Reference Guide Parameters 6-17 Examples 6-17 controller resume_io 6-18 Syntax 6-18 Examples 6-18 Related Information 6-18 controller set automatic_failover 6-19 Notes 6-19 Syntax 6-19 Examples 6-20 Related Information 6-20 controller set array_verify 6-21 Syntax 6-21 Examples 6-21...
Page 14 Adaptec SCSI RAID Software Reference Guide disk Commands disk blink 7-2 Syntax 7-2 Parameters 7-2 Switches 7-2 Examples 7-2 disk initialize 7-3 Syntax 7-3 Parameters 7-3 Switches 7-3 Examples 7-4 disk list 7-5 Syntax 7-5 Parameters 7-5 Switches 7-5 Examples 7-5...
Page 15 Adaptec SCSI RAID Software Reference Guide disk show defects 7-16 Syntax 7-16 Parameters 7-16 Switches 7-16 Examples 7-16 disk show partition 7-18 Syntax 7-18 Examples 7-18 disk show smart 7-21 Syntax 7-21 Parameters 7-21 Switches 7-21 Examples 7-22 Related Information 7-24...
Page 16 Adaptec SCSI RAID Software Reference Guide diagnostic Commands diagnostic clear boot_parameters 8-2 Syntax 8-2 Examples 8-2 Related Information 8-2 diagnostic dump structures 8-3 Syntax 8-3 Parameters 8-3 Examples 8-3 Related Information 8-3 diagnostic dump text 8-4 Notes 8-4 Syntax 8-4...
Page 17 Adaptec SCSI RAID Software Reference Guide Syntax 8-12 Parameters 8-12 Related Information 8-12 diagnostic show history 8-13 Syntax 8-13 Switches 8-13 logfile Commands logfile end 9-2 Syntax 9-2 Examples 9-2 Related Information 9-2 logfile start 9-3 Syntax 9-3 Parameter 9-3...
Page 18 Adaptec SCSI RAID Software Reference Guide Switches 10-10 Examples 10-10 Related Information 10-11 task suspend 10-12 Syntax 10-12 Parameters 10-12 Switches 10-12 Examples 10-12 Related Information 10-13 enclosure Commands enclosure activate slot 11-3 Syntax 11-3 Parameters 11-3 Examples 11-3 Related Information 11-4...
Page 19 Adaptec SCSI RAID Software Reference Guide Examples 11-14 Related Information 11-14 enclosure set door 11-15 Syntax 11-15 Parameters 11-15 Switches 11-15 Examples 11-15 Related Information 11-15 enclosure set fan 11-16 Syntax 11-16 Parameters 11-16 Switches 11-17 Examples 11-17 Related Information 11-17...
Page 20 Adaptec SCSI RAID Software Reference Guide Syntax 11-27 Parameters 11-27 Examples 11-28 Related Information 11-29 enclosure show power 11-30 Syntax 11-30 Parameters 11-30 Examples 11-30 Related Information 11-32 enclosure show slot 11-33 Syntax 11-33 Parameters 11-33 Examples 11-34 Related Information 11-36...
Page 21 Adaptec SCSI RAID Software Reference Guide Using the Adaptec Flash Utility Introduction 12-1 Overview of the AFU 12-2 System Requirements 12-3 Firmware Floppy Kit 12-4 Running the AFU 12-5 Accessing the AFU from the GUI 12-5 Accessing the AFU from the Command Line 12-5...
Page 22 Adaptec SCSI RAID Software Reference Guide xxii...
Page 23: Getting Started
To configure and manage components running on the Adaptec SCSI RAID controller, Adaptec has developed an easy-to-use graphical user interface (GUI) called Adaptec Storage Manager as well as a command line interface (CLI). The CLI provides a rich alternative to Adaptec Storage Manager.
Page 24: Audience
RAID controllers presented in the Adaptec SCSI RAID Software User’s Guide. Supported Platforms The Adaptec SCSI RAID controller operates on a variety of operating system platforms. See the installation guide that was supplied with your controller for a list of the supported operating system platforms.
Page 25: Conventions
Chapter 11, enclosure Commands, describes the enclosure commands, which operate on enclosure management devices. Chapter 12, Using the Adaptec Flash Utility, describes how to use the DOS application to update the flash EEPROM components. Chapter 13, Using the Array Configuration Utility, describes how to use the BIOS utility for creating, configuring, and managing arrays.
Page 26: Related Documentation
RAID software. ■ Adaptec SCSI RAID Software User’s Guide Describes the features available in Adaptec Storage Manager and how to use them. The guide assumes that you are familiar with: – Basic functions of your operating system –...
Page 27: Accessing The Command Line Interface
Accessing the Command Line Interface In this Chapter Accessing the CLI from the MS-DOS Prompt Accessing the CLI from the Windows Start Button Accessing the CLI from the NetWare Server Console Accessing the CLI from the UNIX Prompt Note: When the CLI executes an asynchronous command, it displays status information in the title bar of a DOS command prompt window.
Page 28: Accessing The Cli From The Ms-Dos Prompt
Windows 2000(basic disk only) or Windows NT Start button: Click the Start button and move the mouse cursor to Programs. Click on Programs. Move the mouse cursor to SMBE. The Adaptec program group will display. Move the mouse cursor to the CLI icon. Click on CLI.
Page 29: To Access The Cli From The Unix/Linux Prompt, Display A
■ From the NetWare server console To access the CLI from the NetWare server console, type aaccli at the prompt. When the system displays the CLI> prompt, which indicates that you can now use CLI commands. ■ From the UNIX/Linux prompt To access the CLI from the UNIX/Linux prompt, display a window and type aaccli in any directory.
Page 30 Adaptec SCSI RAID Software Reference Guide...
Page 31: Syntax And Conventions For Cli Commands
Syntax and Conventions for CLI Commands In this Chapter CLI Features CLI Command Syntax CLI Parameter and Switch Value Types CLI Status Information CLI Features To use the CLI efficiently, you need to understand the following features: ■ Case sensitivity—CLI syntax elements are not case-sensitive except for strings.
Page 32: Parameters
Adaptec SCSI RAID Software Reference Guide To enter subcommand mode, type the first part of any command that has subcommands and press Enter. The command you entered replaces the CLI> prompt and becomes the first part of any subsequent command you enter.
Page 33: Parameters
All commands use the following syntax: [class] action [object] [/switch1[=value1] [/switch2[=value2]...]] [parameter1 [parameter2...]] The CLI syntax uses the following conventions: The text element within brackets is optional. [text] The type specified within braces is the value type {type} (for example, boolean, integer, string, and so on). The parameter defined by the value type.
Page 34: Value
Adaptec SCSI RAID Software Reference Guide Value A value is a type that applies to a switch. For each switch, you can have only one type of value. For example, a switch that is defined as a string value can never take an integer value. A space may be used within a value only within a quoted string.
Page 35: Syntax
boolean A boolean has a value of either TRUE or FALSE and can be specified with any of the following key words: ■ TRUE can be specified with TRUE, 1, ON, or YES. For switches, you can also specify TRUE by using the switch without any switch value.
Page 36: String
Adaptec SCSI RAID Software Reference Guide Table 3-1. Letters and Multiplicative Values Letter Action K (kilobytes) multiplies by 1024 M (megabytes) multiplies by 1024*1024 G (gigabytes) multiplies by 1024*1024*1024 T (terabytes) multiplies by 1024*1024*1024*1024 You cannot use decimal points. To specify 1.5 GB, for example, you must use (3G/2).
Page 37 a quotation mark of the same type used to surround the string can be specified by repeating that quotation mark twice in the string. Table 3-3 lists examples of valid strings and their corresponding values: Table 3-3. Strings and Corresponding Values String VOL_set "VOL label"...
Page 38: Scsi_Device
Adaptec SCSI RAID Software Reference Guide Table 3-4. SCSI Device Switch Abbreviations Abbreviation SCSI channel number, SCSI device ID SCSI device ID SCSI device ID Table 3-5 displays valid SCSI device specifiers. The second two examples contain a default LUN number, and the last two examples contain default channel and LUN numbers.
Page 39: Container
used is the first offset that starts a freespace area large enough to fit size bytes. Table 3-6 lists valid free_space specifiers. Table 3-6. Freespace Specifiers SCSI Channel Number, SCSI Device ID, SCSI Device LUN; Freespace Specifier Use n Amount of Freespace SCSI Device: Channel 1, Device ID 2, LUNdefault;...
Page 40: Cli Status Information
Adaptec SCSI RAID Software Reference Guide CLI Status Information When invoked from the MS-DOS prompt or the Windows NT/ Windows 2000 (basic disk only)/Windows XP (basic disk only) Start button, the CLI displays status information in the title bar of a DOS command prompt window as it executes an asynchronous command.
Page 41: The Func Item
The Func Item The Func item displays the type of task running on the controller. Table 3-7 describes the values that the Func item can display. Table 3-7. Function Values Value Meaning File system verify task. File system extend task. The array extend mvolume and array extend volume commands cause the FSX value to display.
Page 42: The Ctr And State Items
Adaptec SCSI RAID Software Reference Guide The Ctr and State Items The Ctr item displays the ID number of the array associated with the task. In the example, the array’s ID is 0 (zero). The State item displays the state of the task along with a running percentage value that indicates the progress of the currently running task.
Page 43: History_Size
General Control Commands In this Chapter close exit help, ? history_size open reset_window toggle_more The CLI general control commands are discussed in alphabetical order and use the following syntax: command [subcommand] [/switch{=value}] [parameter]...
Page 44 Adaptec SCSI RAID Software Reference Guide close To close the currently opened controller when all access is completed, use the close command. Syntax close exit To close the currently opened controller and exit the CLI, use the exit command. Syntax...
Page 45: Command Availability
history_size To set the size of the command history buffer, use the history_size command. Command Availability This command is supported only on UNIX. Syntax history_size {buffer_size} Parameters {buffer_size} Specifies the size of the command history buffer. The default size is 200. open To open a controller, use the open command.
Page 46 Adaptec SCSI RAID Software Reference Guide If the computer name has a dash (-) in the name (for example, proj-athena), enclose the entire string within quotes. For example: “\\proj-athena\aac0” Switches /readonly{=boolean} Specifies whether to open the controller for read-only access. A value of TRUE indicates the CLI opens the controller for read- only access.
Page 47 General Control Commands reset_window To reset the window, use the reset_window command. Command Availability This command is supported only on UNIX. Syntax reset_window toggle_more To turn on or off the <Press any key to continue> functionality, use the toggle_more command. After you type toggle_more on the NetWare console, the command displays an appropriate message indicating whether the <Press any key to continue>...
Page 48 Adaptec SCSI RAID Software Reference Guide...
Page 49: Container Commands
container Commands In this Chapter container add_level container create mirror container create mmirror container create mstripe container create mvolume container create raid5 container create stripe container create volume container delete container extend file_system container extend mvolume container extend volume container list container lock container move container promote...
Page 50 Adaptec SCSI RAID Software Reference Guide container remove drive_letter container remove failover container remove file_system container remove global_failover container restore RAID5 container scrub container set cache container set failover container set global_failover container set io_delay container set label container show cache...
Page 51: Container Add_Level
container add_level To create a multilevel volume set from an existing array by adding a volume set on top of the array, use the container add_level command. The existing array cannot be a multilevel array. The container add_level command enables dynamic expansion of an array and can be executed even while an array is in use.
Page 52: Related Information
Adaptec SCSI RAID Software Reference Guide Use the container list command after using the container add_level command to display information about the multilevel volume set, as in the following example: AAC0>container list Executing: container list Total Oth Stripe Dr Label Type...
Page 53: Container Create Mirror
container create mirror To create a mirror set from a single-partition volume set and freespace, use the container create mirror command. Any data on the original volume set remains intact during mirror creation and the user sees no interruption in service. If you created a mirror set on a NetWare server, you can run the list devices command on the NetWare console to verify its creation and then create the necessary NetWare disk partitions and...
Page 54: Switches
Adaptec SCSI RAID Software Reference Guide Switches /wait{=boolean} Specifies whether to create the mirror set synchronously. If you set this switch to TRUE, the command prompt does not return until the mirror-set creation completes. If you set this switch to FALSE, the mirror-set creation starts asynchronously and the command prompt returns immediately.
Page 55 page 3-10 for detailed information on the status information that the command displays in the title bar as it executes the task. Use the container list command after the container create mirror command completes execution to display information about the mirror set, as in the following example: AAC0>container list Executing: container list Total...
Page 56: Related Information
Adaptec SCSI RAID Software Reference Guide Related Information container commands: ■ container create mmirror ■ (page container list ■ (page container split ■ container unmirror disk commands: ■ disk remove dead_partitions (page 5-9) 5-54) 5-117) (page 5-123) (page 7-9)
Page 57: Container Create Mmirror
container create mmirror To create a multilevel array of mirror sets from a multilevel array of single-partition volume sets and freespace, use the container create mmirror command. Typically, you use this command after promoting a volume set built from multiple partitions with the container promote command.
Page 58: Switches
Adaptec SCSI RAID Software Reference Guide {scsi_device} Specifies the ID for the SCSI device whose freespace you want to use to create the multilevel array of mirror sets. The size of this freespace should be greater than or equal to the size of the first underlying volume set.
Page 59: Examples
Examples Before creating a multilevel array of mirror sets, use the container list command to obtain information about any existing arrays. As the following example shows, array 0 is a volume set that consists of two underlying volume sets created with the container promote command: AAC0>container list Executing: container list...
Page 60: Related Information
Adaptec SCSI RAID Software Reference Guide Dr Label Type Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ ------------- F: 0 Volume 30M Mirror 15MB Mirror 15MB The following list describes the change to the display as the result of...
Page 61 container Commands disk commands: ■ (page 7-9) disk remove dead_partitions 5-13...
Page 62: Container Create Mstripe
Adaptec SCSI RAID Software Reference Guide container create mstripe To create a multilevel stripe set from equally sized arrays, use the container create mstripe command. The top level of a multilevel stripe array can only be a stripe set. You can create the following types of multilevel stripe set: ■...
Page 63: Parameters
Parameters {container} Specifies the ID number (0 to 63) of the array from which you want to create the multilevel stripe set. {container}... Specifies the ID number or numbers (0 to 63) of one or more arrays from which you want to create the multilevel stripe set. You can use up to 16 arrays to create a multilevel stripe set.
Page 64: Examples
Adaptec SCSI RAID Software Reference Guide Examples Before creating a multilevel stripe set, use the container list command to obtain information about any existing arrays. As the following example shows, there are two existing arrays (mirror sets) on this controller at the time the multilevel stripe set is created.
Page 65 The following list describes the change to the display as the result of creating a multilevel stripe set with the container create mstripe command: ■ The Num Label column displays the ID number (in the example, 0) of the newly created multilevel stripe set and (indented to the right) the ID numbers of the arrays that make up the multilevel stripe set.
Page 66: Related Information
Adaptec SCSI RAID Software Reference Guide ■ The State column displays Normal for arrays 0, 63, and 62 to indicate that the state of the array is normal. Note that this column appears only if you specify the /full switch with the container list command.
Page 67: Container Create Mvolume
container create mvolume To create a multilevel volume set, use the container create mvolume command. You can create the following types of multilevel volume sets: ■ Volume set of stripe sets ■ Volume set of mirror sets ■ Volume set of RAID-5 sets ■...
Page 68: Switches
Adaptec SCSI RAID Software Reference Guide {container}... Specifies the ID (0 to 63) of one or more additional arrays from which you want to create the multilevel volume set. You can use up to 16 arrays. Typically, the additional arrays you specify are the same type as the first array.
Page 69 The following example shows how to create a multilevel volume set from two single arrays: AAC0> container create mvolume 0 1 Executing: container create mvolume 0 1 container 0 created On UNIX systems, the message displayed after you execute the container create mvolume command includes the root special file associated with the newly created multilevel volume set.
Page 70 Adaptec SCSI RAID Software Reference Guide ■ The Type column displays the type name Volume for the newly created multilevel volume set. The Type column also displays the array type for the underlying arrays. In the example, Stripe appears in the Type column to indicate that the arrays that make up the multilevel volume set are stripe sets.
Page 71: Related Information
Related Information container commands: ■ container create mmirror ■ container create raid5 ■ container create stripe ■ container set label container Commands (page 5-9) (page 5-24) (page 5-30) (page 5-108) 5-23...
Page 72: Container Create Raid5
Adaptec SCSI RAID Software Reference Guide container create raid5 To create a RAID-5 set, use the container create raid5 command. The RAID-5 set must have a minimum of three disks. When creating the RAID-5 set, you must initialize the array parity by using the scrub method (the /scrub switch).
Page 73: Switches
The command uses the freespace(s) from the SCSI device(s) you specify to create the RAID-5 set. The size that the command uses from these device(s) is identical to the one you specify in the free_space parameter. The minimum number of partitions in a RAID-5 set is 3, and the maximum number of partitions is 16.
Page 74 Adaptec SCSI RAID Software Reference Guide /clear{=boolean} Specifies whether to set up the parity during RAID-5 creation by clearing the entire RAID-5 set. If you specify TRUE, the command sets up the parity during RAID-5 creation by clearing the RAID-5 set.
Page 75: Examples
Although the drive is immediately available, it is not parity- protected until the background scrub action completes. This switch defaults to TRUE. If you set this switch to FALSE, the command will set up parity by clearing the RAID-5 set. In other words, setting / scrub=FALSE enables the same behavior as /clear=TRUE.
Page 76 Adaptec SCSI RAID Software Reference Guide AAC0>container create raid5 /stripe_size=64K /scrub ((0,02,0),10M) (0,03,0) (0,04,0) (0,05,0) Executing: container create raid5 /stripe_size=65,536 scrub=TRUE ((CHANNEL=0,ID=2,LUN=0),10,485,760 ) (CHANNEL=0,ID=3,LUN=0) (CHANNEL=0,ID=4,LUN=0) (CHANNEL=0,ID=5,LUN=0) container 0 created As the command executes, note that the title bar of the MS-DOS window displays the status of the command.
Page 77: Related Information
■ The Type column displays RAID-5 to indicate that the newly created array is a RAID-5 set. ■ The Total Size column displays the total size of the freespace available. In this example, 40.0 MB of freespace was specified, which means that this column displays 30.0 MB as available. ■...
Page 78: Container Create Stripe
Adaptec SCSI RAID Software Reference Guide container create stripe To create a stripe set from freespace, use the container create stripe command. Notes If you created a stripe set you can run the list devices command on the NetWare console to verify its creation and then create the necessary NetWare disk partitions and volumes.
Page 79: Switches
Switches /cache{=boolean} Specifies whether to enable the array’s raw array cache.You can use this switch only if a native operating system’s file system – for Windows NT/Windows 2000 (basic disk only)/ Windows XP (basic disk only), the NTFS or FAT file system – resides on the array.
Page 80: Examples
Adaptec SCSI RAID Software Reference Guide If you do not specify the switch, it defaults to no label. If you do not specify a label, you can do so later by using the container set label command. Note that this label is not the label that displays in Windows Explorer.
Page 81 Use the container list command after using the container create stripe command to display information about the stripe set, as in the following example: AAC0>container list Executing: container list Total Oth Stripe Dr Label Type Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ ------------- Stripe 45.0MB 64KB The following list describes the items in the display that contain...
Page 82: Related Information
Adaptec SCSI RAID Software Reference Guide ■ The Scsi C:ID:L column displays the SCSI device ID(s) for the disk(s) whose associated freespaces you used to create the stripe set. In this example, the display shows 0:02:0, 0:03:0, and 0:04:0. ■...
Page 83: Container Create Volume
container create volume To create a volume set from freespace, use the container create volume command. Notes If you created a volume set you can run the list devices command on the NetWare console to verify its creation and then create the necessary NetWare disk partitions and volumes.
Page 84: Switches
Adaptec SCSI RAID Software Reference Guide {scsi_device},{free_space}... Specifies any additional SCSI devices and associated freespaces used to create the volume set. A volume set can have a maximum of 16 partitions (or freespaces, since each freespace becomes a partition). Note that you must explicitly specify the entire ID for any additional SCSI devices (the SCSI channel number, device ID, and device logical unit number).
Page 85: Examples
/label{=string} Specifies a label to be assigned to the newly created volume set. You can specify a maximum of sixteen characters for the label. If you do not specify the switch, it defaults to no label. If you do not specify a label, you can do so later by using the container set label command.
Page 86 Adaptec SCSI RAID Software Reference Guide Use the container list command after executing the container create volume command to display information about the volume set, as in the following example: AAC0>container list Executing: container list Total Oth Stripe Dr Label Type...
Page 87: Related Information
Related Information container commands: ■ container extend volume ■ (page container format ■ (page container list ■ (page container promote ■ container set cache ■ container set label disk commands: ■ (page disk show space container Commands (page 5-50) 5-54) 5-54) 5-69) (page...
Page 88: Container Delete
Adaptec SCSI RAID Software Reference Guide container delete To delete an array from the currently opened controller, use the container delete command. Notes If you are deleting an array on a NetWare system, you must first go to the NetWare console and remove the corresponding volume and partition.
Page 89: Examples
/unconditional{=boolean} Specifies whether to delete the array, even if the array has open files on it. If you specify TRUE, the command deletes the array even if it has open files on it. The switch defaults to FALSE (that is, the container delete command does not delete an array that has open files on it).
Page 90: Related Information
Adaptec SCSI RAID Software Reference Guide Note that in the example, the deletion of array 0 caused the deletion of all the underlying (hidden) arrays (arrays 63, 62, and 61). Related Information container commands: ■ container create mirror ■ container create mmirror ■...
Page 91: Container Extend File_System
container extend file_system To extend a file system so that it uses all of the space in an array, use the container extend file_system command. This command allows you to extend the NTFS file system. Typically, you use this command after extending an array (by adding a level to it with the container add_level command and, possibly, by extending it with the container extend mvolume command).
Page 92: Command And Switch Availability
Adaptec SCSI RAID Software Reference Guide Command And Switch Availability This command and its associated switches (if any) are supported on the following operating systems: ■ Windows NT ■ Windows 2000 (basic disk only) ■ Windows XP (basic disk only)
Page 93: Related Information
Assign a drive letter to the volume set created in Step 1 with the container assign drive_letter command. Create an NTFS file system on the volume set created in Step 1 with the container format command. Create a second volume set of 100 MB on disk (1,1,0) with the container create volume command.
Page 94: Container Extend Mvolume
Adaptec SCSI RAID Software Reference Guide container extend mvolume To extend a multilevel volume set by adding one or more arrays to it, use the container extend mvolume command. Any file system on the multilevel volume set remains intact, and can be extended to include the added space.
Page 95: Examples
{container}... Specifies the ID number (0 to 63) of the array or arrays to add to the previously specified multilevel volume set. The previous file system information applies to these additional arrays as well. Examples Before extending a multilevel volume set, use the container list command to obtain information about any existing arrays.
Page 96 Adaptec SCSI RAID Software Reference Guide multilevel array of volume sets after you extend it, as in the following example: AAC0>container list Executing: container list Total Oth Stripe Dr Label Type Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ -------------...
Page 97: Related Information
■ The Partition Offset:Size column displays the offsets and sizes for the partition(s) on which the volume sets were created, which in the example are 64.0KB:10MB, 64.0KB:15.0MB, and 64KB:15MB. If a partition is dead, the “:” (colon) in the Partition Offset:Size column changes to a “!”...
Page 98: Container Extend Volume
Adaptec SCSI RAID Software Reference Guide container extend volume To extend a volume set by adding freespace to it, use the container extend volume command. The file system on the volume set remains intact and can be extended to include the added space.
Page 99: Examples
Examples Before extending a volume set, use the container list command to obtain information about any existing arrays. As the following example shows, there is an array (volume set) 1 on this controller: AAC0>container list Executing: container list Total Oth Stripe Dr Label Type Size Ctr Size...
Page 100 Adaptec SCSI RAID Software Reference Guide Use the container list command after using the container extend volume command to display information about the volume set after you extend it, as in the following example: AAC0>container list Executing: container list Total...
Page 101: Related Information
Related Information container commands: ■ container create volume ■ (page container list disk commands: ■ disk remove dead_partitions ■ (page disk show space container Commands (page 5-35) 5-54) (page 7-9) 7-25) 5-53...
Page 102: Container List
Adaptec SCSI RAID Software Reference Guide container list To display information about one or all arrays on the controller, use the container list command. The display contains such information as the container’s ID number and other useful information. Typically, you use the container list command to obtain specific information about arrays prior to using other array- related commands.
Page 103: Examples
Examples The following example shows how to list nondetailed information about all arrays on the system: AAC0>container list Executing: container list Total Oth Stripe Dr Label Type Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ ------------- Volume 15.0MB Stripe 45.0MB 32KB The detailed container list display contains the previous...
Page 104 Adaptec SCSI RAID Software Reference Guide The Dr Column On Windows NT/Windows 2000 (basic disk only)/Windows XP (basic disk only) systems, this column displays a blank space if you did not assign a drive letter to the array. Otherwise, the column contains the letter associated with the array.
Page 105 The Type Column This column displays the type of array. Table 5-1 describes the type values that can display in the Type column. Table 5-1. Container Types container Type Meaning The container is a mirror set. Mirror The container is a stripe set. Stripe The container is a volume set.
Page 106 Adaptec SCSI RAID Software Reference Guide The Stripe Size Column This column displays the stripe size for the array. You specify the stripe size when using the container create mstripe, container create raid5, and container create stripe commands. The Usage Column This column displays information about the data on or the status of the array.
Page 107 The Scsi :ID:L Column This column displays the SCSI channel number, the SCSI ID, and the SCSI logical unit number for the SCSI disk or disks on which the array was created. The Partition Offset:Size Column This column displays the offset and size for the underlying partitions.
Page 108 Adaptec SCSI RAID Software Reference Guide The RO Column This column displays the letters RO if the array is read-only. Otherwise, if the array is read-write the column displays a blank space. You can explicitly make an array read-only and read-write with the container readonly and container readwrite commands.
Page 109 Table 5-4. Task Types (Continued) Task Meaning An array format NTFS file system task is running on FmtNTFS the specified array. The format NTFS file system task runs as a result of using the container format command with the NTFS A rebuild task is running on the specified array.
Page 110 Adaptec SCSI RAID Software Reference Guide Table 5-4. Task Types (Continued) Task Meaning A clear disk task is running on the specified SCSI disk. Zero When the clear disk task completes, the specified SCSI disk is cleared (that is, all data is erased and cannot be recovered).
Page 111 11:55:49 As the example shows, the command displays the time in the form where hhmmss ■ is a two-digit number that indicates the hour at which you created the array. ■ is a two-digit number that indicates the minute at which you created the array.
Page 112: Related Information
Adaptec SCSI RAID Software Reference Guide Related Information container commands: ■ container create mirror ■ container create mstripe ■ container create raid5 ■ container create stripe ■ (page container scrub disk commands: ■ (page 7-28) disk verify ■ (page 7-30)
Page 113: Container Lock
container lock Caution: Use the container lock command only under the direction of technical support. To lock an array into volatile memory space on the currently opened controller, use the container lock command. When an array is locked into volatile memory space, the container reconfigure command has no effect.
Page 114: Related Information
Adaptec SCSI RAID Software Reference Guide Use the container list command (with the /full switch) after using the container lock command to display information about the array you just locked, as in the following example: AAC0>container list /full Executing: container list /full=TRUE...
Page 115: Container Move
container move To renumber an array, use the container move command. If another array already has the new number, the command returns an error. Notes A controller currently supports 24 visible arrays. A visible array is an array that is visible to the operating system and users. Visible arrays are identified with container IDs 0 through 23.
Page 116: Examples
Adaptec SCSI RAID Software Reference Guide Examples Before renumbering an array, use the container list command to obtain information about any existing arrays. As the following example shows, there is an array 0 (a volume set) on this controller: AAC0>container list...
Page 117: Container Promote
container promote To create a multilevel volume set from a stripe set or volume set, use the container promote command. In this case, the resulting array is an array of single-partition volume sets, each of which has a single partition from the original array. Typically, you use the container promote command as part of a process to provide fault tolerance for existing volume sets.
Page 118: Examples
Adaptec SCSI RAID Software Reference Guide Examples Before promoting an array to a multilevel array, use the container list command to obtain information about any existing arrays. As the following example shows, there is an array 0 (a stripe set) on this controller: AAC0>container list...
Page 119: Related Information
■ The Type column displays the Volume array type for the three underlying volume sets. ■ The Total Size column displays the sizes of the arrays. Note that the underlying arrays are each 15.0 MB and array 0’s size is the total of the two underlying arrays. ■...
Page 120: Container Readonly
Adaptec SCSI RAID Software Reference Guide container readonly To change an array’s read-write status to read-only status, use the container readonly command. Subsequent modifications to the data on the array are prohibited. To use the container readonly command, the array cannot be in use by any application.
Page 121: Related Information
Use the container list command (with the /full switch) after using the container readonly about the array you just made read-only, as in the following example: AAC0>container list /full Executing: container list /full=TRUE Total Oth Stripe Dr Label Type Size Ctr Size -- ----- ------ ------ --- ------ ------- -------- F: 0...
Page 122: Container Readwrite
Adaptec SCSI RAID Software Reference Guide container readwrite To change an array’s read-only status to read-write status, use the container readwrite command. Subsequent modifications to the data on the array are allowed. To use the container readwrite command, none of the array’s files can be open.
Page 123: Related Information
Use the container list command (with the /full switch) after using the container readwrite command to display information about the array you just made read-write, as in the following example: AAC0>container list /full Executing: container list /full=TRUE Total Oth Stripe Dr Label Type Size Ctr Size...
Page 124: Container Reconfigure
Adaptec SCSI RAID Software Reference Guide container reconfigure To change the configuration of an array, use the container reconfigure command. The container reconfigure command allows you to perform the following operations: ■ Transform an array from one type to another type You can transform an array from one type to another type.
Page 125: Notes
■ Extend an existing file system You can extend an existing file system by specifying the appropriate switch. (The command extends the file system after completing the reconfigure operation.) ■ Move partitions to other disks You can move an array’s partitions to other disks by specifying the appropriate switches with a valid partition or partitions.
Page 126: Parameters
Adaptec SCSI RAID Software Reference Guide Parameters {container} Specifies the ID number (0 to 63) of the array you want to reconfigure. {scsi_device}... Specifies one or more SCSI devices. Typically, you specify one or more SCSI devices when adding more drives to an array or moving an array’s partitions.
Page 127 This switch applies only to those multilevel volume sets on which an NTFS file system resides. If you extend an NTFS file system, you must reboot your system in order for the extension to take effect. If you do not specify this switch, you can later extend the file system with the container extend file_system command.
Page 128 Adaptec SCSI RAID Software Reference Guide /raid5{=boolean} Specifies whether to reconfigure the existing array into a RAID-5 set. If you specify TRUE, the command reconfigures the existing array into a RAID-5 set. If you specify FALSE, the command does not reconfigure the existing array into a RAID- 5 set.
Page 129: Examples
/wait{=boolean} Specifies whether the command performs the array reconfiguration operation synchronously or asynchronously. If you set this switch to TRUE, the command performs the array reconfiguration operation synchronously, which means the command prompt does not return until the array reconfiguration operation completes. If you set this switch to FALSE, the command performs the array reconfiguration operation asynchronously, which means the command prompt returns immediately.
Page 130: Related Information
Adaptec SCSI RAID Software Reference Guide Use the command after using the container list command to display information about the array you reconfigure just reconfigured, as in the following example: AAC0>container list Executing: container list Total Oth Stripe Dr Label Type...
Page 131: Container Release_Cache
container release_cache To release the cache buffers associated with a specific array, use the container release_cache command. When a disk fails or you remove a disk, the cache buffers associated with specific arrays remain locked on the controller. This allows the opportunity for the disk to come back online or gives you the opportunity to replace the disk.
Page 132: Container Remove Drive_Letter
Adaptec SCSI RAID Software Reference Guide container remove drive_letter To remove a drive letter, use the container remove drive_letter command. To use the container remove drive_letter command, none of the array’s files can be open. Command Availability This command and its associated switches (if any) are supported on the following operating systems: ■...
Page 133: Related Information
Use the container list command after using the container remove drive_letter command to display information about the array on which you just removed a drive letter, as in the following example: AAC0>container list Executing: container list Total Oth Stripe Dr Label Type Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ -------------...
Page 134: Container Remove Failover
Adaptec SCSI RAID Software Reference Guide container remove failover To remove one or more failover disks that were assigned to an array using the container set failover command, use the container remove failover command. Syntax container remove failover {container} {scsi_device} [{scsi_device}...]...
Page 135: Examples
Examples Before removing one or more failover disks from an array, use the container show failover command to obtain information about any existing failover disks assigned to arrays. As the following example shows, there is an array 0 that has two failover disks assigned to it on this controller: AAC0>container show failover Executing: container show failover...
Page 136: Container Remove File_System
Adaptec SCSI RAID Software Reference Guide container remove file_system To remove the file system from an array, use the container remove file_system command. Use this command when the file system on the array is no longer needed. This command fails if there are open files on the array.
Page 137: Related Information
The following example removes the file system from array 0: AAC0>container remove file_system 0 Executing: container remove file_system 0 Use the container list command after removing a file system from an array with the container remove file_system command to display information about the container, as in the following example: AAC0>container list Executing: container list...
Page 138: Container Remove Global_Failover
Adaptec SCSI RAID Software Reference Guide container remove global_failover To remove one or more failover disks that were assigned to all arrays through the container set global_failover command, use the container remove global_failover command. Syntax container remove global_failover {scsi_device} [{scsi_device}...]...
Page 139: Related Information
The following example removes SCSI device 1:02:0 as an assigned failover disk for all arrays: AAC0>container remove global_failover (1,2,0) Executing: container remove global_failover (CHANNEL=1,ID=2,LUN=0) Use the container show failover command after removing a failover disk from an array’s failover disk list with the container remove failover command to display information about the array’s failover disk list, as in the following example: AAC0>container show failover...
Page 140: Container Restore Raid5
Adaptec SCSI RAID Software Reference Guide container restore RAID5 To restore a RAID-5 set, use the container restore RAID5 command. Typically, you use this command to restore a RAID-5 set that contains one or more dead partitions. This command does not always succeed and, in fact, you should use this command if all other measures to restore the RAID-5 set fail.
Page 141: Related Information
AAC0>container restore RAID5 0 Executing: container restore RAID5 0 Use the container list command after using the container restore RAID5 command to display information about the RAID-5 set: AAC0>container list Executing: container list Total Oth Stripe Dr Label Type Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ ------------- RAID-5 30.0MB...
Page 142: Container Scrub
Adaptec SCSI RAID Software Reference Guide container scrub To scrub a redundant array, use the container scrub command. A mirror set, a multilevel array of mirror sets, and a RAID-5 set are examples of redundant arrays. For a mirror set or a multilevel array of mirror sets, this means the command reconstructs the data on both mirror halves (partitions), if found to be different.
Page 143: Examples
/wait{=boolean} Specifies whether the command performs the scrub action synchronously or asynchronously. If you set this switch to TRUE, the command performs the scrub action synchronously, which means the command prompt does not return until the scrub action completes. If you set this switch to FALSE, the command performs the scrub action asynchronously, which means the command prompt returns immediately.
Page 144: Related Information
Adaptec SCSI RAID Software Reference Guide Use the container list command after using the container scrub command to display information about the scrubbed array, as in the following example: AAC0>container list Executing: container list Total Oth Stripe Dr Label Type...
Page 145: Container Set Cache
container set cache To set cache parameters for a specific array, use the container set cache command. You can use this command only if a native operating system’s file system—for Windows NT/Windows 2000 (basic disk only)/Windows XP (basic disk only), NTFS, or FAT— resides on the array.
Page 146: Parameters
Adaptec SCSI RAID Software Reference Guide Parameters {container} Specifies the ID number (0 to 63) of the array on which you want to set cache parameters. Switches /read_cache_enable{=boolean} Specifies whether to enable the read-ahead cache. If you set this switch to TRUE, the command enables the read-ahead cache for the specified array.
Page 147: Examples
Table 5-5 summarizes the values for the /write_cache_enable and /unprotected switches: Table 5-5. Switch Values and Results /write_cache_enable /unprotected Switch Setting Switch Setting FALSE FALSE FALSE TRUE TRUE FALSE TRUE TRUE Examples Before setting cache parameters for a specific array, use the container list command to obtain information about any existing arrays.
Page 148: Related Information
Adaptec SCSI RAID Software Reference Guide The following example sets cache parameters for array 0 by accepting all of the defaults: AAC0>container set cache 0 Executing: container set cache 0 After setting cache parameters for a specific array, use the...
Page 149: Container Set Failover
container set failover To assign an automatic failover disk(s) for a single array, use the container set failover command. If the array was already assigned a failover disk(s), the command adds the specified disk(s) to the array’s list of failover disk(s). Although all array types accept failover assignments, only mirror set and RAID-5 set (redundant) array types use the failover assignment if a disk fails.
Page 150: Related Information
Adaptec SCSI RAID Software Reference Guide As the following example shows, there is an array 0 (a mirror set) on this controller: AAC0>container list Executing: container list Total Oth Stripe Dr Label Type Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ ------------- D: 0 Mirror 10.0MB...
Page 151: Container Set Global_Failover
container set global_failover To assign an automatic failover disk(s) for all arrays, use the container set global_failover command. If the array was already assigned a failover disk(s), the command adds the specified disk(s) to the array’s list of failover disk(s). Although all array types accept failover assignments, only mirror set and RAID-5 set (redundant) array types use the failover assignment if a disk fails.
Page 152: Related Information
Adaptec SCSI RAID Software Reference Guide The following example assigns two SCSI failover disks to all arrays. If you assign only one SCSI disk as a failover device, ensure that there is sufficient freespace. If you assign more than one SCSI disk as failover devices, you need ensure that only one of these disks has sufficient space.
Page 153: Container Set Io_Delay
container set io_delay To set the I/O delay for an array, use the container set io_delay command. You can specify an I/O delay for the following array-related tasks: ■ Creating a mirror set ■ Creating a multilevel array of mirror sets from a multilevel array of volume sets ■...
Page 154: Examples
Adaptec SCSI RAID Software Reference Guide Examples Before setting the I/O delay on an array, use the container list command to obtain information about any existing arrays. As the following example shows, there is an array 0 (a volume set) on this controller: AAC0>container list...
Page 155: Related Information
Related Information container commands: ■ container create mirror ■ container create mmirror ■ (page container list ■ (page container scrub container Commands (page 5-5) (page 5-9) 5-54) 5-94) 5-107...
Page 156: Container Set Label
Adaptec SCSI RAID Software Reference Guide container set label To assign a new label to the specified array or to assign a label to an array that has no label, use the container set label command. The following commands have a assign a label to the array when you create it: ■...
Page 157: Related Information
AAC0>container list Executing: container list Total Oth Stripe Dr Label Type Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ ------------- Volume 15.0MB The following example assigns the label Tigris to array 0: AAC0>container set label 0 Tigris Executing: container set label 0 "Tigris"...
Page 158: Container Show Cache
Adaptec SCSI RAID Software Reference Guide container show cache To display the current cache parameters associated with a specific array, use the container show cache command. Typically, you use this command after setting cache parameters for a specific array using the container set cache command.
Page 159 The following example displays cache parameters for array 0: AAC0>container show cache 0 Executing: container show cache 0 Global container Read Cache Size Global container Write Cache Size : 1970176 Read Cache Setting : ENABLED Write Cache Setting : ENABLED Write Cache Status : ENABLED The following list provides a brief description of the items that...
Page 160 Adaptec SCSI RAID Software Reference Guide Table 5-6. Values for the Write Cache Setting Value Meaning The write cache is disabled for this array DISABLE The write cache setting for the specified array ENABLE ALWAYS is enabled always. This means the controller forces the enabling of the array’s write cache...
Page 161 Table 5-7 displays the values for Write Cache Status: Table 5-7. Values for Write Cache Status Value Meaning Active, not protected The status of the write cache for this array is as follows: ■ Active – The write cache can accept write operations from the array.
Page 162 Adaptec SCSI RAID Software Reference Guide Table 5-7. Values for Write Cache Status (Continued) Value Meaning Active, not protected, The status of the write cache for this array is as battery reconditioning follows: ■ Active – The write cache can accept write operations from the array.
Page 163: Related Information
Table 5-7. Values for Write Cache Status (Continued) Value Meaning Inactive, cache The status of the write cache for this array is as disabled follows: ■ Inactive – The write cache cannot accept write operations from the array. ■ Cache disabled – The user disabled the write cache by using the cache priate switches.
Page 164: Container Show Failover
Adaptec SCSI RAID Software Reference Guide container show failover To display a list of failover disks assigned to an array, use the container show failover command. You assign failover disks to an array with the container Syntax container show failover [{container}]...
Page 165: Container Split
container split To split a mirror set or a multilevel array of mirror sets into two separate single-partition volume sets or two multilevel arrays of single-partition volume sets, use the container split command. Once this command completes execution, the two volume sets cannot be merged.
Page 166: Parameters
Adaptec SCSI RAID Software Reference Guide Parameters {container} Specifies the ID number (0 to 63) of the array (mirror set or multilevel array of mirror sets) to split into two separate arrays. Examples Before splitting a mirror set or a multilevel array of mirror sets, use the container list command to obtain information about any existing arrays.
Page 167 Use the container list command after using the command to display information about the split mirror set, split as in the following example: AAC0>container list Executing: container list Total Oth Stripe Dr Label Type Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ ------------- F: 0 Volume 10.0MB Volume 10.0MB...
Page 168: Related Information
Adaptec SCSI RAID Software Reference Guide Related Information container commands: ■ container create mirror ■ container create mmirror ■ (page container list ■ container unmirror disk commands: ■ disk remove dead_partitions 5-120 (page 5-5) (page 5-9) 5-54) (page 5-123) (page...
Page 169: Container Unlock
container unlock Caution: Use the container unlock command only under the direction of Technical Support. To unlock an array so it can be moved, deleted, made read-only, and used to create a multilevel array, use the container unlock command. Syntax container unlock {container} Parameters {container}...
Page 170: Related Information
Adaptec SCSI RAID Software Reference Guide The following example shows how to unlock array 0: AAC0>container unlock 0 Executing: container unlock 0 Use the container list command (with the /full switch) after using the container unlock command to display information about the unlocked array, as in the following example: AAC0>container list /full...
Page 171: Container Unmirror
container unmirror To unmirror a mirror set, resulting in a single-partition volume set and freespace, use the container unmirror command. Note that there is no equivalent command for a multilevel array of mirror sets. To unmirror a multilevel array of mirror sets, use this command for each underlying mirror set.
Page 172: Related Information
Adaptec SCSI RAID Software Reference Guide The following example shows how to unmirror a mirror set from the mirror set that resides on SCSI device (0,3,0): AAC0>container unmirror 0 Executing: container unmirror 0 Note that the example eliminates some items in the container list display so that you can see an example of the State column.
Page 173: Controller Commands
controller Commands In this Chapter controller details controller firmware compare controller firmware save controller firmware update controller list controller pause_io controller rescan controller reset_scsi_channel controller resume_io controller set automatic_failover controller set array_verify controller show automatic_failover controller show channels controller show array_verify 6-10 6-11 6-13...
Page 174: Examples
Adaptec SCSI RAID Software Reference Guide controller details To display details about the currently opened controller and software, use the controller details command. These details include the controller type and software revision levels. Syntax controller details Examples The following example shows sample output as a result of using the controller details command: AAC0>...
Page 175 In the example, the controller name is AAC0. The Controller type Item The Controller type: item displays the controller type. In the example, the controller type is Adaptec 5400S. The Access Mode Item The Access Mode: item displays the access mode of the controller.
Page 176 Adaptec SCSI RAID Software Reference Guide Table 6-1. Controller CPU Types Controller CPU Type Meaning Strong Arm 110 The CPU type on the controller is a Digital Strong Arm 110. The example uses this CPU type. The Controller CPU Speed and Controller Memory Items The Controller CPU Speed: item (if available) displays the clock speed (in megahertz) of the CPU that resides on the controller.
Page 177 The Component Revisions Items Table 6-3 describes each of the Component Revisions: items. This information is useful if you ever need to contact a technical support representative. Table 6-3. Component Revision Items Component Revision Item Meaning CLI: Displays the revision level of the Command Line Interface.
Page 178: Related Information
Adaptec SCSI RAID Software Reference Guide Related Information General control commands: ■ (page 4-3) open...
Page 179: Controller Firmware Compare
controller firmware compare To compare the contents of each of the flash components on a controller to the corresponding image in a pair of user flash image (UFI) files and indicate whether they match, use the controller firmware compare command. Syntax controller firmware compare [/C[{controller_ID}][{controller_ID}...]...
Page 180: Controller Firmware Save
Adaptec SCSI RAID Software Reference Guide controller firmware save To save the contents of a controller’s flash in a pair of user flash image (UFI) files, use the controller firmware save command. The names of the pair of UFI files are based on the controller type and cannot be changed.
Page 181: Related Information
Related Information: controller commands: ■ controller firmware compare ■ controller firmware update controller Commands (page 6-7) (page 6-10)
Page 182: Controller Firmware Update
Adaptec SCSI RAID Software Reference Guide controller firmware update To update a controller’s flash components from the flash image data in a pair of user flash image (UFI) files, use the controller firmware update command. This command can update the flash components on a single controller or multiple controllers.
Page 183: Controller List
The following example shows how to list all controllers on a local computer: AAC0> controller list Executing: controller list Adapter Name Adapter Type ------------ ------------ \\.\AAC0 Adaptec 5400S The following sections provide descriptions of the items in the display. controller Commands Availability ------------ read/write 6-11...
Page 184: Related Information
In the example, there is only one controller on the local computer and it is called AAC0. The Adapter Type item displays the controller type. In the example, the controller type is Adaptec 5400S. The Availability Item The Availability item displays the availability of the controller.
Page 185: Controller Pause_Io
controller pause_io To pause all I/O activity on the currently opened controller, use the controller pause_io command. While I/O activity is paused, you can make changes to devices attached to the controller without rebooting. For example, you can add, remove, or change SCSI channel assignments.
Page 186: Command And Switch Availability
Adaptec SCSI RAID Software Reference Guide Command And Switch Availability This command is supported on the following operating systems: ■ Windows NT ■ Windows 2000 (basic disk only) ■ Windows XP (basic disk only) ■ NetWare Notes The controller automatically performs a rescan of the SCSI channel before the I/O is resumed.
Page 187: Related Information
Related Information controller commands: ■ controller resume_io task commands: ■ (page task list 10-2) controller Commands (page 6-18) 6-15...
Page 188: Controller Rescan
Adaptec SCSI RAID Software Reference Guide controller rescan To rescan the SCSI channels on the currently opened controller and update all underlying structures, use the controller rescan command. The effect of this command is to verify currently connected disks or to recognize new disks added to the channel.
Page 189: Examples
controller reset_scsi_channel To reset a specific SCSI channel, use the controller reset_scsi_channel command. Syntax controller reset_scsi_channel {integer} Parameters {integer} Specifies the controller channel (for example, 0, 1, 2, 3, etc.) on which you want to reset this SCSI channel. See the installation guide for your controller to determine the number of channels it actually supports.
Page 190: Related Information
Adaptec SCSI RAID Software Reference Guide controller resume_io To rescan the SCSI channels and resume all I/O activity on the currently opened, previously paused controller, use the controller resume_io command. You use this command after pausing the controller with the controller pause_io command.
Page 191: Notes
controller set automatic_failover Automatic failover allows you to replace a failed disk with a replacement disk. The controller then automatically assigns the disk you insert as a failover disk without your having to first assign it with the array set failover or array set global_failover command.
Page 192: Related Information
Adaptec SCSI RAID Software Reference Guide Specifies whether to turn on or off automatic failover on the specified controller. You must set this switch to TRUE if you want to turn on automatic failover on the specified controller. To turn off automatic failover on the specified controller, set this switch to FALSE.
Page 193: Controller Set Array_Verify
controller set array_verify To enable or disable the array verify operation, use the controller set verify command. This command allows you to enable or disable the array verify operation for all arrays controlled by the specified controller. Syntax controller set array_verify [/verify_enabled{=boolean}] /verify_enabled{=boolean} Specifies whether to turn on or off the array verify feature on...
Page 194: Related Information
Adaptec SCSI RAID Software Reference Guide The controller show array_verify command indicates that the controller’s array verify feature is currently on (enabled). The command also displays the number of errors (if any) found as a result of the array verify operation.
Page 195: Related Information
controller show automatic_failover To display the automatic failover status (enabled or disabled) for the specified controller, use the controller show automatic_failover command. Syntax controller show automatic_failover Examples The following example shows that the controller’s automatic failover is currently off (disabled): AAC0>...
Page 196: Controller Show Channels
Adaptec SCSI RAID Software Reference Guide controller show channels To show all of the channels on a controller and the associated characteristics of each channel, use the controller show channels command. See the installation guide for your controller to determine the number of channels it actually supports.
Page 197 The Host ID item displays the SCSI device ID of the host controller, which in the example is 7 for all channels. The Targets and Type Items The Targets item displays the number of SCSI device IDs not including the controller ID, which in the example is 15 for all channels.
Page 198: Related Information
Adaptec SCSI RAID Software Reference Guide The Max Usage Item The Max Usage item displays the best speed the channel is running at, which in the example is NoInfo for all channels. If drives other than Ultra-2 are present on the system, the entire channel is limited to UltraWide.
Page 199: Related Information
controller show array_verify To display the array verify status (enabled or disabled) for the specified controller, use the controller show array_verify command. Syntax controller show array_verify Examples Before turning the array verify feature on or off, check its status by using the controller show array_verify command.
Page 200 Adaptec SCSI RAID Software Reference Guide 6-28...
Page 201 disk Commands In this Chapter disk blink disk initialize disk list disk remove dead_partitions disk set default disk set smart disk show default disk show defects disk show partition disk show smart disk show space disk verify disk zero Use the following syntax for disk commands: disk command [object] [/switch{=value}] [parameter] 7-10...
Page 202: Disk Blink
Adaptec SCSI RAID Software Reference Guide disk blink To cause a SCSI disk access light to blink (or stop blinking), use the disk blink command. Syntax disk blink [/wait{=boolean}] {scsi_device} {integer} Parameters {scsi_device} Specifies the ID for the SCSI disk you want to blink. A SCSI ID consists of a SCSI channel number (for example, 0, 1, 2, 3, etc.),...
Page 203: Examples
disk initialize To initialize a SCSI disk for use with the currently opened controller, use the disk initialize command. This command writes data structures to the disk so that the controller can use the disk. Syntax disk initialize [/always{=boolean}] [/unconditional{=boolean}]{scsi_device} Parameters {scsi_device} Specifies the ID for the SCSI disk you want to prepare and...
Page 204: Examples
Adaptec SCSI RAID Software Reference Guide The default is FALSE; that is, the disk initialize command does not initialize a disk that has open files on it. WARNING: Unconditionally deleting an array that is in use can cause a system crash under some circumstances.
Page 205: Disk List
disk list To display a list of the disks available on the currently opened controller, use the disk list command. Syntax disk list [/all{=boolean}] [/full{=boolean)] [{scsi_device}] Parameters {scsi_device} Specifies the ID for a specific SCSI device for which you want to display information.
Page 206: Examples
Adaptec SCSI RAID Software Reference Guide AAC0>disk list Executing: disk list C:ID:L Device Type Blocks Bytes/Block ------ ---------- --------- ----------- ----------- ------ ---- 2:00:0 Disk 8887200 2:01:0 Disk 8887200 2:02:0 Disk 8496960 2:03:0 Disk 8887200 The detailed disk list display contains the previous columns of information plus the following columns: ■...
Page 207 Value Meaning Printer The device type is a SCSI printer device. Processor The device type is a processor device. Write once The device type is a SCSI write once and read many times device. Typically, these devices are referred to as WORM disk drives. CDROM The device type is a SCSI CD-ROM (read-only direct access device).
Page 208: Related Information
Adaptec SCSI RAID Software Reference Guide The Usage Column The Usage column displays the usage of the SCSI device. The disk list command can display one of the values listed in Table 7-2. Table 7-2. SCSI Disk Device Usage Values...
Page 209: Disk Remove Dead_Partitions
disk remove dead_partitions To remove all dead partitions from a SCSI disk, use the disk remove dead_partitions command. A dead partition is a partition that is no longer used by any array. Typically, you use this command only under specific circumstances. For example, if you remove a disk from a redundant array and then later add the disk to the controller, the partition on the reinserted disk (which was previously part of the redundant array) is no longer...
Page 210: Related Information
Adaptec SCSI RAID Software Reference Guide Related Information array commands: ■ (page 5-54) array list 7-10...
Page 211: Disk Set Default
disk set default To set the default SCSI ID for use in subsequent CLI commands, use the disk set default command. This command allows you to set defaults for a specific SCSI device’s SCSI device channel number and SCSI device logical unit number. Then, in subsequent commands, you need only specify the SCSI device ID on the command line.
Page 212: Related Information
Adaptec SCSI RAID Software Reference Guide See the disk list command for information on the items in the display. Related Information disk commands: ■ (page 7-5) disk list ■ (page disk show default 7-12 7-15)
Page 213: Disk Set Smart
disk set smart To change a device’s S.M.A.R.T. configuration, use the disk set smart command. The acronym S.M.A.R.T. stands for Self- Monitoring, Analysis and Reporting Technology. This technology is an industry standard for hard drives that monitors a variety of disk parameters, such as the rate of read-write errors.
Page 214: Switches
Adaptec SCSI RAID Software Reference Guide Switches /all{=boolean} Specifies whether to enable S.M.A.R.T. configurations (enable exception reporting) for all disks on the system. If you specify TRUE for this switch, the command enables S.M.A.R.T. configurations for all disks on the system.
Page 215: Examples
/mrie={integer} <?> /perf{=boolean} Specifies whether to report exceptions according to the MRIE mode taking into account performance. If you specify TRUE for this switch, the command performs exception reporting as long as performance is not an issue. If performance is an issue, the command does not report exceptions.
Page 216: Disk Show Default
Adaptec SCSI RAID Software Reference Guide disk show default To display the current default for the SCSI device ID, use the disk show default command. You previously set this default using the disk set default command. Syntax disk show default...
Page 217: Disk Show Defects
disk show defects To show the number of defects and/or the defect list for a specific SCSI disk drive, use the disk show defects command. Syntax disk show defects [/full{=boolean}]{scsi_device} Parameters {scsi_device} Specifies the ID for the SCSI device for which you want to display defect information.
Page 218 Adaptec SCSI RAID Software Reference Guide The following list explains the items in the display: ■ Number of PRIMARY defects on drive: This item shows the details regarding any primary disk defects. In the example, there are two defects. ■...
Page 219: Disk Show Partition
disk show partition To display a list of partitions on the disks attached to the currently opened controller, use the disk show partition command. Syntax disk show partition Examples The following example shows a sample output from the disk show partition command: AAC0>disk show partition Executing: disk show partition...
Page 220 Adaptec SCSI RAID Software Reference Guide The Array Num and Array Type Columns The Array Num column displays the ID of the primary array in the partition. In the example, the array ID is 0. The Array Type column displays the type of array in which the partition resides.
Page 221 The R/W Column The R/W column displays whether the partition is read-only or read-write. Specifically, the column can display the values listed in Table 7-5. Table 7-5. R/W Array Values Value Meaning The partition is read-only. The partition is read-write. disk Commands 7-21...
Page 222: Disk Show Smart
Adaptec SCSI RAID Software Reference Guide disk show smart To display S.M.A.R.T. configuration information for one or all disks, use the disk show smart command. The acronym S.M.A.R.T. stands for Self-Monitoring, Analysis and Reporting Technology. This technology is an industry standard for hard drives that monitors a variety of disk parameters, such as the rate of read-write errors.
Page 223: Examples
information. If you specify FALSE, the command does not display detailed S.M.A.R.T. configuration information. This switch defaults to FALSE. /view_changeable{=boolean} Specifies whether to display the configuration information that can be set on a S.M.A.R.T. disk. If you specify TRUE for this switch, the command displays the letter “X”...
Page 224 Adaptec SCSI RAID Software Reference Guide the currently opened controller. (The display shows only one disk if you specified a particular disk.) In the example, the command displays the SCSI channel number, the SCSI device ID, and the SCSI device logical unit number for the four disks on the open controller.
Page 225: Related Information
disk Commands If you specified the /view_changeable switch, the command displays an X in this column for those disks on which you can enable log errors. The Interval Timer (secs.) Column The Interval Timer (secs.) column displays the number of seconds specified for the exception reporting interval.
Page 226: Disk Show Space
Adaptec SCSI RAID Software Reference Guide disk show space To display space usage information on a SCSI disk, use the disk show space command. Syntax disk show space [/all{=boolean}] [{scsi_device}] Parameters {scsi_device} Specifies the ID for the SCSI device for which you want to display space usage information.
Page 227 The following example shows space usage information for SCSI disk device (0,2,0): AAC0>disk show space (0,2,0) Executing: disk show space (ID=2) Scsi C:ID:L Usage Size ----------- --------- ------------- 0:02:0 Array 64.0KB: 0:02:0 Free 20.0MB: The following sections provide more information on the columns that the disk show space command displays.
Page 228 Adaptec SCSI RAID Software Reference Guide The Size Column The Size column displays the offset (in bytes) into the SCSI device and the size of the partition or space (in bytes). In the example, the offset and sizes for the first two disks are as follows: ■...
Page 229: Disk Verify
disk verify To verify all blocks on a SCSI disk device and, optionally, repair any bad blocks, use the disk verify command. Syntax disk verify [/repair{=boolean}] [/wait{=boolean}] {scsi_device} Parameters {scsi_device} Specifies the ID for the SCSI disk device that you want to verify.
Page 230: Examples
Adaptec SCSI RAID Software Reference Guide Examples The following example synchronously verifies and repairs all blocks on disk (0,2,0): AAC0>disk verify /repair=TRUE /wait=TRUE (0,2,0) Executing: disk verify (CHANNEL=0,ID=2,LUN=0) As the command executes, note the title bar of the DOS window displays the status of the command.
Page 231: Disk Zero
disk zero To clear an entire SCSI disk, use the disk zero command. When you clear a disk, all data is erased and cannot be recovered. Command And Switch Availability This command and its associated switch (or switches) are supported on the following operating systems: ■...
Page 232: Examples
Adaptec SCSI RAID Software Reference Guide /wait{=boolean} Specifies whether to clear the disk synchronously or asynchronously. If you set this switch to TRUE, the command clears the disk synchronously and the command prompt does not return until the clear disk task completes.
Page 233: Syntax
diagnostic Commands In this Chapter diagnostic clear boot_parameters diagnostic dump structures diagnostic dump text diagnostic load_arrays diagnostic moderation set count diagnostic moderation set timer diagnostic moderation show count diagnostic moderation show timer diagnostic set boot_parameter diagnostic show boot_parameter diagnostic show history The diagnostic commands are used to help fix problems that can occur during controller operation.
Page 234: Related Information
Adaptec SCSI RAID Software Reference Guide diagnostic clear boot_parameters To clear all boot-time parameters contained in the currently opened controller’s parameters, use the diagnostic clear boot_parameters command. Under normal conditions, no boot- time parameters are set. Caution: Use this command only under the direction of technical support.
Page 235: Diagnostic Commands
diagnostic dump structures To save internal data structures to a file for use by technical support, use the diagnostic dump structures command. Caution: Use this command only under the direction of technical support. Syntax diagnostic dump structures Parameters {string} Specifies the name of the file to contain the internal data structures.
Page 236: Related Information
Adaptec SCSI RAID Software Reference Guide diagnostic dump text To display diagnostic information on the console display for use by technical support during bug reporting, use the diagnostic dump text command. Caution: Use this command only under the direction of technical support.
Page 237: Related Information
Examples The following example displays diagnostic information on the console display: AAC0>diagnostic dump text Executing: diagnostic dump text Partitions:6 The command displays a variety of information in table format. It also displays: *** HISTORY BUFFER FROM LAST RUN *** [00]: *** HISTORY BUFFER FROM CURRENT CONTROLLER RUN *** [00]: ==============...
Page 238: Related Information
Adaptec SCSI RAID Software Reference Guide diagnostic load_arrays To load arrays when the system is in maintenance mode, use the diagnostic load_arrays command. This command differs from controller rescan in that it does not rescan the SCSI channel. Caution: Use this command only under the direction of technical support.
Page 239: Diagnostic Moderation Set Count
diagnostic moderation set count To set the default interrupt count on the controller, use the diagnostic moderation set count command. Caution: Use this command only under the direction of technical support. Syntax diagnostic moderation set count {integer} Parameters {integer} Specifies the value (for example, 700) you want to set as the default interrupt count on the controller.
Page 240: Diagnostic Moderation Set Timer
Adaptec SCSI RAID Software Reference Guide diagnostic moderation set timer To set the default interrupt timer on the controller, use the diagnostic moderation set timer command. Caution: Use this command only under the direction of technical support. Syntax diagnostic moderation set timer {integer}...
Page 241: Diagnostic Moderation Show Count
diagnostic moderation show count To display the number of outstanding I/Os necessary to allow the delay of I/O request responses to the host computer, use the diagnostic moderation show count command. You may have previously specified the default interrupt count (the number of outstanding I/Os) with the diagnostic moderation set count command.
Page 242: Diagnostic Moderation Show Timer
Adaptec SCSI RAID Software Reference Guide diagnostic moderation show timer To display the time in 100 microsecond units that the controller batches I/O request responses before issuing an interrupt to the host computer, use the diagnostic moderation show timer command. You may have previously specified the default interrupt timer (the time in 100 microsecond units) with the diagnostic moderation set timer command.
Page 243: Related Information
diagnostic set boot_parameter To set boot-time parameters that a technical support representative might need, use the diagnostic set boot_parameter command. Caution: Use this command only under the direction of technical support. Syntax diagnostic set boot_parameter Parameters {string} Specifies the name of the boot-time parameter to be set. If you need to use this command, a technical support representative will tell you the name of the boot-time parameter to use.
Page 244: Syntax
Adaptec SCSI RAID Software Reference Guide diagnostic show boot_parameter To display a specific boot-time parameter (if one exists) that a technical support representative might need, use the diagnostic show boot_paramter command. Caution: Use this command only under the direction of technical support.
Page 245: Diagnostic Show History
diagnostic show history To display an internal history log of operations kept in the currently opened controller that a technical support representative might need, use the diagnostic show history command. Syntax diagnostic show history [/old{=boolean}] [/current{=boolean}] Switches /old{=boolean} Specifies whether to display the controller’s operations history log from the previous boot of the operating system.
Page 246 Adaptec SCSI RAID Software Reference Guide 8-14...
Page 247: Syntax
logfile Commands In this Chapter logfile end logfile start Use the following syntax for logfile commands: logfile command [/switch{=value}] [parameter]...
Page 248: Related Information
Adaptec SCSI RAID Software Reference Guide logfile end To end the logging of all output, use the logfile end command. Syntax logfile end Examples The following example stops logging information to the file aac0log17Nov01.txt (which was previously started with the logfile start command): AAC0>...
Page 249: Syntax
logfile start To begin the logging of all CLI command line activity to a specified file, use the logfile start command. CLI command line activity includes the associated output the CLI command displays. The CLI continues to log command output until you close the CLI or you explicitly end the logfile with the logfile end command.
Page 250: Related Information
Adaptec SCSI RAID Software Reference Guide The .txt extension allows the file to be read by the Windows NT/ Windows 2000 (basic disk only)/Windows XP (basic disk only) Notepad application: AAC0> logfile start c:\ctrloginfo\aac0log17Nov01.txt Executing: logfile start “c:\ctrloginfo\aac0log17Nov01.txt” File c:\ctrloginfo\aac0log17Nov01.txt receiving all output.
Page 251: Task Commands
task Commands In this Chapter task list task resume task stop task suspend Use the following syntax for task commands: task command [/switch{=value}] [parameter] 10-2 10-8 10-10 10-12 10-1...
Page 252: Task List
Adaptec SCSI RAID Software Reference Guide task list To display a list of one or all tasks running on the currently opened controller, use the task list command. A task is an operation that occurs only on the controller, asynchronous to all other operations.
Page 253 As the example shows, the typical display shows the following columns of information: ■ TaskId ■ Function ■ Done% ■ Array ■ State ■ Specific1 ■ Specific2 The following sections describe each column that the task list command displays. The Task ID Column The Task ID column displays the ID number associated with a specific task.
Page 254 Adaptec SCSI RAID Software Reference Guide Table 10-1. Task Types (Continued) Task Type Meaning NTFSfmt An array format NTFS file system task is running on the specified array. The format NTFS file system task runs as a result of using the...
Page 255 Table 10-1. Task Types (Continued) Task Type Meaning Verify A verify with no repair of bad blocks task is running on the specified SCSI disk. When the verify with no repair of bad blocks task completes, the specified SCSI disk’s blocks were verified without repairing any detected defects.
Page 256: The Specific2 Column
Adaptec SCSI RAID Software Reference Guide Table 10-2. State Values State Meaning The task failed and is no longer running. The task successfully completed or the task is no longer running (that is, the task is done). The task is running.
Page 257: Related Information
Table 10-4. Additional Specific2 Information Task . Refers to the verify with Verify repair of bad blocks task, which runs as a result of using the disk command with the verify repair switch. Related Information array commands: ■ array create mirror ■...
Page 258: Task Resume
Adaptec SCSI RAID Software Reference Guide task resume To resume one or all tasks previously suspended on the currently opened controller, use the task resume command. You suspend tasks with the task suspend command. Syntax task resume [/all{=boolean}] [{integer}] Parameters {integer} Specifies the task ID for the task to resume.
Page 259: Related Information
Use the task list command after using the task resume command to display information about the task, as in the following example: AAC0>task list Executing: task list TaskId Function Done% Array ------ -------- ----- --------- Scrub 24.6% 0 As a result of using the task resume command, the State column now displays RUN (running on the controller) instead of SUS (suspended on the controller).
Page 260: Task Stop
Adaptec SCSI RAID Software Reference Guide task stop To stop one or all tasks running on the currently opened controller, use the task stop command. Syntax task stop [/all{=boolean}] Parameters {integer} Specifies the task ID for the task to stop. Perform a task list /all to display the task IDs for all tasks currently running on the open controller before stopping a specific task or all tasks.
Page 261: Related Information
task Commands AAC0>task list Executing: task list No tasks currently running on controller. Related Information task commands: ■ (page 10-2) task list 10-11...
Page 262: Task Suspend
Adaptec SCSI RAID Software Reference Guide task suspend To suspend one or all tasks running on the currently opened controller, use the task suspend command. Syntax task suspend [/all{=boolean}] Parameters {integer} Specifies the task ID for the task to suspend. Perform a task...
Page 263: Related Information
Use the task list command after using the task suspend command to display information about the task, as in the following example: AAC0>task list Executing: task list TaskId Function Done% Array ------ -------- ------ --------- Scrub 24.6% As a result of using the task suspend command, the State column now displays SUS (suspended on the controller) instead of RUN (running on the controller).
Page 264 Adaptec SCSI RAID Software Reference Guide 10-14...
Page 265 enclosure Commands In this Chapter enclosure activate slot enclosure identify slot enclosure list enclosure prepare slot enclosure set alarm enclosure set door enclosure set fan enclosure set interval enclosure set power enclosure set scsiid enclosure set temperature enclosure show fan enclosure show power enclosure show slot enclosure show status...
Page 266 Adaptec SCSI RAID Software Reference Guide These enclosure commands operate on enclosure management devices that support Version 1.0 of the SCSI Accessed Fault-Tolerant Enclosures (SAF-TE) specification. Use the following syntax for enclosure commands: enclosure command [/switch{=value}] [parameter] 11-2...
Page 267: Enclosure Commands
enclosure activate slot To activate a device in a specified slot of the specified SAF-TE enclosure management device, use the enclosure activate slot command. Specifically, this command makes the device that resides in the slot available on the SCSI channel. Syntax enclosure activate slot {enclosure} {slot} Parameters...
Page 268: Related Information
Adaptec SCSI RAID Software Reference Guide 1:03:0 OK UNCONFIG ACTIVATE 1:04:0 OK UNCONFIG ACTIVATE The following example shows how to activate a device in slot 0 of enclosure management device 0 using the enclosure activate slot command: AAC0>enclosure activate slot 0 0...
Page 269: Enclosure Identify Slot
enclosure identify slot To identify a slot on a specified SAF-TE enclosure management device, use the enclosure identify slot command. Typically, an enclosure management device indicates to the operator which slot is currently being identified by flashing an adjacent light. Syntax enclosure identify slot {enclosure} {slot} Parameters...
Page 270: Related Information
Adaptec SCSI RAID Software Reference Guide Related Information enclosure commands: ■ enclosure activate slot ■ (page enclosure list ■ enclosure prepare slot ■ enclosure show slot 11-6 (page 11-3) 11-7) (page 11-12) (page 11-33)
Page 271: Enclosure List
enclosure list To display the list of components associated with one or all SAF-TE enclosure management devices connected to the controller, use the enclosure list command. Syntax enclosure list [/all{=boolean}] [/full{=boolean}] [{enclosure}] Parameters {enclosure} Specifies the ID associated with the enclosure management device whose associated components you want to display.
Page 272: Examples
Adaptec SCSI RAID Software Reference Guide Examples The following example shows a non-detailed list of components for enclosure management devices 0 and 1: AAC0>enclosure list /all=TRUE Executing: enclosure list /all=TRUE Enclosure Fan Power Slot Sensor Door ScsiId Speaker --------- --- ----- ---- ------ ---- ------ -------- -------- ----------...
Page 273 The Enclosure Column The Enclosure column displays the ID of a specific enclosure management device. This is the ID that you specify for the enclosure parameter on the command line. In the example, the enclosure list command displays enclosure management device IDs 0 and 1 (because the /all switch was specified).
Page 274 Adaptec SCSI RAID Software Reference Guide The Door Column The Door column displays the number of doors on the enclosure management device. Typically, enclosure management devices support a maximum of sixteen doors. In the example, enclosure management devices 0 and 1 each have five doors.
Page 275: Related Information
Specifically, the column can display the items listed in Table 11-2. Table 11-2. Diagnostic Status Status Meaning PASSED No errors were detected and the diagnostic self-tests were successful. This is the value displayed in the example for both enclosure management devices. FAILED Errors were detected and the diagnostic self-tests were not successful.
Page 276: Enclosure Prepare Slot
Adaptec SCSI RAID Software Reference Guide enclosure prepare slot To indicate to the SAF-TE enclosure management device that it should take the appropriate action to prepare the device in a specific slot for removal or insertion, use the enclosure prepare slot command.
Page 277: Related Information
The following example prepares the device in slot 0 on enclosure management device 0 for insertion or removal as a result of using the enclosure prepare slot command: AAC0>enclosure prepare slot 0 0 Executing: enclosure prepare slot 0 0 You may want to use the enclosure show slot command again to see the change in the device slot’s status, as in the following example: AAC0>enclosure show slot...
Page 278: Enclosure Set Alarm
Adaptec SCSI RAID Software Reference Guide enclosure set alarm To turn the audible alarm on a specific SAF-TE enclosure management device on or off, use the enclosure set alarm command. Syntax enclosure set alarm [/on{=boolean}] {enclosure} Parameters {enclosure} Specifies the ID associated with the enclosure management device whose audible alarm you want to set.
Page 279: Enclosure Set Door
enclosure set door To lock or unlock a specific door on a specific SAF-TE enclosure management device, use the enclosure set door command. Syntax enclosure set door [/lock{=boolean}] {enclosure} {door} Parameters {enclosure} Specifies the ID associated with the enclosure management device on which you want to lock the door.
Page 280: Enclosure Set Fan
Adaptec SCSI RAID Software Reference Guide enclosure set fan To set the speed of a specific fan on a specific SAF-TE enclosure management device, use the enclosure set fan command. Syntax enclosure set fan [/off{=boolean}] {enclosure} {fan} [{speed}] Parameters {enclosure} Specifies the ID associated with the enclosure management device on which you want to set the speed of a specific fan.
Page 281: Related Information
Switches /off{=boolean} Specifies whether to turn off the fan associated with the specified unit number. If you set this switch to TRUE, the command turns off the fan associated with the specified unit number. You must turn on the fan if you want to set its speed. This switch defaults to FALSE, which means the fan remains on and you can set its speed.
Page 282: Enclosure Set Interval
Adaptec SCSI RAID Software Reference Guide enclosure set interval To set the monitor reporting interval for a specific SAF-TE enclosure management device, use the enclosure set interval command. The monitor reporting interval indicates how often the controller checks the status of the enclosure management device and its associated components.
Page 283: Related Information
The following example sets the monitor reporting interval for enclosure management devices 0 and 1 to 20 seconds: AAC0>enclosure set interval 20 Executing: enclosure set interval 20 You may want to use the enclosure show status command again to see the change in the power supply’s status, as in the following example: Enclosure UpTime D:H:M PowerCycle Interval Door...
Page 284: Enclosure Set Power
Adaptec SCSI RAID Software Reference Guide enclosure set power To turn the power of a specific power supply on a specific SAF-TE enclosure management device on or off, use the enclosure set power command. Typically, most enclosure management devices turn on their associated power supplies by default after power up.
Page 285: Related Information
shows, power supply 0 on enclosure management device 1 is off and operational: AAC0>enclosure show power Executing: enclosure show power Enclosure Power State Status --------- ----- ------------ ------- The following example turns on power supply 0 on enclosure management device 1: AAC0>enclosure set power 1 0 Executing: enclosure set power 1 0 You may want to use the enclosure show power command...
Page 286: Enclosure Set Scsiid
Adaptec SCSI RAID Software Reference Guide enclosure set scsiid To set the SCSI device ID for a specific device slot on a specific SAF- TE enclosure management device, use the enclosure set scsiid command. As discussed in other chapters, a SCSI ID...
Page 287: Examples
{device_id} Specifies the ID (0 through 15 inclusive) of the SCSI device you want to assign to the specified device slot. Examples Before setting a device slot to a specific SCSI ID, you might want to use the enclosure show slot command to determine the current SCIS ID setting for the device slots, as in the following example: AAC0>enclosure show slot...
Page 288: Related Information
Adaptec SCSI RAID Software Reference Guide 1:03:0 OK UNCONFIG ACTIVATE 1:04:0 OK UNCONFIG ACTIVATE Related Information controller commands: ■ controller pause_io enclosure commands: ■ (page enclosure list ■ enclosure show slot 11-24 (page 6-13) 11-7) (page 11-33)
Page 289: Parameters
enclosure set temperature To set the temperature threshold on a specific SAF-TE enclosure management device, use the enclosure set temperature command. Typically, an enclosure management device contains individual temperature sensors. With this command, you can set a temperature threshold so that the enclosure management device alerts you if one or more of the temperature sensors exceeds the threshold.
Page 290 Adaptec SCSI RAID Software Reference Guide AAC0>enclosure set temperature 0 100 Executing: enclosure set temperature 0 100 You may want to use the enclosure show temperature command again to see the change in threshold temperature, as in the following example: AAC0>enclosure show temperature 0...
Page 291: Syntax
enclosure show fan To display the status of a specific fan on a specific SAF-TE enclosure management device, use the enclosure show fan command. You can also use this command to display the status of all fans on the enclosure management device or devices. Syntax enclosure show fan [{enclosure}] [{fan}] Parameters...
Page 292: Examples
Adaptec SCSI RAID Software Reference Guide Examples The following example displays the status of all fans on enclosure management devices 0 and 1: AAC0>enclosure show fan Executing: enclosure show fan Enclosure Fan Status --------- --- ------------- NOT INSTALLED As the example shows, the fan status display contains the following columns: ■...
Page 293: Related Information
Table 11-4. Fan Status Values Status Meaning The fan is operational. In the example, fan 0 on enclosure management device 0 is operational. The fan is not working properly. NOT INSTALLED The fan is not installed. In the example, fan 0 on enclosure management device 1 is not installed.
Page 294: Syntax
Adaptec SCSI RAID Software Reference Guide enclosure show power To display the status of a specific power supply on a specific SAF-TE enclosure management device, use the enclosure show power command. You can also use this command to display the status of all power supplies on the enclosure management device or devices.
Page 295 As the example shows, the power supply status display contains the following columns: ■ Enclosure ■ Power ■ State ■ Status The following sections describe the information that the enclosure show power command can display in these columns. The Enclosure and Power Columns The Enclosure column displays the ID associated with the enclosure management device that you specified on the command line.
Page 296: Related Information
Adaptec SCSI RAID Software Reference Guide Status State INSTALLED UNKNOWN Not Applicable INSTALLED UNKNOWN UNKNOWN Related Information enclosure commands: ■ (page enclosure list ■ enclosure set power 11-32 Meaning The power supply is on and not working properly. The power supply is off and not working properly.
Page 297: Enclosure Show Slot
enclosure show slot To display the status of a specific device slot on a specific SAF-TE enclosure management device, use the enclosure show slot command. You can also use this command to display the status of all device slots on the enclosure management device or devices. Syntax enclosure show slot [{enclosure}] [{slot}] Parameters...
Page 298: Examples
Adaptec SCSI RAID Software Reference Guide Examples The following example displays the status of all device slots on enclosure management devices 0 and 1: AAC0>enclosure show slot Executing: enclosure show slot Enclosure Slot scsiId Insert Status --------- ---- ------ ------- -----------------------------------...
Page 299 show slot command displays the device slot status for device slots 0 through 4 for enclosure management devices 0 and 1. The scsiId Column The scsiId column displays the SCSI ID associated with the device slot. A SCSI ID consists of a SCSI channel number (for example, 0, 1, 2, 3, etc.), SCSI device ID (0 through 15 inclusive), and SCSI device logical unit number (0 through 7 inclusive).
Page 300: Related Information
Adaptec SCSI RAID Software Reference Guide Table 11-6. Device Slot Status Values (Continued) Status Meaning WARNING The device that resides in this slot is likely to fail in the near future. UNCONFIG The device that resides in this slot is not currently configured as a member of a device array or as a hot spare.
Page 301: Enclosure Show Status
enclosure show status To display the general status of a specific SAF-TE enclosure management device, use the enclosure show status command. You can also use this command to display the general status of all enclosure management devices connected to the controller.
Page 302 Adaptec SCSI RAID Software Reference Guide Enclosure Fan Status --------- --- ------------- Enclosure Power State Status --------- ----- ------------ ------- UNKNOWN UNKNOWN Enclosure Slot scsiId Insert Status --------- ---- ------ ------- ------------------------------------------ 0:00:0 OK UNCONFIG ACTIVATE 0:01:0 OK UNCONFIG ACTIVATE...
Page 303 ■ Interval ■ Door ■ Alarm The following sections describe the information that the enclosure show status command can display in these columns. For information about the status displays for fans, power supplies, device slots, and temperature sensors see the Related Information section.
Page 304: Related Information
Adaptec SCSI RAID Software Reference Guide The Door and Alarm Columns The Door column displays the status of the door lock. The enclosure show status command can display the door lock status values listed in Table 11-7. Table 11-7. Door Lock Status Values...
Page 305: Enclosure Show Temperature
enclosure show temperature To display the temperature status of a specific temperature sensor on a specific SAF-TE enclosure management device, use the enclosure show temperature command. You can also use this command to display the temperature status of all temperature sensors on the enclosure management device or devices.
Page 306 Adaptec SCSI RAID Software Reference Guide As the example shows, the temperature sensor status display contains the following columns: ■ Enclosure ■ Sensor ■ Temperature ■ Threshold ■ Status The following sections describe the information that the enclosure show temperature command can display in these columns.
Page 307: Related Information
The Status Column The Status column displays the status of the temperature displayed in the Temperature column. The enclosure show temperature command can display the temperature status values listed in Table 11-9. Table 11-9. Temperature Status Values Status Meaning NORMAL The temperature is within the normal range for this temperature sensor.
Page 308 Adaptec SCSI RAID Software Reference Guide 11-44...
Page 309: Using The Adaptec Flash Utility
The Adaptec Flash Utility (AFU) is a DOS application used to update the flash EEPROM components on one or more Adaptec SCSI RAID controllers. The utility can also be used to verify a controller’s current flash contents against the flash images in a specified file or to save a controller’s current flash contents to a file.
Page 310: Overview Of The Afu
Adaptec SCSI RAID Software Reference Guide Your Adaptec RAID controller uses nonvolatile flash to store on- board software, such as BIOS, microprocessor kernel, and monitor. Whenever it becomes necessary to update any of those components you can update your controller’s flash components using the AFU.
Page 311: System Requirements
■ If you want to update multiple controllers in the same system, it is recommended that you first update the “boot” controller’s flash, reboot the system, and then update any remaining controllers’ flash components. Using the Adaptec Flash Utility 12-3...
Page 312: Firmware Floppy Kit
Adaptec SCSI RAID Software Reference Guide Firmware Floppy Kit Controller firmware is delivered on CD–ROM, or updates may be downloaded from the Adaptec website www.adaptec.com. The CD includes the AFU executable AFU.exe, the corresponding documentation, and a separate flash image. The flash image may be comprised of multiple user flash image (UFI) files.
Page 313: Running The Afu
The syntax of the AFU command line is as follows: AFU <Command> [/C<Controller ID>] [/D <UFI File Path>] [/?] In this command line: The AFU will prompt you to insert additional floppy diskettes as required. Using the Adaptec Flash Utility 12-5...
Page 314 Adaptec SCSI RAID Software Reference Guide ■ <Command> is a keyword specifying the AFU function to be performed. The <Command> keyword must immediately follow the AFU command. The valid command keywords are as follows: – HELP—Displays AFU help text – LIST—Lists the AFU-supported controllers installed on this system –...
Page 315: Flashing The Firmware Using Afu
DOS prompt, replacing <CONTROLLER_NUMBER> with the number of the controller whose firmware you are flashing. afu update /C <CONTROLLER_NUMBER> To upgrade controller 0, for example, you would type the following: afu update /C 0 Using the Adaptec Flash Utility 12-7...
Page 316: Afu Commands
Adaptec SCSI RAID Software Reference Guide Flashing the Firmware on Multiple Controllers To flash the firmware on multiple controllers, type the following at the DOS prompt, replacing the comma- separated list of CONTROLLER_NUMBER_n with the numbers of the controllers whose firmware you are...
Page 317: Help
Options None Default Switch Values None Example A:\> AFU LIST Adaptec Flash Utility V4.0-0 B5749 (c)Adaptec Inc. 1999–2002. All Rights Reserved. Controllers Detected and Recognized: Using the Adaptec Flash Utility 12-9...
Page 318: Reset
Adaptec SCSI RAID Software Reference Guide Controller #0 (03:05:00) RESET The RESET command resets a controller to its initial start-up state and waits for the controller’s on-board kernel to restart. If the controller’s flash components were updated, the new firmware is executed.
Page 319: Update
(c)Adaptec Inc. 1999–2002. All Rights Reserved. Updating Controller 0 (Adaptec 2200S) Reading flash image file (Build 5749) AFU is about to update firmware on controller(s) Adaptec 2200S ***PLEASE DO NOT REBOOT THE SYSTEM DURING THE UPDATE*** Using the Adaptec Flash Utility...
Page 320: Verify
Adaptec SCSI RAID Software Reference Guide This might take a few minutes. Writing Adaptec 2200S (4MB) Flash Image to controller 0...OK. Verifying...OK Please restart the computer to allow firmware changes to take effect. VERIFY The VERIFY command compares the contents of each of the flash components on a controller to the corresponding image in a UFI file and indicates whether they match.
Page 321: Afu Error Handling
Examples A:\> AFU VERSION /C 0 Adaptec Flash Utility V4.0-0 B5749 (c)Adaptec Inc. 1999–2002. All Rights Reserved. Version Information for Controller #0 (Adaptec 2200S) ROM: Build 5748 [VALID] A:\> AFU VERSION /C ALL Displays version information about all the supported...
Page 322 Adaptec SCSI RAID Software Reference Guide 12-14...
Page 323: Using The Array Configuration Utility
Using Script Mode Introducing the Array Configuration Utility for MS-DOS Adaptec RAID Configuration (ARC) is a embedded BIOS utility that includes utilities for changing SCSI device and controller settings (SCSISelect), for low-level formatting or verifying disk media (Disk Utilities), and for performing other functions. The ARC also contains a utility for creating, configuring, and managing arrays called Array Configuration Utility (ACU).
Page 324: Interactive Versus Script Mode
Adaptec SCSI RAID Software Reference Guide Configuration Utility (ACU) for MS-DOS. The embedded BIOS-based ACU and the MS-DOS-based ACU are similar utilities. This chapter describes the functionality of ACU for MS-DOS only. For information about running the ACU for MS-DOS, see Running the ACU on page 13-2.
Page 325: Using Interactive Mode
The remainder of this chapter explains in detail how to use the ACU in both interactive and script modes. Using Interactive Mode When you issue the ACU command at the MS-DOS prompt without any command-line switches, the ACU displays its main window and waits for your menu selection.
Page 326 Adaptec SCSI RAID Software Reference Guide Assigning Array Properties To assign properties to the new array: From the Array Properties menu, select an array type and press Enter. Note that only those array types available according to the number of drives selected are displayed. For a description of the supported array types, see the installation guide shipped with your controller.
Page 327: Managing Arrays
Specify the write caching setting for the array. The possible values are: ■ Enable when protected—If supported, enables the write cache only when a battery is present and the battery’s charge status is OK. ■ Enable always—If supported, enables the write cache even if no battery is present or the battery’s charge status is not OK.
Page 328 Adaptec SCSI RAID Software Reference Guide Assigning Hot Spare Drives To assign a spare drive to an array: Select Manage Arrays from the Main menu. On the List of Arrays dialog box, select the array you want to assign a spare drive to, and type Ctrl/s. The Hotspare Management for Array dialog box is displayed, which shows the drives that can be assigned as spare drives.
Page 329 Initializing a Disk Drive You must initialize a drive before you can use it as part of an array. You can tell a drive is not available (and must be initialized) if it is not listed in the disk selection list or if it is listed but grayed out. Caution: Initializing a disk deletes all data on the disk.
Page 330: Using Script Mode
Adaptec SCSI RAID Software Reference Guide ■ You cannot make a non-00 array bootable if the array is in a build/verify or reconfiguration process. ■ The controller always uses the lowest numbered array as its bootable array. If you delete array 00 for any reason, the next higher numbered array becomes the boot array.
Page 331 ■ /R —Record mode. This mode saves a controller’s array and channel configuration in a specified script file for later playback. On the ACU command line, you can also specify the name of a log file to record the status of the playback or record operation. The ACU records in the log any errors or warnings encountered.
Page 332 Adaptec SCSI RAID Software Reference Guide Table 13-2 Command-Line Switches (Continued) Switch Description /L <file> Optional log file name. If you include this switch, the ACU records its activity and any errors it encounters in the log file. If no /L switch is specified, the ACU displays any status and errors on the screen.
Page 333: Playback Mode
Playback Mode Playback mode enables you to create one or more arrays based on the properties defined in a script file. It also enables you to configure certain properties for each channel on the controller. When you create an array, you can specify any of the properties listed in Table 13-3.
Page 334 Adaptec SCSI RAID Software Reference Guide In addition, there are other array properties that enable you to control the various array settings during creation. See Array Definition Block Properties on page 13-16 for the complete list of array properties. Note:...
Page 335: Record Mode
Because the ACU reads the entire script file before creating any arrays, the position of the InitializeAll=Yes property within the script is not significant. Continuing the previous example, if InitializeAll=Yes is specified in the second RAID 5’s definition, the ACU initializes all drives before creating the first RAID 0.
Page 336 Adaptec SCSI RAID Software Reference Guide you need to be able to check the status of a background build/verify or clear task and determine when it is complete. The ACU provides a way to do this. When you use record mode to record a controller’s configuration and you specify a log file (/L...
Page 337: Script File Syntax
arrays. Consequently, the parent task indicates 0% to 100% and the child tasks always indicates 0%. Build/Verify Operations on RAID 10 Arrays For a RAID 10 array, the status message indicates the percent of the build/verify completed for the parent and child tasks. The status updates to OK when the tasks complete.
Page 338 Adaptec SCSI RAID Software Reference Guide The pound character (#) indicates the start of a comment. The ACU ignores all characters on a line that begins with a pound sign. You can use comments following array property assignments or on their own lines.
Page 339 Table 13-4 Array Definition Block Properties Keyword Required? InitializeAll Method ReadCache Size StripeSize Wait Using the Array Configuration Utility Default Value Description Indicates whether to initialize all the drives connected to the controller. page 13-20 more information. Build/ Indicates which Verify method (build/ verify, clear or quick...
Page 340 Adaptec SCSI RAID Software Reference Guide Table 13-4 Array Definition Block Properties Keyword Required? WaitForBuild WriteCache The following sections describe each of these keywords in detail. The Array Keyword Array is a required keyword, indicating the start of an array definition block.
Page 341 The Type Keyword Type is a required keyword, indicating the type of array to create. There is no default value. Consult possible values for the keyword Type and the minimum number of drives required for each type. Table 13-5 Type Keyword Values Type Keyword Values Volume RAID0...
Page 342 Adaptec SCSI RAID Software Reference Guide ■ When assigning spare drives to a RAID 10 or a RAID 50, the ACU assigns all the drives in the list to all the arrays within the RAID 10 (or RAID 50). ■...
Page 343 Examples: InitializeAll=Yes InitializeAll=No The Method Keyword Method is an optional keyword, indicating which method to use when creating a RAID 5 array. If Method is not specified, the value Build is used. Possible values are: Build—Build/verify the array. ■ Clear—Clear the array. ■...
Page 344 Adaptec SCSI RAID Software Reference Guide The Size Keyword The Size keyword specifies the size of the array. Specify the size as an integer or a decimal number, followed by the unit keyword MB (megabytes), GB (gigabytes), or TB (terabytes). A unit keyword is required with a numeric size value.
Page 345 Examples: Wait=Yes Wait=No The WaitForBuild Keyword The WaitForBuild keyword is provided for backward compatibility only. Use the Wait keyword instead. The WaitForBuild keyword is still recognized and can be used interchangeably with the Wait keyword. The WriteCache Keyword The WriteCache keyword indicates whether write caching is used for this array if write caching is supported for the system.
Page 346: Error Handling
Adaptec SCSI RAID Software Reference Guide Channel Definition Block Properties Table 13-6 lists properties that you can specify within a channel definition block. The table lists each property’s keyword and a description of the property. Channel properties, unlike array properties, have no default values.
Page 347 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.
Page 348: Playback And Record Notes
Adaptec SCSI RAID Software Reference Guide Table 13-7 Error Codes (Continued) Code Error/Information Number of drives do not match the array type. Unable to initialize drive. Error occurred while creating array. Too many spare drives assigned. Insufficient memory to run the application.
Page 349: Example: Invoking The Acu And Using A Script
In this case, the ACU creates the HotspareDrives list using all the drives assigned to the lower-level mirror set arrays within the RAID 10 (or RAID 50). When playing back this script, the ACU assigns all the drives in the HotspareDrives list to all the mirror set arrays making up the RAID 10 (or RAID 50).
Page 350 Adaptec SCSI RAID Software Reference Guide # Use drives on channels 0 and 1 Drives=0:1:0,1:1:0 # Disable write cache WriteCache=No # Assign 2 spare drives HotspareDrives=1:2:0, 1:3:0 # Create a maximum size RAID 5 labeled ‘MyData’ Array=MyData Type=RAID5 Size=Maximum # Use the maximum stripe size StripeSize=64 # Clear the array (don’t build/verify it)
Page 351: Creating An Automated Script
Automated Scripts In this Appendix Creating an Automated Script This appendix describes how to write DOS batch files and CLI command scripts to perform the controller details task. You can use the CLI commands alone in CLI command scripts or in combination with DOS commands in DOS batch files.
Page 352 Adaptec SCSI RAID Software Reference Guide Closes controller aac0 by invoking the CLI command close. Exits the example CLI command script. open AAC0 controller details close AAC0 exit...
Page 354 Adaptec, Inc. 691 South Milpitas Boulevard Milpitas, CA 95035 USA ©2000 – 2002 Adaptec All rights reserved. Adaptec and the Adaptec logo are trademarks of Adaptec which may be registered in some jurisdictions. Part Number: 513399-06, Ver. AA SEF 10/02...

This manual is also suitable for:

2200s Workstation xw6000 Xw8200 - workstation - 1 gb ram

Adaptec RAID 2120S Software Reference Manual

1 Getting Started

2 Accessing the Command Line Interface

3 Syntax and Conventions for CLI Commands

4 General Control Commands

5 Container Commands

6 Controller Commands

Quick Links

Need help?

Questions and answers

Related Manuals for Adaptec RAID 2120S

Summary of Contents for Adaptec RAID 2120S