Page 1 Adaptec Serial ATA RAID 2810SA Command Line Interface Software Reference Guide...
Page 2 Copyright © 2000 - 2003 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 How to Use this Manual 1-2 Organization 1-3 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 Accessing the CLI from the NetWare Server Console 2-3 Accessing the CLI from the Linux/UNIX Prompt 2-3 Syntax and Conventions for CLI Commands...
Page 4 Adaptec SCSI RAID Software Reference Guide integer 3-5 string 3-6 scsi_device 3-7 free_space 3-8 container 3-9 CLI Status Information 3-10 The Stat and Task Items 3-10 The Func Item 3-11 The Ctr and State Items 3-12 General Control Commands close 4-2...
Page 5 Adaptec SCSI RAID Software Reference Guide 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 Syntax 5-9 Parameters 5-9...
Page 6 Adaptec SCSI RAID Software Reference Guide 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 Switches 5-36 Examples 5-37...
Page 7 Adaptec SCSI RAID Software Reference Guide 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 Syntax 5-65 Parameters 5-65 Examples 5-65 Related Information 5-66...
Page 8 Adaptec SCSI RAID Software Reference Guide 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 Command Availability 5-84...
Page 9 Adaptec SCSI RAID Software Reference Guide 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 Examples 5-98 Related Information 5-99...
Page 10 Adaptec SCSI RAID Software Reference Guide Parameters 5-109 Examples 5-109 Related Information 5-110 container show failover 5-112 Syntax 5-112 Parameters 5-112 Examples 5-112 Related Information 5-112 container split 5-113 Syntax 5-113 Parameters 5-114 Examples 5-114 Related Information 5-116 container unlock 5-117...
Page 11 Adaptec SCSI RAID Software Reference Guide Examples 6-7 Related Information: 6-8 controller firmware update 6-9 Syntax 6-9 Switches 6-9 Examples 6-9 Related Information: 6-9 controller list 6-10 Syntax 6-10 Parameters 6-10 Switches 6-10 Examples 6-10 Related Information 6-11 controller pause_io 6-12...
Page 12 Adaptec SCSI RAID Software Reference Guide Related Information 6-21 controller show automatic_failover 6-22 Syntax 6-22 Examples 6-22 Related Information 6-22 controller show channels 6-23 Syntax 6-23 Examples 6-23 Related Information 6-24 controller show array_verify 6-25 Syntax 6-25 Examples 6-25 Related Information 6-25...
Page 13 Adaptec SCSI RAID Software Reference Guide Syntax 7-10 Parameters 7-10 Examples 7-10 Related Information 7-11 disk set smart 7-12 Syntax 7-12 Parameters 7-12 Switches 7-13 Examples 7-14 Related Information 7-14 disk show partition 7-15 Syntax 7-15 Examples 7-15 disk show smart 7-18...
Page 14 Adaptec SCSI RAID Software Reference Guide logfile Commands logfile end 8-2 Syntax 8-2 Examples 8-2 Related Information 8-2 logfile start 8-3 Syntax 8-3 Parameter 8-3 Switches 8-3 Examples 8-3 Related Information 8-4 task Commands task list 9-2 Syntax 9-2 Parameters 9-2...
Page 15 Adaptec SCSI RAID Software Reference Guide Examples 9-12 Related Information 9-13 Automated Scripts Creating an Automated Script A-1...
Page 16: 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 17: Audience
NetWare, the guide assumes you are familiar with NetWare-related concepts and commands. 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 18: Organization
technology, the software has been adapted by mapping of ports 0 through 3 to the following SCSI IDs: Bus 0, ID 0, Lun 0 Bus 0, ID 1, Lun 0 Bus 0, ID 2, Lun 0 Bus 0, ID 3, Lun 0 In general, SCSI IDs will be populated from Bus 0, ID 0 upwards (always LUN 0).
Page 19: Conventions
“RAID array;” for example, a rack of disks is often referred to as a disk array. Other related documents include the following: Adaptec Serial ATA RAID Installation & User’s Guide The installation guide that ships with your RAID controller explains how to install it in your computer system. The installation guide also provides instructions on how to install the RAID software.
Page 20: 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 Linux/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 21: 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 22: Accessing The Cli From The Netware Server Console
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 23: 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 24: Cli Command Syntax
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. For example, to use subcommand mode for the array command: Type array at the CLI>...
Page 25: Class
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 26: Value
Syntax and Conventions for CLI Commands 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 27: Boolean
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 28: String
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 29: Scsi_Device
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 30: Free_Space
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 31: 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 32: Cli Status Information
Syntax and Conventions for CLI Commands 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 33: 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 34: The Ctr And State Items
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 35: General Control Commands
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 36 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 exit help, ? To invoke general or topical Help commands, use the help command or the ? (question mark).
Page 37: 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 38 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 39 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 40: 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 41 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 container show failover container split container unlock container unmirror The array commands are discussed in alphabetical order and use the...
Page 42: 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 43: Related Information
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 Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ ------------- Volume 45MB Stripe 45MB 32KB...
Page 44: 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 45: Switches
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 46 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 47: Related Information
Related Information container commands: container create mmirror (page container list (page container split container unmirror disk commands: disk remove dead_partitions container Commands (page 5-9) 5-54) 5-113) (page 5-119) (page 7-9)
Page 48: 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 49: Switches
{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. A SCSI ID consists of a SCSI bus number (e.g., 0, 1, 2, 3, etc.), SCSI device ID (0 through 15 inclusive), and SCSI device logical unit number (0 through 7 inclusive).
Page 50: 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 51: Related Information
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 creating a multilevel array of mirror sets with the container create mmirror command: The Dr column is blank to indicate that the newly created mirror sets (63 and 62) do not have a drive letter assigned to...
Page 52 container Commands disk commands: (page 7-9) disk remove dead_partitions 5-13...
Page 53: Container Create Mstripe
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: Stripe set of mirror sets Stripe set of volume sets Stripe set of stripe sets...
Page 54: 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 55: Examples
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 56 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 57: Related Information
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. The Scsi C:ID:L column displays the SCSI device ID for the disk on which you created the multilevel stripe set.
Page 58: 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 Volume set of volume sets Notes When creating a multilevel array of volume sets on a NetWare...
Page 59: Switches
{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. For example, if the first array is a stripe set then any subsequent arrays are also stripe sets.
Page 60 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 61 container Commands 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 62: 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-107) 5-23...
Page 63: Container Create Raid5
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). Notes If you created a RAID-5 set you can run the list devices command on the NetWare console to verify its creation and then...
Page 64: 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 65 If you specify TRUE for both the /scrub and /clear switches, the command displays an appropriate error message and returns to the prompt. /stripe_size{=integer} Specifies the stripe size for the RAID-5 set. Valid values are 16 KB, 32 KB, and 64 KB. If you do not specify a value for this switch, it defaults to 64 KB.
Page 66: Examples
For UNIX, the RAID-5 set is always scrubbed. /wait{=boolean} Specifies whether the command prompt returns only after the parity-protect operation completes. If you set this switch to TRUE, the command prompt returns only after the RAID-5 set is parity-protected. The scrub or zero action completes. The default is FALSE the command prompt returns immediately before the parity-protect operation completes.
Page 67 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. For example: Stat:OK!Task:101,Func:R5S Ctr:0,State:RUN 84.6% page 3-10 for detailed information on the status information that...
Page 68: 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. The Stripe Size column displays the stripe size you specified as the stripe_size parameter, which in the example is 64 The Usage column displays None to indicate that the newly...
Page 69: Container Create Stripe
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 70: Switches
Switches /cache{=boolean} When FALSE (the default), the command causes the controller to disable the array’s array cache. FALSE means: Disables the read-ahead cache. Disables the write-back cache. When TRUE, write cache is enabled, providing maximum performance. Notes When the write cache is enabled, there is a potential for data loss or corruption during a power failure.
Page 71: Examples
Examples Before creating a stripe set, use the disk show space command to obtain information about the available devices, as in the following example: AAC0>disk show space Executing: disk show space Scsi C:ID:L Usage Size ----------- --------- ------------- 0:00:0 Free 64.0KB: 11.0MB 0:01:0...
Page 72 Stripe 45.0MB 64KB The following list describes the items in the display that contain information as the result of creating a stripe set with the container create stripe command: The Num Label column displays the ID number of the newly created stripe set, which in the example is 0.
Page 73: Related Information
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. The Partition Offset: Size column displays the partition offset(s) and the size(s) for the disk(s) whose associated freespaces you used to create the stripe set.
Page 74: 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 75: Switches
{scsi_device},{free_space}... Specifies any additional 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 devices (the SCSI channel number, device ID, and device logical unit number).
Page 76: Examples
from the label specified with the container format command. Examples Before creating a volume set, use the disk show space command to obtain information about the available devices, as in the following example: AAC0>disk show space Executing: disk show space Scsi C:ID:L Usage Size ----------- --------- -------------...
Page 77: Related Information
The following list describes the columns that contain information as the result of creating a volume set with the container create volume command: The Num Label column displays the ID number of the newly created volume set, which in the example is 0. If you specify a label when creating the volume set, it appears in this column.
Page 78 container Commands disk commands: (page 7-22) disk show space 5-39...
Page 79: Container Delete
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 80: 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 81: Related Information
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 container create mstripe container create mvolume container create raid5 container create stripe container create volume...
Page 82: 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 83: Command And Switch Availability
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) Syntax container extend file_system {container} Parameters {container} Specifies the ID number (0 to 63) of the array whose file system you want to extend.
Page 84: 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 85: Container Extend Mvolume
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. Command And Switch Availability This command and its associated switches (if any) are supported on the following operating systems:...
Page 86: 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 87 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 -- ----- ------ ------ --- ------ ------- ------ ------------- Volume 40MB Volume 10MB Volume 15MB Volume 15MB The following list describes the change to the display as the result of...
Page 88: 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 89: Container Extend Volume
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. Command And Switch Availability This command and its associated switches (if any) are supported on the following operating systems: Windows NT...
Page 90: 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 91: If A Partition Is Dead, The ":" (Colon) In The Partition Offset:size Column Changes To A "!" (Exclamation Point). See The Disk Remove Dead_Partitions
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 Oth Stripe Dr Label Type Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ ------------- E: 1...
Page 92: 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-22) 5-53...
Page 93: Container List
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 94: 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 95 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. Use the container assign drive_letter command to assign a drive letter to an array.
Page 96 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 97 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 98 The Partition Offset:Size Column This column displays the offset and size for the underlying partitions. If a partition is dead, the “:” (colon) in the Partition Offset:Size column changes to a “!” (exclamation point). See the disk remove dead_partitions (page 7-9) on dead partitions.
Page 99 with the container readonly and container readwrite commands. Some CLI commands cause an array to temporarily become read- only without the use of the container readonly command. The Lk Column This column displays the letter L if the array is locked. Otherwise, if the array is not locked, the column displays a blank space.
Page 100 Table 5-4. Task Types (Continued) Task Meaning A rebuild task is running on the specified array. Rebuild Typically, the rebuild task runs when the controller is in a rebuild for a redundant array (RAID-5 set, mirror set, or multilevel array of mirror sets). An array reconfigure task is running on the specified Reconfg array.
Page 101 The Done % Column This column displays a running percentage value that indicates the progress of the currently running task. The display shows the percentage in tenths of a percent increments. The currently running task is complete when the Done % column displays 100%. The Ent Column This column displays the number of elements associated with each array.
Page 102 is a two-digit number that indicates the second at which you created the array. The Boot Device Column This column displays a value that indicates whether the array resides on the boot device. An X appears in the column if the array resides on the boot device.
Page 103: Related Information
Related Information container commands: container create mirror container create mstripe container create raid5 container create stripe (page container scrub disk commands: (page 7-25) disk verify (page 7-27) disk zero container Commands (page 5-5) (page 5-14) (page 5-24) (page 5-30) 5-94) 5-64...
Page 104: 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 105: Related Information
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 Total Oth Stripe Dr Label Type Size Ctr Size -- ----- ------ ------ --- ------ ------- --------...
Page 106: 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 107: Examples
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 Executing: container list Total Oth Stripe Dr Label Type Size Ctr Size...
Page 108: 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 109: Examples
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 Executing: container list Total Oth Stripe Dr Label Type...
Page 110: (Page 7-9) Command For More Information On Dead Partitions
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. The Scsi C:ID:L column displays the SCSI channel number, SCSI device ID, and SCSI logical unit number for the underlying arrays.
Page 111: Container Readonly
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. Syntax container readonly {container} Parameters...
Page 112: 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 113: Container Readwrite
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. Syntax container readwrite {container} Parameters...
Page 114: 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 115: Container Reconfigure
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. For example, you can transform a stripe set into a RAID-5 set.
Page 116: 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 117: Parameters
Parameters {container} Specifies the ID number (0 to 63) of the array you want to reconfigure. {scsi_device}... Specifies one or more devices. Typically, you specify one or more devices when adding more drives to an array or moving an array’s partitions. A SCSI ID consists of a SCSI channel number (for example, 0, 1, 2, 3, etc.), a SCSI device ID (0 through 15 inclusive), and a SCSI device logical unit number (0 through 7 inclusive).
Page 118 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 119 /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 120: 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 121: Container Extend File_System
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 Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ ------------- Mirror 15.0MB Tigris E: 1...
Page 122: 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 123: Container Remove Drive_Letter
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: Windows NT Windows 2000 (basic disk only)
Page 124: 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 125: Container Remove Failover
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}...] Parameters {container} Specifies the ID number (0 to 63) of the array whose assigned failover disk(s) you want to remove.
Page 126: Disk List
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 127: Container Remove File_System
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. Command Availability This command and its associated switches (if any) are supported on the following operating systems:...
Page 128: 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 129: Container Remove Global_Failover
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}...] Parameters {scsi_device} Specifies the ID for the SCSI device that you want to remove as a failover disk for all arrays.
Page 130: Related Information
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 Executing: container show failover container Scsi C:ID:L...
Page 131: Container Restore Raid5
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 132: Container List (Page 5-54) Disk Commands
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 133: Container Scrub
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 134: 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 135: Related Information
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 Size Ctr Size -- ----- ------ ------ --- ------ ------- ------ ------------- D: 0 Mirror 10.0MB As the example shows, there is no difference between the array list...
Page 136: 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 137: Parameters
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 138: Related Information
Executing: container set cache 0 After setting cache parameters for a specific array, use the container show cache command to display cache parameter information, as in the following example: AAC0>container show cache 0 Executing: container show cache 0 Global container Read Cache Size Global container Write Cache Size : 1970176 Read Cache Status : ENABLED...
Page 139: 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 140: Related Information
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 The following example assigns two SCSI failover disks to array 0.
Page 141: 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 142: Related Information
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 143: 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 Scrubbing a redundant array You use this command to change the I/O delay from the one you...
Page 144: Examples
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 Executing: container list Total Oth Stripe Dr Label Type...
Page 145: 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-106...
Page 146: Container Set Label
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: container create mstripe (a multilevel stripe set) container create mvolume (a multilevel volume set) container create raid5 (a RAID-5 set)
Page 147: Related Information
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" Use the container list command after using the container set label command to display the new label, as in the following example:...
Page 148: Container Show Cache
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. Syntax container show cache {container} Parameters {container}...
Page 149: Related Information
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 150 container Commands (page 5-54) container list (page 5-97) container set cache (page 5-109) container show cache 5-111...
Page 151: Container Show Failover
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}] Parameters {container} Specifies the ID number (0 to 63) of the array whose assigned failover disk(s) you want to display.
Page 152: 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 153: Parameters
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 154 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 155: Related Information
Related Information container commands: container create mirror container create mmirror (page container list container unmirror disk commands: disk remove dead_partitions container Commands (page 5-5) (page 5-9) 5-54) (page 5-119) (page 7-9) 5-116...
Page 156: 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 157: Related Information
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 Executing: container list /full=TRUE Total...
Page 158: 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 159: Related Information
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. The following list describes the changes to the display as a result of using the container unmirror command: The Type column displays Volume, which indicates that the...
Page 160 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-12 6-15...
Page 161: Controller Details
AAC0> controller details Executing: controller details Controller Information ---------------------- Remote Computer: . Device Name: AAC0 Controller type: Adaptec 2410SA Access Mode: READ-WRITE Controller serial number: Last six digits = 8A277A Number of Buses: 1 Devices per Bus: 15 i960 Controller CPU:...
Page 162 Commands 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. The command displays the value READ-WRITE if you opened the controller for read-write operations.
Page 163 The Battery State Item The Battery State: shows that this controller is not equipped with a battery. The Component Revisions Items Table 6-1 describes each of the Component Revisions: items. This information is useful if you ever need to contact a technical support representative.
Page 164: Related Information
Table 6-1. Component Revision Items (Continued) Component Revision Item Meaning Controller Firmware: Displays the revision level of the firmware. In the example, the revision level is (Build #5478). Controller Hardware: Displays the version of the controller hardware. In the example, the version is 3.3. Related Information General control commands: (page...
Page 165: 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 166: Controller Firmware Save
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. Syntax controller firmware save [/ C[{controller_ID}][{controller_ID}...] {/...
Page 167 Related Information: controller commands: controller firmware compare controller firmware update controller Commands (page 6-6) (page 6-9)
Page 168: Syntax
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. Syntax controller firmware update [/C[{controller_ID}][{controller_ID}...]...
Page 169: Syntax
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-10...
Page 170: 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 171 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 172: Syntax
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. Using this command when there is a pagefile on an array could cause unexpected behavior.
Page 173: Related Information
Related Information controller commands: controller resume_io task commands: (page task list 9-2) controller Commands (page 6-17) 6-14...
Page 174: Syntax
controller Commands 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. This command rescans the disks for the arrays and loads the volatile array and the partition tables from disks again.
Page 175: Syntax
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 176: Syntax
controller Commands 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. Syntax controller resume_io Examples The following example resumes all I/O activity on the currently...
Page 177: 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 178: Examples
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 179: Syntax
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 180: Related Information
controller Commands 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. AAC0> controller show array_verify Executing: controller show array_verify Array verify ENABLED Errors found 0...
Page 181: Controller Show Automatic_Failover
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 182: Controller Show Channels
controller Commands 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. Syntax controller show channels Examples...
Page 183: Related Information
controller Commands 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 184: Controller Show Array_Verify
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 185: Disk Blink
disk Commands In this Chapter disk blink disk initialize disk list disk remove dead_partitions disk set default disk set smart 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 186: Disk Blink
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.), device ID (0 through 15 inclusive), and device logical unit number (0 through 7 inclusive).
Page 187: Disk Initialize
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 188 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. Examples The following example initializes a SCSI disk device (SCSI channel number 0, device ID 2, and device logical unit number 0) that has data on it: AAC0>disk initialize /always (0,2,0)
Page 189: 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 device for which you want to display information.
Page 190 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: Removable media Vendor-ID Product-ID...
Page 191 Value Meaning 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 192 The Usage Column The Usage column displays the usage of the device. The disk list command can display one of the values listed in Table 7-2. Table 7-2. SCSI Disk Device Usage Values Value Meaning Detached The system detected that the diskset in the detached state.
Page 193 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 194 disk Commands Related Information array commands: (page 5-54) array list 7-10...
Page 195: 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 device’s channel number and device logical unit number. Then, in subsequent commands, you need only specify the device ID on the command line.
Page 196 disk Commands Related Information disk commands: (page 7-5) disk list 7-12...
Page 197: 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 198 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. The default is FALSE; the disk set smart command does not enable S.M.A.R.T.
Page 199 /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 200: 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 201 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 202 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-18...
Page 203: Disk Show Smart
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 204 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 205 disk Commands 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 device ID, and the device logical unit number for the four disks on the open controller.
Page 206 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 207: Disk Show Space
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 device for which you want to display space usage information. A SCSI ID consists of a SCSI channel number (for example, 0, 1, 2, 3, etc.), a device ID (0 through 15 inclusive), and a device logical unit number (0 through 7 inclusive).
Page 208 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 209 The Size Column The Size column displays the offset (in bytes) into the 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: For the 0:02:0 disk The offset is 64.0 KB for the partition and 20.0 MB for the unused space.
Page 210: 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 211 disk Commands 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. For example: Stat:OK!Task:100,Func:SCV,State:RUN 97.2% page 3-9 for detailed information on the status information that...
Page 212: 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: Windows NT Windows 2000 (basic disk only)
Page 213 /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. The default is FALSE; the command clears the disk asynchronously and the command prompt returns immediately.
Page 214: Logfile End
logfile Commands In this Chapter logfile end logfile start Use the following syntax for logfile commands: logfile command [/switch{=value}] [parameter]...
Page 215: Logfile Start
logfile Commands 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> logfile end Executing: logfile end Log file closed.
Page 216: Parameter
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 217: Related Information
logfile Commands 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. The following example (Windows NT/Windows 2000 (basic disk only)/Windows XP (basic disk only)) logs subsequent output to an existing file: AAC0>...
Page 218 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] 9-10 9-12...
Page 219: Task List
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. Clearing a disk, creating a file system, and creating a mirror set are examples of tasks done on the controller.
Page 220 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 221 Table 9-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 array format file_system switch set to Rebuild A rebuild task is running on the specified array.
Page 222 Table 9-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 223: The Specific2 Column
Table 9-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. The task was suspended. Typically, you suspend a task with task suspend The controller reported an unknown status for the task.
Page 224: Related Information
Table 9-4. Additional Specific2 Information Task Verify . Refers to the verify with repair of bad blocks task, which runs as a result of using the disk verify command with the switch. repair Related Information array commands: array create mirror 5-94) array scrub (page...
Page 225: Task Resume
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. Perform a task list /all to display the task IDs for all tasks currently suspended on the open controller before resuming a specific task or all tasks.
Page 226: 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 227: Task Stop
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 228: Related Information
task Commands AAC0>task list Executing: task list No tasks currently running on controller. Related Information task commands: (page 9-2) task list 9-11...
Page 229: Task Suspend
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 list /all to display the task IDs for all tasks currently running on the open controller before suspending a specific task or all tasks.
Page 230: 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 231: Creating An Automated Script
Automated Scripts 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. Also, you can invoke CLI command scripts in a DOS batch file.
Page 232 Automated Scripts...
Page 233 Adaptec, Inc. 691 South Milpitas Boulevard Milpitas, CA 95035 USA ©2000 – 2003 Adaptec All rights reserved. Adaptec and the Adaptec logo are trademarks of Adaptec which may be registered in some jurisdictions. Part Number: 5138123-06, Ver. AA 11/03...

Adaptec RAID 2810SA Software Reference Manual

Table of Contents

6 Controller Commands

1 Getting Started

2 Accessing the Command Line Interface

3 Syntax and Conventions for CLI Commands

4 General Control Commands

Container Commands

Related Information

Quick Links

Chapters

Related Manuals for Adaptec RAID 2810SA

Summary of Contents for Adaptec RAID 2810SA