manualshive.com logo in svg

Adaptec 2254100-R - SATA RAID 2410SA SGL/64 Controller, Software Reference Manual, Page: 1 / 233

Share
Download
Adaptec 2254100-R - SATA RAID 2410SA SGL/64 Controller Software Reference Manual Download Page 1

 Adaptec Serial ATA RAID

2410SA Command Line

Interface

Software Reference Guide

R

Summary of Contents for 2254100-R - SATA RAID 2410SA SGL/64 Controller

Page 1: ...Adaptec Serial ATA RAID 2410SA Command Line Interface Software Reference Guide R...

Page 2: ...untries used 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...

Page 3: ...e 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 3 Syntax and...

Page 4: ...d State Items 3 12 4 General Control Commands close 4 2 Syntax 4 2 exit 4 2 Syntax 4 2 help 4 2 Syntax 4 2 Parameters 4 2 Switches 4 2 history_size 4 3 Command Availability 4 3 Syntax 4 3 Parameters 4...

Page 5: ...or 5 9 Notes 5 9 Syntax 5 9 Parameters 5 9 Switches 5 10 Examples 5 11 Related Information 5 12 container create mstripe 5 14 Notes 5 14 Syntax 5 14 Parameters 5 15 Switches 5 15 Examples 5 16 Related...

Page 6: ...Related Information 5 38 container delete 5 40 Notes 5 40 Syntax 5 40 Parameters 5 40 Switches 5 40 Examples 5 41 Related Information 5 42 container extend file_system 5 43 Notes 5 43 Command And Swit...

Page 7: ...5 65 Parameters 5 65 Examples 5 65 Related Information 5 66 container move 5 67 Notes 5 67 Syntax 5 67 Parameters 5 67 Examples 5 68 Related Information 5 68 container promote 5 69 Notes 5 69 Syntax 5...

Page 8: ...ter 5 84 Command Availability 5 84 Syntax 5 84 Parameters 5 84 Examples 5 84 Related Information 5 85 container remove failover 5 86 Syntax 5 86 Parameters 5 86 Examples 5 87 Related Information 5 87...

Page 9: ...5 98 Related Information 5 99 container set failover 5 100 Syntax 5 100 Parameters 5 100 Examples 5 100 Related Information 5 101 container set global_failover 5 102 Syntax 5 102 Parameters 5 102 Exam...

Page 10: ...s 5 114 Related Information 5 116 container unlock 5 117 Syntax 5 117 Parameters 5 117 Examples 5 117 Related Information 5 118 container unmirror 5 119 Syntax 5 119 Parameters 5 119 Examples 5 119 Re...

Page 11: ...ller pause_io 6 12 Command And Switch Availability 6 13 Notes 6 13 Syntax 6 13 Parameters 6 13 Examples 6 13 Related Information 6 14 controller rescan 6 15 Syntax 6 15 controller reset_scsi_channel 6...

Page 12: ...ontroller show array_verify 6 25 Syntax 6 25 Examples 6 25 Related Information 6 25 7 disk Commands disk blink 7 2 Syntax 7 2 Parameters 7 2 Switches 7 2 Examples 7 2 disk initialize 7 3 Syntax 7 3 Pa...

Page 13: ...14 disk show partition 7 15 Syntax 7 15 Examples 7 15 disk show smart 7 18 Syntax 7 18 Parameters 7 18 Switches 7 18 Examples 7 19 Related Information 7 21 disk show space 7 22 Syntax 7 22 Parameters...

Page 14: ...lated Information 8 4 9 task Commands task list 9 2 Syntax 9 2 Parameters 9 2 Switches 9 2 Examples 9 2 The Specific2 Column 9 6 Related Information 9 7 task resume 9 8 Syntax 9 8 Parameters 9 8 Switc...

Page 15: ...xv Adaptec SCSI RAID Software Reference Guide Examples 9 12 Related Information 9 13 A Automated Scripts Creating an Automated Script A 1...

Page 16: ...cal 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 Through the CLI you perform most of the sto...

Page 17: ...sted in the installation guide For the latest supported operating system versions of the Adaptec SCSI RAID controller visit Adaptec s product web site at www adaptec com How to Use this Manual The Ada...

Page 18: ...mmands describes the features conventions command syntax parameters and value types that define the command line interface Chapter 4 General Control Commands details general purpose commands such as o...

Page 19: ...ng beyond 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 g...

Page 20: ...on includes a percent number that indicates percentage completion On NetWare the status information appears in a different console screen On UNIX the status information appears at the bottom of the CL...

Page 21: ...ecutable resides See your Windows NT or MS DOS documentation for more information Accessing the CLI from the Windows Start Button You can execute the command line interface CLI From the Windows XP Win...

Page 22: ...UNIX Linux documentation for information on setting up directory paths in the login and cshrc files Accessing the CLI from the NetWare Server Console To access the CLI from the NetWare server console...

Page 23: ...bbreviations You can abbreviate commands subcommands and switches You must provide enough characters so the commands are not ambiguous Subcommand Mode Subcommand mode simplifies command entry when you...

Page 24: ...simply type the following at the _array prompt and press Enter move 1 2 To exit subcommand mode press Enter You may have to press Enter more than once to exit subcommand mode CLI unique commands For N...

Page 25: ...llowed by an object switches and parameters Object An object describes what to use in an action Examples include mirror volume mstripe and drive_letter Switch A switch is an element applied to a comma...

Page 26: ...usually mandatory You must place optional parameters after mandatory parameters at the end of the command For example the array remove failover command has one required scsi_device parameter and addit...

Page 27: ...number that has a value between 263 and 263 1 Although the valid range is usually much smaller all integers have 64 bits of precision and do not contain decimal points You can specify an integer as a...

Page 28: ...g You can specify a text string with or without quotation marks If spaces are needed however the string must be specified with quotation marks otherwise the CLI interprets spaces as delimiters A strin...

Page 29: ...integer integer integer Each integer corresponds to one component of a device descriptor or specifier the first integer is the SCSI channel number the second integer is the device ID and the third in...

Page 30: ...lowing syntaxes are allowed for the free_space parameter 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 free...

Page 31: ...with array IDs 0 through 23 Array IDs 24 through 63 are reserved for hidden arrays A hidden array is an array that is not visible to the operating system and can only be used by other arrays However t...

Page 32: ...he bottom of the CLI 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 following sections describe each...

Page 33: ...k The array merge command causes the MMR value to display MSC array scrub task The array scrub command causes the MSC value to display NTF array format task with an NTFS file system specified The arra...

Page 34: ...ws the percentage in tenths of a percent increments The currently running task is complete when the State item displays 100 Table 3 8 describes the state values that the State item can display Table 3...

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

Page 36: ...p To invoke general or topical Help commands use the help command or the question mark Syntax command command help full command help full command subset Parameters If the command has more subcommands...

Page 37: ...d The open command prepares a particular controller for access by the CLI If you specify this command when another controller is open during a particular command session the CLI closes the currently o...

Page 38: ...you open the controller with read only access you can use only the commands that do not change the controller configuration domain string Specifies the domain the local domain or a trusted domain in...

Page 39: ...t_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 mes...

Page 40: ...tainer create raid5 5 24 container create stripe 5 30 container create volume 5 35 container delete 5 40 container extend file_system 5 43 container extend mvolume 5 46 container extend volume 5 50 co...

Page 41: ...opening the controller is not shown container remove drive_letter 5 84 container remove failover 5 86 container remove file_system 5 88 container remove global_failover 5 90 container restore RAID5 5...

Page 42: ...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 43: ...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 44: ...Ware 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 to create a mirror set...

Page 45: ...a mirror 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 volume set on this controller prior to...

Page 46: ...ype column displays a new array type which in the example is Mirror instead of the previously displayed Volume The State column displays Normal instead of a blank as the mirror state Note that this co...

Page 47: ...Commands Related Information container commands container create mmirror page 5 9 container list page 5 54 container split page 5 113 container unmirror page 5 119 disk commands disk remove dead_parti...

Page 48: ...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 49: ...e available on each specified device The number of 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 free...

Page 50: ...lume sets that was previously created with the container promote command The freespace from devices 0 4 0 and 0 5 0 are used to mirror the underlying volume sets The default I O delay is taken The mul...

Page 51: ...ple are all in the Normal 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 ID for the disk s on w...

Page 52: ...5 13 container Commands disk commands disk remove dead_partitions page 7 9...

Page 53: ...m which you want to create the multilevel stripe set If NetWare is using any of these arrays an appropriate message displays This message indicates that one or more of the arrays you specified is in u...

Page 54: ...ust be the same size as the first container parameter and separated by blank spaces Switches stripe_size integer Specifies the stripe size for the multilevel stripe set Valid values are 16 KB 32 KB an...

Page 55: ...eate a multilevel stripe set from two equally sized arrays using the default stripe size of 64 KB In this example the two equally sized arrays are mirror sets AAC0 container create mstripe 0 1 Executi...

Page 56: ...stripe set The Type column also displays the array type for the underlying arrays In the example Mirror appears in the Type column to indicate that the arrays that make up the multilevel volume set a...

Page 57: ...In the example the display shows that array 63 s partitions are on SCSI disk 0 02 0 array 62 s partitions are on SCSI disk 0 03 0 The Partition Offset Size column displays the partition offset and th...

Page 58: ...opriate 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 arrays...

Page 59: ...for the label If you do not specify the switch it defaults to no label If you do not specify a label you can do so later by using the container set label command Examples Before creating a multilevel...

Page 60: ...ffset Size 0 Volume 60 0MB None 63 Stripe 45MB 64KB 0 02 0 64 0KB 15 0MB 0 03 0 64 0KB 15 0MB 0 04 0 64 0KB 15 0MB 62 Stripe 15MB 64KB 0 05 0 64 0KB 15 0MB The following list describes the columns tha...

Page 61: ...e stripe size when you create stripe sets and RAID 5 sets In the example the stripe size is 32 KB The Usage column displays None to indicate that the newly created multilevel volume set does not have...

Page 62: ...5 23 container Commands Related Information container commands container create mmirror page 5 9 container create raid5 page 5 24 container create stripe page 5 30 container set label page 5 107...

Page 63: ...mentation Syntax container create raid5 cache boolean clear boolean stripe_size integer label string scrub boolean wait boolean free_space scsi_device Parameters free_space Specifies the SCSI device a...

Page 64: ...orruption during a power failure You can enable write cache only if a native operating system s file system in Windows the NTFS or FAT file system resides on the array If you do not want to enable the...

Page 65: ...et label command Note that this label is not the label that displays in Windows Explorer The label displayed by Windows Explorer comes from the label specified with the container format command scrub...

Page 66: ...e scrub or zero action completes The default is FALSE the command prompt returns immediately before the parity protect operation completes Examples The following example creates a RAID 5 set with the...

Page 67: ...ith the newly created RAID 5 set Use the container list command after using the container create raid5 command to display information about the RAID 5 set AAC0 container list Executing container list...

Page 68: ...state of an array which in the example shows Unprot to indicate that the RAID 5 set is not yet redundant This means that the command has not completed the creation of the RAID 5 set If the container l...

Page 69: ...freespace used to create the stripe set See the free_space section on page 3 8 for more information on how to specify the freespace scsi_device Specifies one or more devices A SCSI ID consists of a SC...

Page 70: ...e the stripe set s array cache when you create it you can do so later by using the container set cache command stripe_size integer Specifies the stripe size for the stripe set Valid values are 16 KB 3...

Page 71: ...shows how to create a stripe set with the following characteristics 15 MB of freespace on the 0 2 0 SCSI disk The default stripe size of 64 KB Two freespaces of 15 MB on the 0 3 0 and 0 4 0 SCSI disks...

Page 72: ...he 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 array is a stripe set The Total Size column displ...

Page 73: ...lumn displays the partition offset s and the size s for the disk s whose associated freespaces you used to create the stripe set In this example the display shows 64 0KB 15MB 64 0KB 15 0MB and 64 0KB...

Page 74: ...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 through 15 inclusive and SCSI device logical un...

Page 75: ...ng maximum performance Notes When the write cache is enabled there is a potential for data loss or corruption during a power failure You can enable write cache only if a native operating system s file...

Page 76: ...SI disks available to create the volume set The following example creates a volume set on SCSI disk 0 2 0 with a freespace of 15 MB AAC0 container create volume 0 2 0 15M Executing container create vo...

Page 77: ...s the value s specified in the free_space parameter s which in the example is 15 0 MB The Usage column displays None to indicate that the newly created volume set does not have a file system on it To...

Page 78: ...5 39 container Commands disk commands disk show space page 7 22...

Page 79: ...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 80: ...here is an array 0 a multilevel volume set 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 F 0...

Page 81: ...ays arrays 63 62 and 61 Related Information container commands container create mirror page 5 5 container create mmirror page 5 9 container create mstripe page 5 14 container create mvolume page 5 19...

Page 82: ...notes relate to using the container extend file_system command to extend an NTFS file system If you extend an NTFS file system the command displays an appropriate message indicating that you need to r...

Page 83: ...erhaps after extending a multilevel volume set Before extending a file system use the container list command to obtain information about any existing arrays AAC0 container list Executing container lis...

Page 84: ...d in Steps 5 and 6 to the array created in Step 1 The following example extends the NTFS file system to make use of the additional arrays AAC0 container extend file_system 0 Executing container extend...

Page 85: ...ems Windows NT Windows 2000 basic disk only Windows XP basic disk only Syntax container extend mvolume container_to_extend container container Parameters container_to_extend Specifies the ID number 0...

Page 86: ...ripe Scsi Partition Dr Label Type Size Ctr Size Usage C ID L Offset Size F 0 Volume 10MB NTFS 63 Volume 10MB 0 02 0 64 0KB 10 0MB 1 Volume 15MB None 0 03 0 64 0KB 15 0MB 2 Volume 15MB None 0 04 0 64 0...

Page 87: ...umn displays the ID numbers in this example 62 and 61 of the volume sets created as a result of the container extend mvolume command If you specified labels when creating the volume sets they appear i...

Page 88: ...dead the colon in the Partition Offset Size column changes to a exclamation point See the disk remove dead_partitions page 7 9 command for more information on dead partitions Related Information cont...

Page 89: ...e_space 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...

Page 90: ...disk show space command to display space usage information on the devices from which you plan to add freespace The following example extends a volume set by adding freespace from two devices AAC0 con...

Page 91: ...lue s specified for the free_space parameters In the example the new size is 164 MB The Usage column continues to display NTFS indicating that array 1 has an NTFS file system on it The Scsi C ID L col...

Page 92: ...5 53 container Commands Related Information container commands container create volume page 5 35 container list page 5 54 disk commands disk remove dead_partitions page 7 9 disk show space page 7 22...

Page 93: ...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 94: ...r Size Usage C ID L Offset Size 0 Volume 15 0MB None 0 02 0 64 0KB 15 0MB 1 Stripe 45 0MB 32KB None 0 02 0 15 0MB 15 0MB 0 03 0 64 0KB 15 0MB 0 04 0 64 0KB 15 0MB The detailed container list display c...

Page 95: ...automatically assign an ID to an array However you can renumber an array with the container move command This column also displays the label assigned to the array when the array was created If no lab...

Page 96: ...r The container reconfigure command provides switches that allow you to reconfigure an array into specific array types The Reconf array type does not appear on UNIX systems The Total Size Column This...

Page 97: ...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 DOS partitions NetWar...

Page 98: ...read only and read write Table 5 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...

Page 99: ...e column can display the items listed in Table 5 4 Table 5 4 Task Types Task Meaning Create A create mirror set or create multilevel mirror set task is running on the specified array When the create m...

Page 100: ...t 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 running...

Page 101: ...n the form mmddyy where mm is a two digit 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 d...

Page 102: ...array resides on the boot device Otherwise if the array does not reside on the boot device no value appears in the column The Boot Device column does not appear on UNIX systems The System Files Column...

Page 103: ...ion container commands container create mirror page 5 5 container create mstripe page 5 14 container create raid5 page 5 24 container create stripe page 5 30 container scrub page 5 94 disk commands di...

Page 104: ...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 105: ...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 colu...

Page 106: ...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 107: ...ve 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 contai...

Page 108: ...provides the fault tolerance to make this array an array of mirror sets Notes The container promote command differs from the container add_level command as follows The container create volume command...

Page 109: ...formation about the array you just promoted 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...

Page 110: ...sides on disk 0 04 0 The Partition Offset Size column displays the offset and size for the underlying arrays partitions In the example arrays 63 62 and 61 have 64 0 KB offsets and 15 0 MB sizes If a p...

Page 111: ...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 112: ...i 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 column...

Page 113: ...he 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 the RO colum...

Page 114: ...si Dr Label Type Size Ctr Size Usage C ID L RO 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 RO column A...

Page 115: ...ves to an array You can add more SCSI drives to an array by specifying one or more devices This action extends the array The command uses the freespace s from the SCSI device s you specify to reconfig...

Page 116: ...iously listed operations Notes Some reconfigure operations result in destination sizes slightly different than what you specified When you perform an array reconfigure operation on a UNIX operating sy...

Page 117: ...specify to reconfigure the array Switches stripe_size integer Specifies the changed stripe size for the array You can specify stripe sizes for the following types of arrays RAID 5 set Multilevel stri...

Page 118: ...irror boolean Specifies whether to reconfigure the existing array into a mirror set If you specify TRUE the command reconfigures the existing array into a mirror set If you specify FALSE the command d...

Page 119: ...ecify FALSE the command does not reconfigure the existing array into a RAID 10 set This switch defaults to FALSE stripe boolean Specifies whether to reconfigure the existing array into a stripe set If...

Page 120: ...ple shows there is an array 0 a mirror set and an array 1 a volume set on this controller AAC0 container list Executing container list Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size U...

Page 121: ...0KB 15 0MB Tigris 1 03 0 64 0KB 15 0MB E 1 Stripe 15 0MB NTFS 1 00 0 64 0KB 15 0MB As the result of reconfiguring an array in this example array 1 with the container reconfigure command the Type colu...

Page 122: ...viously 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 arrays...

Page 123: ...ters string Specifies the drive letter to remove The colon after the drive letter is optional Examples Before removing a drive letter from an array use the container list command to obtain information...

Page 124: ...csi Partition Dr Label Type Size Ctr Size Usage C ID L Offset Size 0 Volume 10 0MB NTFS 0 02 0 64 0KB 10 0MB As the result of removing a drive letter from an array in this example array 0 with the con...

Page 125: ...hose assigned failover disk s you want to remove scsi_device Specifies the ID for the SCSI device that you want to remove as a failover disk for the array specified in the container parameter You prev...

Page 126: ...as an assigned failover disk for array 0 AAC0 container remove failover 0 0 3 0 Executing container remove failover 0 CHANNEL 0 ID 3 LUN 0 Use the container show failover command after removing a fail...

Page 127: ...s 2000 basic disk only Windows XP basic disk only Syntax container remove file_system container Parameters container Specifies the ID number 0 to 63 of the array from which you want to remove the file...

Page 128: ...nformation 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 Vol...

Page 129: ...ormation on how to specify the SCSI device scsi_device Specifies the ID s for any other SCSI device s you want to remove as failover disk s for all arrays You previously assigned these SCSI device s a...

Page 130: ...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 GLOBAL 1 03 0 0 No Devices Assigned As the displa...

Page 131: ...ID 5 set by using this command Syntax container restore RAID5 container Parameters container Specifies the ID number 0 to 63 of the array a RAID 5 set to restore Examples Before restoring a RAID 5 set...

Page 132: ...ripe Scsi Partition Dr Label Type 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 th...

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

Page 134: ...s the following example shows there is an array 0 a mirror set on this controller AAC0 container list Executing container list Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C I...

Page 135: ...l Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage 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 As the example shows there is no difference between th...

Page 136: ...che parameters assuming they were previously set on the array when the reconfiguration operation completes The controller provides two global cache buffer pools available to arrays a volatile read ahe...

Page 137: ...e that if you disable the read ahead cache no other characteristics can be set write_cache_enable boolean Specifies whether to enable the array s NVRAM write back cache Examples Before setting cache p...

Page 138: ...nformation as in the following example AAC0 container show cache 0 Executing container show cache 0 Global container Read Cache Size 5345280 Global container Write Cache Size 1970176 Read Cache Status...

Page 139: ...n 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 container parameter A SCSI ID c...

Page 140: ...fficient 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 l...

Page 141: ...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 inclusive See the scsi_device...

Page 142: ...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 143: ...I O delay from the one you specified in the command for the previously listed tasks The I O delay value is not preserved between reboots of the operating system Syntax container set io_delay container...

Page 144: ...erwise you cannot change the I O delay container create mirror io_delay 20 0 0 2 0 Executing container create mirror io_delay 20 0 CHANNEL 0 ID 2 LUN 0 The following example shows how to change the I...

Page 145: ...5 106 container Commands Related Information container commands container create mirror page 5 5 container create mmirror page 5 9 container list page 5 54 container scrub page 5 94...

Page 146: ...ted with the previously listed container create commands is not the label that displays in Windows Explorer The label displayed by Windows Explorer comes from the label specified with the container fo...

Page 147: ...set label command to display the new label 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...

Page 148: ...rameters you want to display Examples Before setting cache parameters for a specific array use the container list command to obtain information about any existing arrays As the following example shows...

Page 149: ...locks devoted to the read cache Global container Write Cache Size This item indicates the number of blocks devoted to the write cache Read Cache Setting This item indicates whether the read cache is s...

Page 150: ...5 111 container Commands container list page 5 54 container set cache page 5 97 container show cache page 5 109...

Page 151: ...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 fail...

Page 152: ...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 On Windows NT Windows 2000 basic disk only Windows XP...

Page 153: ...sting array array 0 a mirror set on this controller at the time the mirror set is split AAC0 container list Executing container list Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usa...

Page 154: ...was created If no label s was assigned to the array s then no label s appears in the column On UNIX systems the root special file associated with the array also appears in this column The Type column...

Page 155: ...mmands Related Information container commands container create mirror page 5 5 container create mmirror page 5 9 container list page 5 54 container unmirror page 5 119 disk commands disk remove dead_p...

Page 156: ...an array 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 tha...

Page 157: ...g container list full TRUE Num Total Oth Stripe Scsi 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...

Page 158: ...ou previously created the mirror set by using the container create mirror or container create mmirror command Examples Before unmirroring a mirror set use the container list command to obtain informat...

Page 159: ...Volume which indicates that the mirror set was created from a Volume set The State column displays a blank space instead of Normal The Normal state is displayed only for mirror sets The Scsi C ID L c...

Page 160: ...oller firmware update 6 9 controller list 6 10 controller pause_io 6 12 controller rescan 6 15 controller reset_scsi_channel 6 16 controller resume_io 6 17 controller set automatic_failover 6 18 contr...

Page 161: ...ller serial number Last six digits 8A277A Number of Buses 1 Devices per Bus 15 Controller CPU i960 Controller CPU speed 100 Mhz Controller Memory 144 Mbytes Battery State Not present Component Revisio...

Page 162: ...SN sticker located on the controller itself The Number of Channels and Devices per Channel Items The Number of Buses item displays the number of channels actually found on the controller In the examp...

Page 163: ...etwork services software This item displays only if the open controller resides on a remote computer In the example the revision level is 2 1 0 Build 2881 Remote API Displays the revision level of the...

Page 164: ...roller 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 versi...

Page 165: ...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 compar...

Page 166: ...his 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 directory where you want to c...

Page 167: ...6 8 controller Commands Related Information controller commands controller firmware compare page 6 6 controller firmware update page 6 9...

Page 168: ...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 If...

Page 169: ...er name the command displays only the controllers on the local computer Switches domain string Specifies the domain in which the specified computer resides If you do not specify this switch the comman...

Page 170: ...ailability Item The Availability item displays the availability of the controller Table 6 2 lists the values that can display in this item Table 6 2 Controller Availability Status Related Information...

Page 171: ...eout is client based and different clients 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 del...

Page 172: ...hile an array task is running on the controller Use the task list command to display a list of currently running array tasks Syntax controller pause_io integer Parameters integer Specifies the amount...

Page 173: ...6 14 controller Commands Related Information controller commands controller resume_io page 6 17 task commands task list page 9 2...

Page 174: ...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 175: ...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 176: ...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...

Page 177: ...disk that you configure to automatically recover data from a failed partition disk in a redundant array To assign one or more failover disks for a single array you use the array set failover command T...

Page 178: ...s automatic failover is currently off disabled AAC0 controller show automatic_failover Executing controller show automatic_failover Automatic failover DISABLED The following example turns on enables...

Page 179: ...fied controller To turn off the array verify feature on the specified controller set this switch to FALSE The command defaults to TRUE which means the command turns on the array verify feature on the...

Page 180: ...re 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_verif...

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

Page 182: ...g sections provide more information on the items that the controller show channels command displays The Ch and Host ID Items The Ch item displays the number of the channel on the controller In the exa...

Page 183: ...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 Rela...

Page 184: ...ture 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 on enabled The command also displays...

Page 185: ...mmands disk command object switch value parameter disk blink 7 2 disk initialize 7 3 disk list 7 5 disk remove dead_partitions 7 9 disk set default 7 10 disk set smart 7 12 disk show partition 7 15 di...

Page 186: ...the number of seconds 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 asynchronous...

Page 187: ...3 7 for more information on how to specify the SCSI device Switches always boolean Specifies whether to initialize the disk even if the disk has data on it If you specify TRUE for this switch the com...

Page 188: ...conditionally 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 dev...

Page 189: ...ore information on how to specify the SCSI device Switches all boolean Specifies whether to display a list of all devices If you set this switch to TRUE the command displays a list of all devices on t...

Page 190: ...evice channel number the device ID and the device logical unit number for each disk on the currently opened controller The display shows only one disk if you specified a particular disk In the example...

Page 191: ...lock Column The Block column displays the number of blocks available on the device The Bytes Block Column The Bytes Block column displays the number of bytes for each block on the device Processor The...

Page 192: ...ated speed of the device in megabytes per second Related Information disk commands disk initialize page 7 3 disk show partition page 7 15 disk show space page 7 22 Value Meaning Detached The system de...

Page 193: ...is dead the 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 Specif...

Page 194: ...7 10 disk Commands Related Information array commands array list page 5 54...

Page 195: ...ee the scsi_device section on page 3 7 for more information on how to specify the SCSI device If you do not specify a device ID the command displays an appropriate error message Examples The following...

Page 196: ...7 12 disk Commands Related Information disk commands disk list page 7 5...

Page 197: ...ble 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 clear b...

Page 198: ...or disks 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 exceptio...

Page 199: ...The value 0 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 devi...

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

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

Page 202: ...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 RO The partition is rea...

Page 203: ...you want to display S M A R T configuration information 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...

Page 204: ...to FALSE Examples The following example shows how to display nondetailed S M A R T configuration information for all disks on the system AAC0 disk show smart Executing disk show smart Smart Method of...

Page 205: ...xception Control Column The Enable Exception Control column displays the value Y if you enabled S M A R T exception control reporting or the value N if you did not enable S M A R T exception control r...

Page 206: ...number of seconds for the exception reporting interval The Report Count Column The Report Count column displays the number of times you specified for exceptions to be reported You specify this number...

Page 207: ...cify the SCSI device 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...

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

Page 209: ...s 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 disk...

Page 210: ...information on how to specify the SCSI device 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...

Page 211: ...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 R...

Page 212: ...k you want to clear 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 See the scsi_device sectio...

Page 213: ...mmediately 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 used AAC0 disk zero always wait 0 2 0...

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

Page 215: ...mmand 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...

Page 216: ...ly Windows XP basic disk only file name conventions If the file name has spaces use quotation marks to enclose the string On NetWare use the NetWare file name conventions On UNIX use the UNIX file nam...

Page 217: ...ac0log17Nov01 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 existi...

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

Page 219: ...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 220: ...cribes the types of tasks that the task list command can display Table 9 1 Task Types Task Type Meaning Create A create mirror set or create multilevel mirror set task is running on the specified arra...

Page 221: ...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 222: ...f bad blocks task completes the specified SCSI disk s blocks were verified without repairing any detected defects The verify with no repair of bad blocks task runs as a result of using the disk verify...

Page 223: ...describes the additional information that task list can display State Meaning BAD The task failed and is no longer running DNE The task successfully completed or the task is no longer running that is...

Page 224: ...ommands disk verify page 7 26 disk zero page 7 28 task commands task resume page 9 8 task stop page 9 10 task suspend page 9 12 Task Additional Information Verify Refers to the verify with repair of b...

Page 225: ...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 226: ...C0 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 227: ...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 an appropriate error message Examples Before stopping a runnin...

Page 228: ...9 11 task Commands AAC0 task list Executing task list No tasks currently running on controller Related Information task commands task list page 9 2...

Page 229: ...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 230: ...AC0 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 display...

Page 231: ...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 232: ...A 2 Automated Scripts...

Page 233: ...ll rights reserved Adaptec and the Adaptec logo are trademarks of Adaptec which may be registered in some jurisdictions Part Number 513603 06 Ver AA 05 03 Adaptec Inc 691 South Milpitas Boulevard Milp...

Reviews:

No comments