Adaptec AAR-2020SA, Reference Manual

Page 1: ...R Command Line Interface Reference Guide...

Page 2: ...under license All other trademarks are the property of their respective owners Changes The material in this document is for information only and is subject to change without notice While reasonable e...

Page 3: ...essing 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 Boo...

Page 4: ...container create volume 3 32 container delete 3 37 container extend file_system 3 40 container extend mvolume 3 43 container extend volume 3 47 container list 3 50 container lock 3 59 container move 3...

Page 5: ...roller firmware update 4 9 controller list 4 10 controller pause_io 4 12 controller rescan 4 14 controller reset_scsi_channel 4 15 controller resume_io 4 16 controller set automatic_failover 4 17 cont...

Page 6: ...count 6 9 diagnostic moderation show timer 6 10 diagnostic set boot_parameter 6 11 diagnostic show boot_parameter 6 12 diagnostic show history 6 13 7 logfile Commands logfile end 7 2 logfile start 7...

Page 7: ...losure set scsiid 9 21 enclosure set temperature 9 24 enclosure show fan 9 26 enclosure show power 9 29 enclosure show slot 9 32 enclosure show status 9 36 enclosure show temperature 9 41 A Automated...

Page 8: ...h CLI you can also use the CLI commands in DOS command scripts and UNIX shell scripts Audience This Reference Guide is for system administrators and experienced users who are familiar with drive confi...

Page 9: ...pted the default location for the software during installation To access the CLI 1 Click the Start button and move the mouse cursor to Programs Click on Programs 2 Move the mouse cursor to SMBE The Ad...

Page 10: ...used L represents LUN which is always zero Note Only the value for Port ID is used Adaptec 21610SA Controllers Only In the device ID format C ID L C represents Channel ID represents Port ID For mappi...

Page 11: ...t for strings Command abbreviations You can abbreviate commands subcommands and switches You must provide enough characters so the commands are not ambiguous Subcommand Mode Subcommand mode simplifies...

Page 12: ...in scripts where you want to comment out sections of code Command Syntax You can enter only valid CLI commands at the command line prompt All commands use the following syntax class action object swi...

Page 13: ...Switches that are Boolean do not require a value when the switch is used because the switch defaults to TRUE or FALSE Optionally you can explicitly set a Boolean switch to TRUE or FALSE Value A value...

Page 14: ...es or tabs Parameter and Switch Value Types A parameter or switch value can be only one of several types Simple value types include string Boolean and integer Other value types include objects that ca...

Page 15: ...an equation that Begin and end with no suffix are decimal Begin with 0x or end with h are hexadecimal End with o indicate octal End with z indicate binary You can attach special multipliers to the end...

Page 16: ...me type of quotes Also within a quoted string 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 1 3 lists exampl...

Page 17: ...eger is the SCSI device ID and the third integer is the SCSI device LUN The actual values that the CLI supports are as follows SCSI channel number for example 0 1 2 3 and so on See the installation gu...

Page 18: ...meter scsi_device freespace_size scsi_device scsi_device If you do not specify the freespace_size parameter it defaults to the size of the first freespace area available on the specified SCSI device N...

Page 19: ...dden array is an array that is not visible to the operating system and can only be used by other arrays However the array list command displays hidden arrays The Parameters section uses the following...

Page 20: ...plays the value OK to indicate the task is executing correctly This is the value that appears in the example The Task item displays the ID number associated with a specific task The controller assigns...

Page 21: ...format task with an NTFS file system specified The array format command with the file_system switch set to NTFS causes the NTF value to display R5R RAID 5 rebuild task R5S RAID 5 array create task wi...

Page 22: ...Meaning BAD The task failed and is no longer running DNE The task successfully completed or the task is no longer running that is the task is done RUN The task is running SUS The task was suspended Ty...

Page 23: ...s Chapter The CLI general control commands are discussed in alphabetical order and use the following syntax command subcommand switch value parameter close 2 2 exit 2 3 help 2 4 history_size 2 5 open...

Page 24: ...2 2 General Control Commands close To close the currently opened controller when all access is completed use the close command Syntax close...

Page 25: ...2 3 General Control Commands exit To close the currently opened controller and exit the CLI use the exit command Syntax exit...

Page 26: ...mmand help full command help full command subset Parameters If the command has more subcommands help lists the subcommands and their functions If a complete command is used such as array list the CLI...

Page 27: ...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 o...

Page 28: ...format nodename AACn where n is the controller number For local controllers you can omit the nodename in the string specification If the computer name has a dash in the name for example proj athena en...

Page 29: ...contains the controller resides If you do not specify this switch the CLI assumes the local domain This switch is supported on Windows only Note You can open controllers for read write access in any G...

Page 30: ...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...

Page 31: ...nctionality 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 functionality is...

Page 32: ...tainer create raid5 3 21 container create stripe 3 27 container create volume 3 32 container delete 3 37 container extend file_system 3 40 container extend mvolume 3 43 container extend volume 3 47 co...

Page 33: ...f opening the controller is not shown container remove drive_letter 3 78 container remove failover 3 80 container remove file_system 3 82 container remove global_failover 3 84 container restore RAID5...

Page 34: ...array to convert to a multilevel volume set The specified array must not be a multilevel array Examples Before creating a multilevel volume set use the container list command to obtain information abo...

Page 35: ...t ID 0 is the newly created volume set The second ID 63 is the original array the stripe set If you specified a label when creating the multilevel volume set it appears in this column Because no label...

Page 36: ...see the appropriate NetWare documentation Syntax container create mirror wait boolean io_delay integer container scsi_device Parameters container Specifies the ID number 0 to 63 of the array on which...

Page 37: ...er list command to obtain information about any existing arrays As the following example shows there is one existing array array 0 a volume set on this controller prior to the time the mirror set is c...

Page 38: ...e mirror state 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 IDs for the two halves of the mirror se...

Page 39: ...ng any of these arrays an appropriate message displays This message indicates that one or more of the arrays you specified is in use by NetWare The message directs you to remove any NetWare volumes an...

Page 40: ...ified device The number of SCSI devices you specify must be equal to the number of single partition volume sets that make up the multilevel array of volume sets The size of the freespace used is equal...

Page 41: ...romote command The freespace from SCSI devices 0 4 0 and 0 5 0 are used to mirror the underlying volume sets The default I O delay is taken The multilevel array of mirror sets is created asynchronousl...

Page 42: ...ist command The Scsi C ID L column displays the SCSI device ID for the disk s on which the underlying mirror set s reside In the example mirror set 63 resides on disk 0 02 0 and 0 04 0 Mirror set 62 r...

Page 43: ...are is using any of these arrays an appropriate message displays This message indicates that one or more of the arrays you specified is in use by NetWare The message directs you to remove any NetWare...

Page 44: ...the newly created multilevel stripe set You can specify a maximum of sixteen characters for the label If you do not specify the switch it defaults to no label If you do not specify a label you can do...

Page 45: ...r 15MB 0 03 0 64 0KB 15 0MB 0 03 0 15 0MB 15 0MB 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...

Page 46: ...n an array use the container format command 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...

Page 47: ...3 16 container Commands Related Commands container commands container create mirror page 3 5 container list page 3 50 container set label page 3 101...

Page 48: ...ropriate message displays This message indicates that one or more of the arrays you specified is in use by NetWare The message directs you to remove any NetWare volumes and partitions from these array...

Page 49: ...eating a multilevel volume set use the container list command to obtain information about any existing arrays As the following example shows there are two existing arrays stripe sets on this controlle...

Page 50: ...that make up the multilevel volume set If you specify a label when creating the multilevel volume set it appears in this column Because no label was specified when the multilevel volume set was create...

Page 51: ...s on which the array s that make up the multilevel volume set reside In the example the display shows that array 63 s partitions reside on three SCSI disks 0 02 0 0 03 0 and 0 04 0 array 62 s partiti...

Page 52: ...olean wait boolean free_space scsi_device Parameters free_space Specifies the SCSI device and its associated freespace used to create the RAID 5 array For further details see free_space on page 1 11 s...

Page 53: ...u set this switch to TRUE the command causes the controller to Enable the read ahead cache setting for the specified array You should always enable the read ahead cache to optimize performance unless...

Page 54: ...es 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 ar...

Page 55: ...r the parity protect operation completes If you set this switch to TRUE the command prompt returns only after the RAID 5 array is parity protected The scrub or zero action completes The default is FAL...

Page 56: ...KB 10 0MB 0 04 0 64 0KB 10 0MB The following list describes the columns that contain information as a result of creating a RAID 5 array with the container create raid5 command The Num Label column dis...

Page 57: ...ner list command is executed after the RAID 5 array completes execution the State column is blank Note that this column appears only if you specify the full switch with the container list command The...

Page 58: ...cifies the SCSI device and its associated freespace used to create the stripe set For further details see free_space on page 1 11 scsi_device Specifies one or more SCSI devices A SCSI ID consists of a...

Page 59: ...che setting for the specified array You should always enable the read ahead cache to optimize performance unless your application which is unlikely is doing completely random reads Enable when protect...

Page 60: ...e 64 0KB 11 0MB 0 01 0 Free 64 0KB 11 0MB 0 02 0 Free 64 0KB 49 0MB 0 03 0 Free 64 0KB 49 0MB 0 04 0 Free 64 0KB 49 0MB 0 05 0 Free 64 0KB 49 0MB 0 06 0 Free 64 0KB 11 0MB 0 08 0 Free 64 0KB 11 0MB Th...

Page 61: ...label appears in the column On UNIX systems the root special file associated with the array also appears in this column The Type column displays the type Stripe to indicate that the newly created arr...

Page 62: ...ces you used to create the array In this example the display shows 64 0KB 15MB 64 0KB 15 0MB and 64 0KB 15 0MB Related Commands container commands container create mstripe page 3 12 container create m...

Page 63: ...pace Parameters scsi_device Specifies the ID for the SCSI device whose freespace you want to use for creating the volume set A SCSI ID consists of a SCSI bus number e g 0 1 2 3 etc SCSI device ID 0 th...

Page 64: ...en you create it you can do so later by using the container set cache command In fact the container set cache command gives you more control in setting the NVRAM write back cache If you set this switc...

Page 65: ...lable SCSI 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 Free 64 0KB 11 0MB 0 02 0 Free 64 0KB 49 0MB 0 03...

Page 66: ...in the column On UNIX systems the root special file associated with the array also appears in this column The Type column displays Volume to indicate that the newly created array is a volume set The T...

Page 67: ...3 36 container Commands container list page 3 50 container promote page 3 63 container set cache page 3 91 container set label page 3 101 disk commands disk show space page 5 26...

Page 68: ...m the system s internal device table Syntax container delete always boolean unconditional boolean container Parameters container Specifies the ID number 0 to 63 of the array to delete The array can be...

Page 69: ...AC0 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 40 0MB NTFS 63 Volume 10 0MB 0 02 0 64 0KB 10 0MB 62 Vol...

Page 70: ...ontainer create mirror page 3 5 container create mmirror page 3 8 container create mstripe page 3 12 container create mvolume page 3 17 container create raid5 page 3 21 container create stripe page 3...

Page 71: ...mand to extend an NTFS file system If you extend an NTFS file system the command displays an appropriate message indicating that you need to reboot the system to show the new space If you check the Wi...

Page 72: ...KB 100MB 61 Volume 100MB 1 02 0 64 0KB 100MB The following list describes the sequence that caused the previous example to display 1 Create a volume set of 100 MB on disk 1 0 0 with the container crea...

Page 73: ...e file system on the next reboot Reboot the system to get the file system to expand to show the new space Use the container list command after using the container extend file_system command to display...

Page 74: ...o_extend Specifies the ID number 0 to 63 of the array to extend Typically this array is a multilevel volume set Specifies the ID number 0 to 63 of the array to add to the previously specified multilev...

Page 75: ...ends a multilevel volume set array 0 by adding arrays 1 and 2 which are both volume sets AAC0 container extend mvolume 0 1 2 Executing container extend mvolume 0 1 2 container 0 extended As the comman...

Page 76: ...icate that the arrays previously created with the container create volume and the container add_level commands are volume sets In addition the column displays Volume for the volume sets created as a r...

Page 77: ...nds container commands container add_level page 3 3 container create mvolume page 3 17 container create volume page 3 32 container extend file_system page 3 40 container list page 3 50 disk commands d...

Page 78: ...xtend the specified array volume set For further details see free_space on page 1 11 free_space Specifies a SCSI device or devices and associated freespace or freespaces used to extend the specified a...

Page 79: ...e command to display information about the volume set after you extend it as in the following example AAC0 container list Executing container list Num Total Oth Stripe Scsi Partition Dr Label Type Siz...

Page 80: ...d sizes are 64 0 KB and 32 0 MB 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 5 10 command for more infor...

Page 81: ...rray whose information you want to display To display information about all of the arrays on the system omit the ID number from the command Switches all boolean Specifies whether to list all arrays on...

Page 82: ...Task Done Ent Creation Date Creation Time Boot Device System Files The following sections provide brief descriptions of each container list column The Dr Column In Windows this column displays a blan...

Page 83: ...documentation for information on how to mount the array or to create a file system The Type Column This column displays the type of array Table 3 1 describes the type values that can display in the T...

Page 84: ...age Items Item Meaning FAT The FAT file system resides on this array MultPart A file system resides on a multi partition array A multi partition array is an array that has multiple operating system or...

Page 85: ...e 3 3 Table 3 3 Container State Items Container State Meaning Copy Indicates that the array is the copy array in an array reconfiguration operation Create Indicates the creation of a mirror set Dest I...

Page 86: ...olumn This column displays the task or tasks running on a specified array or SCSI disk Specifically the column can display the items listed in Table 3 4 Table 3 4 Task Types Task Meaning Create A crea...

Page 87: ...ult of the container scrub command The scrub task also runs as a result of the container create raid5 command with the scrub switch specified Verify A verify with no repair of bad blocks task is runni...

Page 88: ...number that indicates the month in which you created the array For example 01 indicates the month of January 12 indicates the month of December and so forth dd is a two digit number that indicates th...

Page 89: ...X systems The System Files Column This column displays a value that indicates whether the array resides on the system device An X appears in the column if the array resides on the system device Otherw...

Page 90: ...0 to 63 of the array to lock into volatile memory space Examples Before locking an array use the container list command with the full switch to obtain information about any existing arrays As the fol...

Page 91: ...Scsi Dr Label Type Size Ctr Size Usage C ID L Lk F 0 Volume 10 0MB NTFS 0 02 0 L Note that the example eliminates some items in the container list display so that you can see an example of the Lk col...

Page 92: ...only be used by other arrays The container list command however displays hidden arrays The container move command does not prevent you from assigning a hidden container ID 24 through 63 to a visible...

Page 93: ...move 0 5 Use the container list command after using the container move command to display information about the array you just renumbered as in the following example AAC0 container list Executing cont...

Page 94: ...sets Notes The container promote command differs from the container add_level command as follows The container create volume command creates a single level array If you use the container add_level co...

Page 95: ...Offset Size 0 Stripe 45 0MB 32KB None 63 Volume 15 0MB 0 02 0 64 0KB 15 0MB 62 Volume 15 0MB 0 03 0 64 0KB 15 0MB 61 Volume 15 0MB 0 04 0 64 0KB 15 0MB The following list describes the change to the...

Page 96: ...he example arrays 63 62 and 61 have 64 0 KB offsets and 15 0 MB sizes If a partition is dead the colon in the Partition Offset Size column changes to a exclamation point See the disk remove dead_parti...

Page 97: ...only use the container list command with the full switch to obtain information about any existing arrays As the following example shows there is an array 0 a volume set on this controller Note that th...

Page 98: ...si Dr Label Type Size Ctr Size Usage C ID L RO F 0 Volume 10 0MB NTFS 0 02 0 RO Note that the example eliminates some items in the container list display so that you can see an example of the RO colum...

Page 99: ...ler Note that the RO column displays the value RO AAC0 container list full Executing container list full TRUE Num Total Oth Stripe Scsi Dr Label Type Size Ctr Size Usage C ID L RO F 0 Volume 10 0MB NT...

Page 100: ...example of the RO column As a result of making an array in this example array 0 read write with the container readwrite command the RO column displays blank instead of an RO to indicate that the spec...

Page 101: ...om the SCSI device s you specify to reconfigure the array For example you can extend a RAID array by specifying one or more devices In this case the array grows but remains a RAID 1 Change an array s...

Page 102: ...u perform an array reconfigure operation on a UNIX operating system you may see a resource conflict related error Typically this error occurs when there is not enough space on the disk to perform the...

Page 103: ...hrough 15 inclusive and a SCSI device logical unit number 0 through 7 inclusive For further details see scsi_device on page 1 10 The command uses the freespace s from the SCSI device s you specify to...

Page 104: ...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 This switch is supported on Windows mirror boolea...

Page 105: ...configures the existing array into a stripe set If you specify FALSE the command does not reconfigure the existing array into a stripe set This switch defaults to FALSE volume boolean Specifies whethe...

Page 106: ...e command For example Stat OK Task 100 Func RCF Ctr 1 State RUN 97 2 For further details on status information see page 1 13 Use the container list command after using the container reconfigure comman...

Page 107: ...3 76 container Commands container extend file_system page 3 40 container list page 3 50...

Page 108: ...reviously locked buffers On the other hand you may want to return these cache buffers to the global buffer pool This command allows you to disassociate the cache buffers associated with specific array...

Page 109: ...ple shows there is an array 0 a volume set on this controller with a drive letter F AAC0 container list Executing container list Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C...

Page 110: ...ay 0 with the container remove drive_letter command The Dr column no longer displays the drive letter assigned in a previous use of the container assign drive_letter command In this example the letter...

Page 111: ...er set failover command For further details see scsi_device on page 1 10 scsi_device Specifies the ID s for any other SCSI device s you want to remove as failover disk s for the array specified in the...

Page 112: ...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 0 0 04 0 As the display shows...

Page 113: ...er remove file_system container Parameters container Specifies the ID number 0 to 63 of the array from which you want to remove the file system Examples Before removing a file system from an array use...

Page 114: ...information about the container 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 V...

Page 115: ...y other SCSI device s you want to remove as failover disk s for all arrays You previously assigned these SCSI device s as failover disk s with the container set global_failover command Examples Before...

Page 116: ...owing example AAC0 container show failover Executing container show failover container Scsi C ID L GLOBAL 1 03 0 0 No Devices Assigned As the display shows SCSI device 1 2 0 is no longer in the failov...

Page 117: ...D5 container Parameters container Specifies the ID number 0 to 63 of the array a RAID 5 array to restore Examples Before restoring a RAID 5 array use the container list command to display information...

Page 118: ...e Size Ctr Size Usage C ID L Offset Size 0 RAID 5 30 0MB 64 0KB None 0 02 0 64 0KB 10 0MB 0 03 0 64 0KB 10 0MB 0 04 0 64 0KB 10 0MB 0 05 0 64 0KB 10 0MB Note that in this case the command successfully...

Page 119: ...ir boolean wait boolean container Parameters container Specifies the ID number 0 to 63 of the redundant array to scrub Switches io_delay integer Specifies the number of milliseconds the controller wai...

Page 120: ...sage C ID L Offset Size D 0 Mirror 10 0MB NTFS 0 02 0 64 0KB 10 0MB 0 02 0 10 0MB 10 0MB The following example synchronously scrubs array 0 using a delay time of 5 milliseconds AAC0 container scrub io...

Page 121: ...3 90 container Commands Related Commands container commands container create mirror page 3 5 container create mmirror page 3 8 container create raid5 page 3 21 container list page 3 50...

Page 122: ...The controller provides two global cache buffer pools available to arrays a volatile read ahead cache and a nonvolatile NVRAM write back cache Collectively these global caches are referred to as the...

Page 123: ...t this switch to FALSE Note that if you disable the read ahead cache no other characteristics can be set unprotected boolean Specifies whether to set the array s NVRAM write back cache to disable enab...

Page 124: ...0 Volume 15 0MB None 0 02 0 64 0KB 15 0MB Table 3 5 Switch Values and Results write_cache_enable Switch Setting unprotected Switch Setting Result FALSE FALSE The NVRAM write back cache setting for the...

Page 125: ...he 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 5345280...

Page 126: ...r 0 to 63 of the array on which to assign an automatic failover disk s scsi_device Specifies the ID for the SCSI device that you want to assign as a failover disk to the array specified in the contain...

Page 127: ...ufficient freespace If you assign more than one SCSI disk as failover devices you need ensure that only one of these disks has sufficient space The reason for this is that the failover operation will...

Page 128: ...nd assigns this disk to all arrays 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 inclusi...

Page 129: ...3 LUN 0 Use the container show failover command with or without the global switch after using the container set failover command to display information about the array s just assigned failover disk s...

Page 130: ...iner integer Parameters container Specifies the ID number 0 to 63 of the array on which to set the I O delay integer Specifies the number of milliseconds the controller waits between the I O operation...

Page 131: ...AC0 container set io_delay 0 40 Executing container set io_delay 0 40 Use the container list command after using the container set io_delay command to display information about the array as in the fol...

Page 132: ...tainer create stripe a stripe set container create volume a volume set The label you specify with the container set label command and the label switch associated with the previously listed container c...

Page 133: ...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 labe...

Page 134: ...about any existing arrays As the following example shows there is an array 0 a volume set on this controller with no file system on it as evidenced by None displayed in the Usage column Assume the ca...

Page 135: ...es the read cache is disabled for this array Write Cache Setting This item indicates whether the write cache is set for the array Table 3 6 displays the possible values for this setting Table 3 6 Valu...

Page 136: ...status is OK Active not protected battery low The status of the write cache for this array is as follows Active The write cache can accept write oper ations from the array Not protected The write cac...

Page 137: ...if a battery is present and its status is OK This status also indicates that the controller s battery is present and its status is OK Inactive battery low The status of the write cache for this array...

Page 138: ...not accept write operations from the array Cache disabled The user disabled the write cache by using the container set cache command and setting the appropri ate switches Inactive write not supported...

Page 139: ...y whose assigned failover disk s you want to display If you do not specify this parameter the command displays all arrays and their assigned failover disk s Examples The following example shows the fa...

Page 140: ...d to as the master array mirror set In addition the split array has an identical copy of the data from the old disk at the time of the split operation In Windows the split array s file system may be i...

Page 141: ...d split array Use the container list command after using the container split command to display information about the split mirror set as in the following example AAC0 container list Executing contain...

Page 142: ...02 0 The Partition Offset Size column displays the partition offsets and sizes for the partition associated with the split mirror set now two volume sets If a partition is dead the colon in the Parti...

Page 143: ...ll switch to obtain information about any existing arrays As the following example shows there is an array 0 a volume set on this controller Note that the Lk column displays an L which indicates that...

Page 144: ...si Dr Label Type Size Ctr Size Usage C ID L Lk F 0 Volume 10 0MB NTFS 0 02 0 Note that the example eliminates some items in the container list display so that you can see an example of the Lk column A...

Page 145: ...set use the container list command to obtain information about any existing arrays As the following example shows there is one existing array array 0 a mirror set on this controller at the time the mi...

Page 146: ...te is displayed only for mirror sets The Scsi C ID L column displays only one SCSI ID The Partition Offset Size column displays only one partition offset and size If a partition is dead the colon in t...

Page 147: ...oller firmware update 4 9 controller list 4 10 controller pause_io 4 12 controller rescan 4 14 controller reset_scsi_channel 4 15 controller resume_io 4 16 controller set automatic_failover 4 17 contr...

Page 148: ...ial number Last six digits 8A277A Number of Channels 4 Devices per Channel 15 Controller CPU Strong Arm 110 Controller CPU speed 233 Mhz Controller Memory 144 Mbytes Battery State Ok Component Revisio...

Page 149: ...he last six characters displayed on the SN sticker located on the controller itself The Number of Channels and Devices per Channel Items The Number of Channels item displays the number of channels act...

Page 150: ...4 2 Table 4 2 Battery States The Component Revisions Items Table 4 3 describes each of the Component Revisions items This information is useful if you ever need to contact a technical support represe...

Page 151: ...ays the version number of the miniport portion of the AAC SYS device driver This item displays only if the controller runs the AAC SYS device driver In the example the revision level is 2 1 0 Build 28...

Page 152: ...fy this switch this command compares the flash components on controller 0 D UFI_file_path Specifies the path where the pair of UFI files are located If you do not specify this switch this command comp...

Page 153: ...specify this switch this command saves the flash components on controller 0 D UFI_file_path Specifies the path where the pair of UFI files are located Use this switch to specify the drive and directo...

Page 154: ...4 8 controller Commands Related Commands controller commands controller firmware compare page 4 6 controller firmware update page 4 9...

Page 155: ...on which to perform the firmware update If you do not specify this switch the firmware update is performed on controller 0 D UFI_file_path Specifies the path where the pair of UFI files are located I...

Page 156: ...puter Switches domain string Specifies the domain in which the specified computer resides If you do not specify this switch the command assumes the local domain This switch is supported on Windows Exa...

Page 157: ...that can display in this item Table 4 4 Controller Availability Status Related Commands controller commands controller details page 4 2 Controller Availability Meaning Unavailable The controller is no...

Page 158: ...ts are likely to have different timeout values Thus pausing all I O activity on the open controller can cause network timeouts particularly if the specified delay is for more than one minute If you fi...

Page 159: ...troller pause_io integer Parameters integer Specifies the amount of time in seconds to cause the controller to wait before automatically resuming I O The parameter defaults to the maximum value of 150...

Page 160: ...the channel This command rescans the disks for the arrays and loads the volatile array and the partition tables from disks again If nothing on the disks has changed controller rescan should have no v...

Page 161: ...ger 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 c...

Page 162: ...e 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 activit...

Page 163: ...ou remove the failed disk and insert the replacement disk in the failed disk s slot Notes To assign one or more failover disks for a single array you use the array set failover command To assign one o...

Page 164: ...and The following example shows that the controller s automatic failover is currently disabled AAC0 controller show automatic_failover Executing controller show automatic_failover Automatic failover D...

Page 165: ...rns on the array verify feature on the specified controller Examples Before turning the array verify feature on or off check its status by using the controller show array_verify command The following...

Page 166: ...4 20 controller Commands Related Commands controller commands controller show array_verify page 4 25...

Page 167: ...controller show automatic_failover Examples The following example shows that the controller s automatic failover is currently disabled AAC0 controller show automatic_failover Executing controller show...

Page 168: ...oInfo 3 7 15 NoInfo NoInfo The following example displays the channels on the currently opened controller AAC0 controller show channels Executing controller show channels Ch Host ID Targets Type Max U...

Page 169: ...roller supports SCSI channel type Fast This channel type is not currently supported FastWide The controller supports SCSI channel type FastWide This channel type is not currently supported FibreChnl T...

Page 170: ...4 24 controller Commands Related Commands controller commands controller details page 4 2...

Page 171: ...feature on or off check its status by using the controller show array_verify command The following example shows that the controller s automatic failover is currently enabled The command also displays...

Page 172: ...ect switch value parameter disk blink 5 2 disk initialize 5 3 disk list 5 5 disk remove dead_partitions 5 10 disk set default 5 11 disk set smart 5 13 disk show default 5 16 disk show defects 5 17 dis...

Page 173: ...you want the SCSI disk to blink A value of zero 0 stops the SCSI disk from blinking Switches wait boolean Specifies whether to perform verification synchronously or asynchronously If you set this swit...

Page 174: ...SCSI device ID 0 through 15 inclusive and SCSI device logical unit number 0 through 7 inclusive For further details see scsi_device on page 1 10 Switches always boolean Specifies whether to initializ...

Page 175: ...hat 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 Examp...

Page 176: ...and SCSI device logical unit number 0 through 7 inclusive For further details see scsi_device on page 1 10 Switches all boolean Specifies whether to display a list of all SCSI devices If you set this...

Page 177: ...ay contains the previous columns of information plus the following columns Removable media Vendor ID Product ID Rev The following sections provide more information on the columns of information that t...

Page 178: ...with the SCSI device Value Meaning Disk The device type is a SCSI direct access device Typically these are disk drives This value appears in the example Sequential The device type is a SCSI sequentia...

Page 179: ...ys the value YES if the device resides on a shared channel and the value NO if the device does not reside on a shared channel In the example the devices do not reside on a shared channel Value Meaning...

Page 180: ...The Rate Column The Rate column displays the negotiated speed of the SCSI device in megabytes per second Related Commands disk commands disk initialize page 5 3 disk show partition page 5 19 disk sho...

Page 181: ...colon in the Partition Offset Size column displayed with the array list command changes to a exclamation point Syntax disk remove dead_partitions scsi_device Parameters scsi_device Specifies the ID fo...

Page 182: ...evice logical unit number 0 through 7 inclusive For further details see scsi_device on page 1 10 If you do not specify a SCSI device ID the command displays an appropriate error message Examples The f...

Page 183: ...5 12 disk Commands Related Commands disk commands disk list page 5 5 disk show default page 5 16...

Page 184: ...or disable S M A R T configuration for all disks on the system Clear the S M A R T error count for the specified disk Enable or disable S M A R T exception reporting Syntax disk set smart all boolean...

Page 185: ...The default is FALSE that is the disk set smart command does not clear S M A R T error counts for disks on the system enable_exceptions boolean Specifies whether to enable S M A R T exceptions reporti...

Page 186: ...zero indicates that there is no limit to the number of times an exception can be reported update boolean Specifies whether to update the number of device errors found on the specified SCSI device If...

Page 187: ...x disk show default Examples The following example shows the default for a SCSI device ID that was set in a previous use of the disk set default command AAC0 disk show default Executing disk show defa...

Page 188: ...details see scsi_device on page 1 10 Switches full boolean Specifies whether to display the defect count and the list of disk defects If you set this switch to TRUE the command displays the list of d...

Page 189: ...fect 1 occurred In the example the defect occurred on head 5 of cylinder 12 located in sector 59 Defect 2 at cylinder 550 head 1 sector 44 This item shows where defect 2 occurred In the example the de...

Page 190: ...The SCSI C ID L Columns The C ID L column displays the SCSI channel number the SCSI device ID and the SCSI device logical unit number for each disk on the currently opened controller In the example th...

Page 191: ...multilevel array in which the partition resides Table 5 4 lists the possible values that the command can display in the Type column Table 5 4 Multilevel Array Values Value Meaning None This partition...

Page 192: ...R W column displays whether the partition is read only or read write Specifically the column can display the values listed in Table 5 5 Table 5 5 R W Array Values Value Meaning RO The partition is rea...

Page 193: ...boolean view_changeable boolean scsi_device Parameters scsi_device Specifies the ID for the SCSI disk for which you want to display S M A R T configuration information A SCSI ID consists of a SCSI cha...

Page 194: ...formation that can be set For example an X appears in the Enable Exception Control column for those S M A R T disks on which this value can be set This switch defaults to FALSE Examples The following...

Page 195: ...value one of a possible six values However you cannot set the MRIE Your devices report exceptions only when polled level 6 and you cannot change the setting for this switch The Enable Exception Contr...

Page 196: ...iew_changeable switch the command displays an X in this column for those disks on which you can set the number of seconds for the exception reporting interval The Report Count Column The Report Count...

Page 197: ...1 10 Switches all boolean Specifies whether to show space usage information for all SCSI disks on the currently opened controller If you set this switch to TRUE the command shows space usage informat...

Page 198: ...ice ID and the SCSI device logical unit number for the six disks on the open controller In the second example the command displays information for the specified SCSI device 0 02 0 The Usage Column The...

Page 199: ...sks 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 The size is 20 0 MB for the partition and 29 0 MB for the unused space For the 0 03 0 di...

Page 200: ...scsi_device on page 1 10 Switches repair boolean Specifies whether to automatically repair bad blocks If you set this switch to TRUE the command attempts to repair any bad blocks If you do not specif...

Page 201: ...sk 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 exa...

Page 202: ...annel number for example 0 1 2 3 etc SCSI device ID 0 through 15 inclusive and SCSI device logical unit number 0 through 7 inclusive For further details see scsi_device on page 1 10 Switches always bo...

Page 203: ...ously and the command prompt returns immediately Examples The following example clears SCSI disk 0 2 0 There is data on the disk However the data is not deemed important and thus the always switch is...

Page 204: ...syntax for diagnostic commands diagnostic command switch value parameter diagnostic clear boot_parameters 6 2 diagnostic dump structures 6 3 diagnostic dump text 6 4 diagnostic load_arrays 6 6 diagno...

Page 205: ...meters are set Caution Use this command only under the direction of technical support Syntax diagnostic clear boot_parameters Examples The following example clears all boot time parameters AAC0 diagno...

Page 206: ...ng Specifies the name of the file to contain the internal data structures Use the filename conventions that apply to your operating system Examples The following example saves the internal data struct...

Page 207: ...ther operating systems you might want to make sure your windowing system is set up to scroll data See your operating system documentation You might also want to use the logfile start command to make s...

Page 208: ...6 5 diagnostic Commands Related Commands diagnostic commands diagnostic dump structures page 6 3...

Page 209: ...n in that it does not rescan the SCSI channel Caution Use this command only under the direction of technical support Syntax diagnostic load_arrays Examples The following example allows arrays to be lo...

Page 210: ...n the controller The interrupt count is the number of outstanding requests on the controller needed before the delay time the time specified by the diagnostic set timer command takes effect For exampl...

Page 211: ...o set as the default interrupt timer on the controller The interrupt timer is the delay time in 100 microsecond units before the controller issues an interrupt to the host computer For example if the...

Page 212: ...and You may have previously specified the default interrupt count the number of outstanding I Os with the diagnostic moderation set count command Caution Use this command only under the direction of t...

Page 213: ...ow timer command You may have previously specified the default interrupt timer the time in 100 microsecond units with the diagnostic moderation set timer command Caution Use this command only under th...

Page 214: ...s string Specifies the name of the boot time parameter to be set If you need to use this command a technical support representative will tell you the name of the boot time parameter to use integer Spe...

Page 215: ...ly under the direction of technical support Syntax diagnostic show boot_parameter Parameters string Specifies the boot time parameter character string whose associated value you want to display If you...

Page 216: ...this switch to TRUE the command displays the history log from the previous boot of the operating system If you do not specify any switches the command displays the history log from the previous boot...

Page 217: ...7 1 7 logfile Commands In this Chapter Use the following syntax for logfile commands logfile command switch value parameter logfile end 7 2 logfile start 7 3...

Page 218: ...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 Executin...

Page 219: ...ne activity to an existing output file if one exists If you set this switch to TRUE the command appends the CLI command line activity to the file specified in string This switch defaults to FALSE that...

Page 220: ...7 4 logfile Commands Related Commands logfile commands logfile end page 7 2...

Page 221: ...8 1 8 task Commands In this Chapter Use the following syntax for task commands task command switch value parameter task list 8 2 task resume 8 8 task stop 8 10 task suspend 8 12...

Page 222: ...ies the task ID for the task whose information you want to display You need to perform a task list all to display all tasks and their associated IDs Switches all boolean Specifies whether to display a...

Page 223: ...es the types of tasks that the task list command can display Table 8 1 Task Types Task Type Meaning Create A create mirror set or create multilevel mirror set task is running on the specified array Wh...

Page 224: ...xample from a volume set to a stripe set The array reconfigure task runs as a result of using the array reconfigure command Scrub A scrub task is running on the specified redundant array When the scru...

Page 225: ...fied without repairing any detected defects The verify with no repair of bad blocks task runs as a result of using the disk verify command without specifying the repair switch Or a verify with repair...

Page 226: ...BAD The task failed and is no longer running DNE The task successfully completed or the task is no longer running that is the task is done RUN The task is running SUS The task was suspended Typically...

Page 227: ...ist can display Table 8 4 Additional Specific2 Information Related Commands array commands array create mirror page 3 5 array scrub page 3 88 disk commands disk verify page 5 29 disk zero page 5 31 ta...

Page 228: ...sume all suspended tasks If you set this switch to TRUE the command resumes all tasks that were suspended on the currently opened controller If you do not specify this switch or a valid task ID the co...

Page 229: ...AC0 task list Executing task list TaskId Function Done Array State Specific1 Specific2 101 Scrub 24 6 0 RUN 00000000 00000000 As a result of using the task resume command the State column now displays...

Page 230: ...running tasks If you set this switch to TRUE the command stops all tasks that were running on the currently opened controller If you do not specify this switch or a valid task ID the command displays...

Page 231: ...t command after using the task stop command to display information about the task as in the following example AAC0 task list Executing task list No tasks currently running on controller Related Comman...

Page 232: ...ll running tasks If you set this switch to TRUE the command suspends all tasks that were running on the currently opened controller If you do not specify this switch or a valid task ID the command dis...

Page 233: ...AAC0 task list Executing task list TaskId Function Done Array State Specific1 Specific2 101 Scrub 24 6 0 SUS 00000000 00000000 As a result of using the task suspend command the State column now displ...

Page 234: ...ure command switch value parameter enclosure activate slot 9 2 enclosure identify slot 9 4 enclosure list 9 6 enclosure prepare slot 9 11 enclosure set alarm 9 13 enclosure set door 9 14 enclosure set...

Page 235: ...e device you want to activate This unit number can range from 0 to 15 inclusive Typically the slot unit number is limited by the physical number of device slots in the enclosure management device Exam...

Page 236: ...device is activated and working properly AAC0 enclosure show slot 0 Executing enclosure show slot 0 Enclosure Slot scsiId Insert Status 0 0 0 00 0 4 OK UNCONFIG ACTIVATE 0 1 0 01 0 0 OK UNCONFIG ACTIV...

Page 237: ...with the slot This is the slot that you want the enclosure management device to identify This unit number can range from 0 to 15 inclusive Typically the slot unit number is limited by the physical nu...

Page 238: ...9 5 enclosure Commands Related Commands enclosure commands enclosure activate slot page 9 2 enclosure list page 9 6 enclosure prepare slot page 9 11 enclosure show slot page 9 32...

Page 239: ...enclosure management devices on each bus Switches all boolean Specifies whether to display the components for all currently connected enclosure devices If you set this switch to TRUE the command displ...

Page 240: ...ostic 0 1 1 5 1 5 0 06 0 No SAF TE PASSED 1 1 1 5 1 5 1 06 0 No SAF TE PASSED The non detailed enclosure list display contains the following columns of information Enclosure Fan Power Slot Sensor Door...

Page 241: ...of sixteen power supplies In the example enclosure management devices 0 and 1 each have one power supply Note The hot swapping of enclosures is not supported If you perform a hot swap the Fan and Pow...

Page 242: ...ether there is a speaker installed on the enclosure management device Specifically the column can display the items listed in Table 9 1 Table 9 1 Speaker Status The Standard Column The Standard column...

Page 243: ...device s product ID In the example the product ID for enclosure management devices 0 and 1 is SCA HSBP M2 The Firmware Column The Firmware column displays the current firmware revision of the enclosu...

Page 244: ...supports a maximum of eight enclosure management devices on each bus slot Specifies the unit number associated with the slot This is the slot that contains the device you want to prepare to make avail...

Page 245: ...ert Status 0 0 0 00 0 4 OK UNCONFIG I R READY NOTACTIVATE 0 1 0 01 0 0 OK UNCONFIG ACTIVATE 0 2 0 10 0 0 OK UNCONFIG ACTIVATE 0 3 0 03 0 0 OK UNCONFIG ACTIVATE 0 4 0 04 0 0 OK UNCONFIG ACTIVATE 1 0 1...

Page 246: ...er supports a maximum of eight enclosure management devices on each bus Switches on boolean Specifies whether to turn the enclosure management device s audible alarm on or off If you set this switch t...

Page 247: ...of the door for which you want to set the lock This number can range from 0 to 15 inclusive Switches lock boolean Specifies whether to lock the door associated with the specified unit number If you s...

Page 248: ...he controller supports a maximum of eight enclosure management devices on each bus fan Specifies the unit number associated with the fan whose speed you want to set The unit number for the fan ranges...

Page 249: ...mber You must turn on the fan if you want to set its speed This switch defaults to FALSE which means the fan remains on and you can set its speed Examples The following example sets fan unit 0 on encl...

Page 250: ...ond Parameters second Specifies the number of seconds for the monitor reporting interval You can specify 1 to n seconds where n represents the number of seconds for the monitor reporting interval The...

Page 251: ...val 20 You may want to use the enclosure show status command again to see the change in the power supply s status as in the following example Enclosure UpTime D H M PowerCycle Interval Door Alarm 0 0...

Page 252: ...this version the controller supports a maximum of eight enclosure management devices on each bus powersupply Specifies the unit number associated with the power supply whose power you want to turn on...

Page 253: ...sure show power Enclosure Power State Status 0 0 ON OK 1 0 ON OK The following example turns on power supply 0 on enclosure management device 1 AAC0 enclosure set power 1 0 Executing enclosure set pow...

Page 254: ...ty on the currently opened controller You cannot set the SCSI device ID for a specific device slot to a SCSI device ID that is already in use The command checks for SCSI device ID conflicts and will d...

Page 255: ...ple sets device slot 2 on enclosure management device 0 to SCSI device ID 05 The example also shows how to pause all I O activity on the controller by using the controller pause_io command AAC0 contro...

Page 256: ...9 23 enclosure Commands Related Commands controller commands controller pause_io page 4 12 enclosure commands enclosure list page 9 6 enclosure show slot page 9 32...

Page 257: ...supports a maximum of eight enclosure management devices on each bus degree Specifies the temperature in degrees Fahrenheit at which you want to set the threshold for this enclosure management device...

Page 258: ...emperature as in the following example AAC0 enclosure show temperature 0 Executing enclosure show temperature 0 Enclosure Sensor Temperature Threshold Status 0 0 70 F 100 NORMAL The Threshold column n...

Page 259: ...ontroller supports a maximum of eight enclosure management devices on each bus If you do not specify a unit number the command displays the fan status for all enclosure management devices connected to...

Page 260: ...e unit number associated with the fan that you specified on the command line If you did not specify a unit number the enclosure show fan command displays the unit numbers for all fans on the enclosure...

Page 261: ...9 28 enclosure Commands Related Commands enclosure commands enclosure list page 9 6 enclosure set fan page 9 15 enclosure show status page 9 36...

Page 262: ...troller supports a maximum of eight enclosure management devices on each bus If you do not specify an ID the command displays the power supply status for all enclosure management devices connected to...

Page 263: ...ssociated with the power supply that you specified on the command line If you did not specify a unit number enclosure show power command displays the unit numbers for all power supplies on the enclosu...

Page 264: ...roperly OFF BAD The power supply is off and not working properly INSTALLED UNKNOWN The power supply is installed and its status is not reportable or unknown NOT INSTALLED Not Applicable The power supp...

Page 265: ...ce slot status information For this version the controller supports a maximum of eight enclosure management devices on each bus If you do not specify an ID the command displays the device slot status...

Page 266: ...an display in these columns The Enclosure and Slot Columns The Enclosure column displays the ID associated with the enclosure management device that you specified on the command line If you did not sp...

Page 267: ...umn can display the values listed in Table 9 6 Table 9 6 Status Column Status Meaning OK The device that resides in this slot is operational In the example the device that resides in device slot 0 on...

Page 268: ...LOVERSTOP The device that resides in this slot was in a rebuild operation but the rebuild operation terminated abnormally or unsuccessfully EMPTY No physical device resides in this slot I R READY The...

Page 269: ...s status information available from the following commands enclosure show fan enclosure show power enclosure show slot enclosure show temperature Syntax enclosure show status enclosure Parameters encl...

Page 270: ...NFIG ACTIVATE 0 1 0 01 0 0 OK UNCONFIG ACTIVATE 0 2 0 10 0 0 OK UNCONFIG ACTIVATE 0 3 0 03 0 0 OK UNCONFIG ACTIVATE 0 4 0 04 0 0 OK UNCONFIG ACTIVATE Enclosure Sensor Temperature Threshold Status 0 0...

Page 271: ...ice that you specified on the command line If you did not specify an ID the enclosure show status command displays the IDs for all enclosure management devices connected to the controller The UpTime D...

Page 272: ...e status of the audible alarm The enclosure show status command can display the audible alarm status values listed in Table 9 8 Table 9 8 Audible Alarm Status Values Related Commands enclosure command...

Page 273: ...9 40 enclosure Commands enclosure show power page 9 29 enclosure show slot page 9 32 enclosure show temperature page 9 41...

Page 274: ...supports a maximum of eight enclosure management devices on each bus If you do not specify an ID the command displays the temperature status information for all enclosure management devices connected...

Page 275: ...d displays the IDs for all enclosure management devices connected to the controller In the example 0 is specified The Sensor Column The Sensor column displays the unit number associated with the tempe...

Page 276: ...ure column The enclosure show temperature command can display the temperature status values listed in Table 9 9 Table 9 9 Temperature Status Values Related Commands enclosure commands enclosure list p...

Page 277: ...Windows related backup commands To execute a CLI command script type the at sign followed by the file name that contains the CLI commands for example AAC0 array txt Creating an Automated Script In its...

Page 278: ...Milpitas Boulevard Milpitas CA 95035 USA 2000 2004 Adaptec Inc All rights reserved Adaptec and the Adaptec logo are trademarks of Adaptec Inc which may be registered in some jurisdictions Part Number...