Reference Guide
Page 2
...property of their respective owners. Windows 2000 and Windows XP are trademarks of Adaptec, Inc., which may be registered in this document to assure its users. ii Trademarks Adaptec and the Adaptec logo are trademarks of Microsoft Corporation in the preparation of Adaptec, Inc., 691 South Milpitas... otherwise, without the prior written consent of this document, or from errors or omissions in some jurisdictions. Adaptec reserves the right to its accuracy, Adaptec, Inc. Disclaimer IF THIS PRODUCT DIRECTS YOU TO COPY MATERIALS, YOU MUST HAVE PERMISSION FROM THE COPYRIGHT ...
...property of their respective owners. Windows 2000 and Windows XP are trademarks of Adaptec, Inc., which may be registered in this document to assure its users. ii Trademarks Adaptec and the Adaptec logo are trademarks of Microsoft Corporation in the preparation of Adaptec, Inc., 691 South Milpitas... otherwise, without the prior written consent of this document, or from errors or omissions in some jurisdictions. Adaptec reserves the right to its accuracy, Adaptec, Inc. Disclaimer IF THIS PRODUCT DIRECTS YOU TO COPY MATERIALS, YOU MUST HAVE PERMISSION FROM THE COPYRIGHT ...
Reference Guide
Page 3
Contents 1 Introduction Audience 1-1 Accessing the CLI 1-2 Accessing the CLI from the MS-DOS Prompt 1-2 Accessing the CLI in Windows 1-2 Accessing CLI in Linux and UNIX 1-2 Accessing CLI in NetWare 1-3 Terminology 1-3 Conventions 1-4 Command Syntax 1-5 Class 1-5 Action 1-6 Object 1-6 Switch 1-6 Value 1-6 Parameter 1-7 Blank Space 1-7 Parameter and Switch Value Types 1-7 Boolean 1-7 integer 1-8 string 1-9 scsi_device 1-10 free_space 1-11 container 1-12 Status Information 1-13 The Stat and Task Items 1-13 The Func Item 1-13 The Ctr and State Items 1-14 iii
Contents 1 Introduction Audience 1-1 Accessing the CLI 1-2 Accessing the CLI from the MS-DOS Prompt 1-2 Accessing the CLI in Windows 1-2 Accessing CLI in Linux and UNIX 1-2 Accessing CLI in NetWare 1-3 Terminology 1-3 Conventions 1-4 Command Syntax 1-5 Class 1-5 Action 1-6 Object 1-6 Switch 1-6 Value 1-6 Parameter 1-7 Blank Space 1-7 Parameter and Switch Value Types 1-7 Boolean 1-7 integer 1-8 string 1-9 scsi_device 1-10 free_space 1-11 container 1-12 Status Information 1-13 The Stat and Task Items 1-13 The Func Item 1-13 The Ctr and State Items 1-14 iii
Reference Guide
Page 9
...: The following example: C:\>cd Program Files\Adaptec_SCSI_RAID\AAC C:\Program Files\Adaptec_SCSI_RAID\AAC>afacli Accessing the CLI in Windows This section discusses the various methods for accessing the CLI in Windows. The Adaptec program group will display. 3 Move the mouse cursor to work in any directory. To access the CLI:... in various operating systems. Accessing the CLI from the MS-DOS Prompt To access the CLI from the UNIX/Linux prompt, display a window and type aaccli in any directory, the path in the startup file (.login or .cshrc) must include the directory where the software ...
...: The following example: C:\>cd Program Files\Adaptec_SCSI_RAID\AAC C:\Program Files\Adaptec_SCSI_RAID\AAC>afacli Accessing the CLI in Windows This section discusses the various methods for accessing the CLI in Windows. The Adaptec program group will display. 3 Move the mouse cursor to work in any directory. To access the CLI:... in various operating systems. Accessing the CLI from the MS-DOS Prompt To access the CLI from the UNIX/Linux prompt, display a window and type aaccli in any directory, the path in the startup file (.login or .cshrc) must include the directory where the software ...
Reference Guide
Page 20
... FSV FSX FTF MCR Table 1-7 Function Values Meaning File system verify task. Table 1-7 describes the values that the CLI displays in a different window. The following example shows the status information for the array create mirror command: Stat:OK!Task:101,Func:MCR Ctr:0,State:DNE 100.0% The ... unique ID number. Mirror set create or multilevel mirror set to FAT causes the FTF value to indicate the task is executing correctly. The controller assigns each item that the Func item can display. The array format command with the /file_system switch set create task. to display. On...
... FSV FSX FTF MCR Table 1-7 Function Values Meaning File system verify task. Table 1-7 describes the values that the CLI displays in a different window. The following example shows the status information for the array create mirror command: Stat:OK!Task:101,Func:MCR Ctr:0,State:DNE 100.0% The ... unique ID number. Mirror set create or multilevel mirror set to FAT causes the FTF value to indicate the task is executing correctly. The controller assigns each item that the Func item can display. The array format command with the /file_system switch set create task. to display. On...
Reference Guide
Page 29
This switch is supported on Windows only. Note: You can open controllers for read-write access in any user can open and access the previously opened controller only in which the specified computer that contains the controller resides. Thereafter, any GUI or CLI session only once per controller. If you do not specify this switch, the CLI assumes the local domain. General Control Commands /domain{=string} Specifies the domain (the local domain or a trusted domain) in read-only mode. 2-7
This switch is supported on Windows only. Note: You can open controllers for read-write access in any user can open and access the previously opened controller only in which the specified computer that contains the controller resides. Thereafter, any GUI or CLI session only once per controller. If you do not specify this switch, the CLI assumes the local domain. General Control Commands /domain{=string} Specifies the domain (the local domain or a trusted domain) in read-only mode. 2-7
Reference Guide
Page 30
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 2-8
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 2-8
Reference Guide
Page 37
...on SCSI device (0,3,0): AAC0>container create mirror /wait /io_delay=10 0 (0,3,0) Executing: container create mirror /wait=TRUE /io_delay=10 0 (CHANNEL=0, ID=3,LUN=0) As the command executes, note the title bar of the DOS window displays the status of the operating system. If you set this controller prior ... creation starts asynchronously and the command prompt returns immediately. /io_delay{=integer} Specifies the number of milliseconds the controller waits between reboots of the command. If you set this switch, the I /Os required to obtain information about any existing arrays.
...on SCSI device (0,3,0): AAC0>container create mirror /wait /io_delay=10 0 (0,3,0) Executing: container create mirror /wait=TRUE /io_delay=10 0 (CHANNEL=0, ID=3,LUN=0) As the command executes, note the title bar of the DOS window displays the status of the operating system. If you set this controller prior ... creation starts asynchronously and the command prompt returns immediately. /io_delay{=integer} Specifies the number of milliseconds the controller waits between reboots of the command. If you set this switch, the I /Os required to obtain information about any existing arrays.
Reference Guide
Page 41
...shows, array 0 is a volume set that was previously created with the container promote command. As the following characteristics: I The freespace from SCSI devices (0,4,0), and (0,5,0) are used to mirror the underlying volume sets. AAC0>container create mmirror 0 (0,4,0) (0,5,0) Executing: container create mmirror 0... (CHANNEL=0,ID=4,LUN=0) (CHANNEL=0,ID=5,LUN=0) As the command executes, note the title bar of the DOS window displays the status of the command. Use the container list command after using the container create mmirror command to display information about...
...shows, array 0 is a volume set that was previously created with the container promote command. As the following characteristics: I The freespace from SCSI devices (0,4,0), and (0,5,0) are used to mirror the underlying volume sets. AAC0>container create mmirror 0 (0,4,0) (0,5,0) Executing: container create mmirror 0... (CHANNEL=0,ID=4,LUN=0) (CHANNEL=0,ID=5,LUN=0) As the command executes, note the title bar of the DOS window displays the status of the command. Use the container list command after using the container create mmirror command to display information about...
Reference Guide
Page 53
...native operating system's file system (for Windows, the NTFS or FAT file system) resides on the array. If you accept the default, the command: I Disables the read -ahead cache to optimize performance, unless your application-which means the command causes the controller to : I Enable the read-ahead...the specified array. container Commands Switches /cache{=boolean} Specifies whether to enable the RAID 5 array's raw array cache when you create it, you can use this switch to TRUE, the command causes the controller to disable the array's raw array cache. In fact, the container set cache ...
...native operating system's file system (for Windows, the NTFS or FAT file system) resides on the array. If you accept the default, the command: I Disables the read -ahead cache to optimize performance, unless your application-which means the command causes the controller to : I Enable the read-ahead...the specified array. container Commands Switches /cache{=boolean} Specifies whether to enable the RAID 5 array's raw array cache when you create it, you can use this switch to TRUE, the command causes the controller to disable the array's raw array cache. In fact, the container set cache ...
Reference Guide
Page 54
.... Note that this label is FALSE; container Commands /clear{=boolean} Specifies whether to set up the parity during RAID-5 creation by Windows Explorer comes from the label specified with the container format command. 3-23 If you use until the parity-initialize operation completes. ...The default is not the label that displays in Windows Explorer. Unlike the scrub method where the drive is immediately available, the clear method does not make the drive available for this switch...
.... Note that this label is FALSE; container Commands /clear{=boolean} Specifies whether to set up the parity during RAID-5 creation by Windows Explorer comes from the label specified with the container format command. 3-23 If you use until the parity-initialize operation completes. ...The default is not the label that displays in Windows Explorer. Unlike the scrub method where the drive is immediately available, the clear method does not make the drive available for this switch...
Reference Guide
Page 55
...clear=TRUE. Examples The following example creates a RAID 5 array with the following characteristics: I Creates the RAID 5 array on Windows and NetWare. If you set this switch to FALSE, the command will set up parity by scrubbing the RAID 5 array. This switch is not parity-protected ...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 3-24 For UNIX, the RAID 5 array is always scrubbed. /wait{=boolean} Specifies whether the command prompt returns only after the scrub operation completes I Specifies a stripe size of...
...clear=TRUE. Examples The following example creates a RAID 5 array with the following characteristics: I Creates the RAID 5 array on Windows and NetWare. If you set this switch to FALSE, the command will set up parity by scrubbing the RAID 5 array. This switch is not parity-protected ...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 3-24 For UNIX, the RAID 5 array is always scrubbed. /wait{=boolean} Specifies whether the command prompt returns only after the scrub operation completes I Specifies a stripe size of...
Reference Guide
Page 56
... command to indicate that contain information as available. AAC0>container list Executing: container list Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size 0 RAID-5 30.0MB 64KB None 0:02:0 64.0KB: 10.0MB 0:03:0 64.0KB: 10.0MB 0:04:0...special file associated with the newly created RAID 5 array. container Commands As the command executes, note that this column. Because no label was specified when the RAID 5 array was specified, which means that the title bar of the MS-DOS window displays the status of the freespace available....
... command to indicate that contain information as available. AAC0>container list Executing: container list Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size 0 RAID-5 30.0MB 64KB None 0:02:0 64.0KB: 10.0MB 0:03:0 64.0KB: 10.0MB 0:04:0...special file associated with the newly created RAID 5 array. container Commands As the command executes, note that this column. Because no label was specified when the RAID 5 array was specified, which means that the title bar of the MS-DOS window displays the status of the freespace available....
Reference Guide
Page 59
... always enable the read -ahead cache I Enable when protected the NVRAM write-back cache setting for Windows, the NTFS or FAT file system) resides on the array. This means the controller enables the array's NVRAM write-back cache only if a battery is present and its status is doing...you accept the default, the command: I Disables the read -ahead cache to optimize performance, unless your application-which means the command causes the controller to disable the array's raw array cache. container Commands Switches /cache{=boolean} Specifies whether to enable the array's raw array cache.You can...
... always enable the read -ahead cache I Enable when protected the NVRAM write-back cache setting for Windows, the NTFS or FAT file system) resides on the array. This means the controller enables the array's NVRAM write-back cache only if a battery is present and its status is doing...you accept the default, the command: I Disables the read -ahead cache to optimize performance, unless your application-which means the command causes the controller to disable the array's raw array cache. container Commands Switches /cache{=boolean} Specifies whether to enable the array's raw array cache.You can...
Reference Guide
Page 60
... show space Executing: disk show space command to obtain information about the available SCSI devices, as in Windows Explorer. container Commands /label{=string} Specifies a label to be enough contiguous freespace on the (0,3,0) and (0,4,0) SCSI disks AAC0>container create stripe ((0,2,0), 15M) (0,3,0) (0,4,0) Executing: container create stripe...special file associated with the container format command. If you do not specify a label, you do so later by Windows Explorer comes from the label specified with the newly created array. 3-29 Note that this label is not the label ...
... show space Executing: disk show space command to obtain information about the available SCSI devices, as in Windows Explorer. container Commands /label{=string} Specifies a label to be enough contiguous freespace on the (0,3,0) and (0,4,0) SCSI disks AAC0>container create stripe ((0,2,0), 15M) (0,3,0) (0,4,0) Executing: container create stripe...special file associated with the container format command. If you do not specify a label, you do so later by Windows Explorer comes from the label specified with the newly created array. 3-29 Note that this label is not the label ...
Reference Guide
Page 64
...cache command gives you can do not want to enable the volume set . I Enable when protected the NVRAM write-back cache setting for Windows, the NTFS or FAT file system) resides on the array. This switch defaults to create the volume set 's raw array cache when you... create it, you more control in setting the NVRAM write-back cache. container Commands {scsi_device},{free_space}... Specifies any additional SCSI devices (the SCSI channel number, device ID, and device logical unit number). You can have a maximum of 16...
...cache command gives you can do not want to enable the volume set . I Enable when protected the NVRAM write-back cache setting for Windows, the NTFS or FAT file system) resides on the array. This switch defaults to create the volume set 's raw array cache when you... create it, you more control in setting the NVRAM write-back cache. container Commands {scsi_device},{free_space}... Specifies any additional SCSI devices (the SCSI channel number, device ID, and device logical unit number). You can have a maximum of 16...
Reference Guide
Page 65
... set , use the disk show space command to obtain information about the available SCSI devices, as in Windows Explorer. You can do not specify the switch, it defaults to create the volume set on SCSI disk (0,2,0) with the container format command. 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...
... set , use the disk show space command to obtain information about the available SCSI devices, as in Windows Explorer. You can do not specify the switch, it defaults to create the volume set on SCSI disk (0,2,0) with the container format command. 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...
Reference Guide
Page 71
...the container extend file_system command. Command and Switch Availability This command is successful. Notes The following appears: The file system structure on Windows. container Commands container extend file_system To extend a file system so that it with label "". Syntax container extend file_system {container} 3-40...run the chkdsk utility after extending an array (by adding a level to extend the NTFS file system. If you check the Windows Event Log, a message similar to the following notes relate to using the container extend file_system command to take effect. This command ...
...the container extend file_system command. Command and Switch Availability This command is successful. Notes The following appears: The file system structure on Windows. container Commands container extend file_system To extend a file system so that it with label "". Syntax container extend file_system {container} 3-40...run the chkdsk utility after extending an array (by adding a level to extend the NTFS file system. If you check the Windows Event Log, a message similar to the following notes relate to using the container extend file_system command to take effect. This command ...
Reference Guide
Page 74
... set remains intact, and can be extended to it, use the container extend mvolume command. If a file system exists on this array is supported on Windows. container Commands container extend mvolume To extend a multilevel volume set by adding one or more arrays to include the added space. This prevents the loss...
... set remains intact, and can be extended to it, use the container extend mvolume command. If a file system exists on this array is supported on Windows. container Commands container extend mvolume To extend a multilevel volume set by adding one or more arrays to include the added space. This prevents the loss...
Reference Guide
Page 75
...Stat:OK!Task:102,Func:FSX Ctr:0,State:RUN 84.3% For further details on this controller. As the following example extends a multilevel volume set ) on status information, see page ... as in the following example: AAC0>container list Executing: container list Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size F: 0 Volume 40MB NTFS...2 container 0 extended As the command executes, note that the title bar of the DOS window displays the status of volume sets after using the container extend mvolume command to obtain information about the multilevel ...
...Stat:OK!Task:102,Func:FSX Ctr:0,State:RUN 84.3% For further details on this controller. As the following example extends a multilevel volume set ) on status information, see page ... as in the following example: AAC0>container list Executing: container list Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size F: 0 Volume 40MB NTFS...2 container 0 extended As the command executes, note that the title bar of the DOS window displays the status of volume sets after using the container extend mvolume command to obtain information about the multilevel ...
Reference Guide
Page 78
... on this controller: AAC0>container list Executing: container list Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size E: 1 Volume 100MB NTFS 2:02:0 200MB: 100MB 3-47 For further details, see free_space on Windows. Specifies a SCSI device or ...[{free_space}...] Parameters {container} Specifies the ID number (0 to 63) of the array (volume set) to extend. {free_space} Specifies the SCSI device and its associated freespace used to extend the specified array (volume set remains intact and can specify a maximum of 16 freespace elements....
... on this controller: AAC0>container list Executing: container list Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size E: 1 Volume 100MB NTFS 2:02:0 200MB: 100MB 3-47 For further details, see free_space on Windows. Specifies a SCSI device or ...[{free_space}...] Parameters {container} Specifies the ID number (0 to 63) of the array (volume set) to extend. {free_space} Specifies the SCSI device and its associated freespace used to extend the specified array (volume set remains intact and can specify a maximum of 16 freespace elements....