manualshive.com logo in svg

AMCC 3WARE 9500S, Руководство пользователя

Поделиться
Скачать
AMCC 3WARE 9500S Скачать руководство пользователя страница 35

Shell Object Commands

www.3ware.com 

27

flush

This command sends a flush command to all 3ware controllers in the system. 
For more information, see “/cx flush” on page 41.

rescan 

This command sends a rescan command to all 3ware controllers in the system. 
For more information, see “/cx rescan [noscan]” on page 40.

commit 

This command sends a commit command to all 3ware controllers in the 
system. For more information, see “/cx commit” on page 41.

Содержание 3WARE 9500S

Страница 1: ...3ware Serial ATA RAID Controller Command Line Interface Supports the 9000 Series 9500S 9550SX 9590SE PN 720 0127 04 April 2006 CLI Guide...

Страница 2: ...of AMCC 215 Moffett Park Drive Sunnyvale CA 94089 Trademarks 3ware Escalade and 3DM are all registered trademarks of AMCC The 3ware logo 3BM StorSwitch TwinStor and R5 Fusion are all trademarks of AMC...

Страница 3: ...LI to a Text File 9 Conventions 9 Understanding RAID Concepts and Levels 10 Available RAID Configurations 11 Determining What RAID Level to Use 14 StorSave Profiles 16 Chapter 2 Primary CLI Syntax Ref...

Страница 4: ...show rebuild 42 cx show verify 45 cx show selftest 46 cx add rebuild ddd hh duration 47 cx add verify ddd hh duration 47 cx add selftest ddd hh 48 cx del rebuild slot_id 49 cx del verify slot_id 49 cx...

Страница 5: ...Object Commands 69 cx px show 69 cx px show attribute attribute 69 cx px show status 69 cx px show model 70 cx px show serial 70 cx px show firmware 70 cx px show identify 70 cx px show ncq 71 cx px...

Страница 6: ...rts 91 info cid numunits 91 info cid numdrives 92 info cid unitstatus 92 info cid allunitstatus 92 info cid drivestatus 93 info cid exportjbod 93 info cid ondegrade 93 info cid spinup 93 info cid stag...

Страница 7: ...fy cid add dday hhour tduration 108 sched verify cid remove slot_id 109 sched verify cid enable 109 sched verify cid disable 109 sched selftest cid 109 sched selftest cid add dday hhour 110 sched self...

Страница 8: ...Chapter 3 vi 3ware 9000 Series Serial ATA Controller CLI Guide...

Страница 9: ...accomplish the same configuration and maintenance tasks for your 3ware controller While this manual includes instructions for performing tasks using the command line interface two additional tools are...

Страница 10: ...2 3ware 9000 Series Serial ATA Controller CLI Guide...

Страница 11: ...the latest versions and upgrade instructions Features 3ware CLI is a command line interface storage management application for 3ware RAID Controllers It provides controller logical unit drive and BBU...

Страница 12: ...Logical Units Usually shortened to units These are block devices presented to the operating system A logical unit can be a one tier two tier or three tier arrangement JBOD Spare and Single logical uni...

Страница 13: ...and html formats These are located in packages cli tw_cli 8 html or tw_cli 8 nroff To install 3ware CLI on Windows Copy the file tw_cli exe to the directory from which you want to run the program CLI...

Страница 14: ...directory from which you want to run the program CLI is located on the 3ware CD in packages cli freebsd or packages cli linux Online manual pages are also available in nroff and html formats These are...

Страница 15: ...that are used with the Battery Backup Unit BBU Details of the primary syntax are described under Primary CLI Syntax Reference on page 19 Legacy command syntax In the current CLI version the command sy...

Страница 16: ...rform a task such as redirecting the output of the command to a file It also allows you to use the command line history to eliminate some typing Syntax tw_cli command line arguments Example tw_cli c0...

Страница 17: ...d parameters for example c0 p0 show all In commands an italic font indicates items that are variable but that you must specify such as a controller ID or a unit ID for example c0 p0 show attribute and...

Страница 18: ...a 3ware controller provides improved performance because 3ware s TwinStor technology reads from both drives simultaneously Striping Striping across disks allows data to be written and accessed on mor...

Страница 19: ...triped disk array see Figure 1 large files are distributed across the multiple disks using RAID 0 techniques Striped disk arrays give exceptional performance particularly for data intensive applicatio...

Страница 20: ...imultaneously reading alternating sections of the file For the smaller random transactions the data is read from a single optimal drive head Figure 2 RAID 1 Configuration Example RAID 5 Combines strip...

Страница 21: ...the RAID 10 array fail then all of the data will be lost Figure 4 RAID 10 Configuration Example RAID 50 This array is a combination of RAID 5 with RAID 0 This array type provides fault tolerance and h...

Страница 22: ...the article RAID Primer on the 3ware website at http www 3ware com products pdf RAID_Primer pdf Determining What RAID Level to Use Select the RAID configuration to use based on the applications to be...

Страница 23: ...n of RAID 0 RAID 1 hot spare 6 or more RAID 50 Depending on the number of drives a RAID 50 may contain from 2 to 4 subunits For example with 12 drives possible RAID 50 configurations include 2 subunit...

Страница 24: ...rformance for a unit by specifying the StorSave Profile to be used Three profiles are provided Protection maximum data protection Performance maximum performance less data protection and Balanced a mi...

Страница 25: ...FUA is ignored because the BBU preserves the contents of the controller cache memory for a limited period of time up to 72 hours in the event of a power failure Write Journaling Write journaling trac...

Страница 26: ...e cache can be disabled until the unit is rebuilt Once the unit is rebuilt you must enable the write cache manually using 3DM2 3BM or the CLI The write cache will not automatically reenable when the u...

Страница 27: ...Common Tasks Mapped to CLI Commands The table below lists many of the tasks people use to manage their RAID controllers and units and lists the primary CLI command associated with those tasks Table 5...

Страница 28: ...apacity cx ux migrate 64 Delete a unit cx ux del 59 Remove a unit export cx ux export 58 Name a unit cx ux set name 62 Controller Maintenance Tasks Add a time slot to a rebuild schedule cx add rebuild...

Страница 29: ...he value of name value attributes are expressed in the format attribute value Example When adding creating a unit to the controller with the following command string c1 add type raid1 disk 0 1 c1 is t...

Страница 30: ...bject commands provide information and perform actions related to a specific unit on a specific controller For example you use unit object commands for such tasks as seeing the rebuild verify or initi...

Страница 31: ...stead of having to type the entire object name each time For example where normally you might type hostname c0 u0 show if you set the focus to hostname c0 u0 the prompt changes to reflect that and you...

Страница 32: ...m should be loaded for the list to show all controllers The intention is to provide a global view of the environment Typical output of the Show command looks like localhost show Ctl Model Ports Drives...

Страница 33: ...in the system show rebuild This command displays all rebuild schedules for the 9000 controllers in the system The rebuild rate is also applicable for initializing migrating and recovery background ta...

Страница 34: ...f background tasks and schedules in 3ware 9550SX Serial ATA RAID Controller User Guide show selftest This command displays all selftest schedules for the 9000 controllers in the system Example localho...

Страница 35: ...ystem For more information see cx flush on page 41 rescan This command sends a rescan command to all 3ware controllers in the system For more information see cx rescan noscan on page 40 commit This co...

Страница 36: ...tus verify 9000 series cx show all cx add type RaidType disk p p stripe Stripe noscan nocache group 3 4 5 6 autoverify ignorECC RaidType raid0 raid1 raid5 raid10 raid50 single spare jbod 7000 8000 onl...

Страница 37: ...of the drives in the unit This feature provides a diagnostic capability for potential problem drives The error may not be a repeated error and may be caused by an ECC error SMART failure or a device e...

Страница 38: ...t Temp Hours LastCapTest bbu On Yes OK OK OK 241 22 Jun 2004 cx show attribute attribute This command shows the current setting of the specified attributes on the specified controller One or many attr...

Страница 39: ...IOS version of controller cx Example localhost c0 show bios c0 BIOS Version BG9X 2 x cx show monitor This command reports the monitor firmware boot loader version of controller cx Example localhost c0...

Страница 40: ...ecified controller cx This report does not include logically removed or exported drives Also note that physically removed disk s will not be detected unless I O is performed against the disk See cx px...

Страница 41: ...ported Example localhost c0 show exportjbod c0 JBOD Export Policy Not Supported localhost c1 show exportjbod c1 JBOD Export Policy on cx show spinup This feature only applies to 9000 series controller...

Страница 42: ...can be treated as an individual drive with its own file system The default carvesize is 2TB For more information see cx show carvesize below For operating systems that support units larger than 2TB t...

Страница 43: ...orebuild on off on page 53 1 Smallest usable spare 2 Smallest usable unconfigured available drive 3 Smallest usable failed drive If the policy is disabled only spare drives will be used for an automat...

Страница 44: ...e Shell Object Commands on page 23 Example localhost c0 show allunitstatus c0 Total Optimal Units 2 c0 Not Optimal Units 0 cx show drivestatus This command reports a list of drives and their port assi...

Страница 45: ...Total Optimal Units 2 c0 NotOptimalUnits 0 c0 Total Units 2 c0 JBOD Export Policy off c0 Disk Spinup Policy 7 c0 Spinup Stagger Time Policy sec 4 c0 Cache on Degrade Policy Follow Unit Policy c0 Auto...

Страница 46: ...omatically assigned a unique serial number In addition users can assign the unit a name Note The unit s serial number cannot be changed The following table shows supported types and controller models...

Страница 47: ...grouping is 5 and for 12 disks the default grouping is 4 In the case of 12 the disks could be grouped into groups of 3 4 or 6 drives A grouping of 4 is set by default as it provides the best of net ca...

Страница 48: ...This feature is for 9000 series and above controllers The string can be up to 21 characters and cannot contain spaces In order to use reserved characters etc put double quotes around the name string...

Страница 49: ...x flush This command forces the controller to write all cached data to disk for the specified controller cx show alarms reverse Asynchronous events also referred to as AENs or alarms are originated by...

Страница 50: ...icated to technical support or further studied with Linux utilities such as od 1 In order to redirect the output you must run the following command from a command line not from within the tw_cli shell...

Страница 51: ...proper spare drive is set up If the rebuild schedule is enabled while a rebuild process is underway the rebuild will pause until a scheduled time slot Example If a unit is in the initialization state...

Страница 52: ...10 hr s enabled 2 Thu 7 00pm 18 hr s enabled 3 4 5 6 Mon 1 00am 4 hr s enabled 7 Sun 12 00am 1 hr s enabled localhost c1 show Unit UnitType Status Cmpl Stripe Size GB Cache AVerify IgnECC u0 RAID 5 IN...

Страница 53: ...to verify data integrity RAID 10 and 50 are composite types and follow their respective array types On 9000 series non redundant units such as RAID 0 JBOD single and spare are also verified by reading...

Страница 54: ...onitoring Analysis and Reporting Both self tests are checked once each day by default UDMA self test entails checking the current ATA bus speed between controller and attached disk which could have be...

Страница 55: ...for rebuild tasks For details see page 42 2 If any of the scheduled tasks do not match your desired schedule use the cx del rebuild command to remove them For details see page 49 3 Use the cx add rebu...

Страница 56: ...details see page 50 5 Use the cx ux set autoverify on command to turn on autoverify for each unit you want to follow the schedule For details see page 61 Note If you do not enable autoverify for unit...

Страница 57: ...st schedule slots you want described above 4 Use the cx set selftest enable command to enable the schedule this enables all selftest schedule slots For details see page 51 cx del rebuild slot_id This...

Страница 58: ...essing time to I O rather than rebuilds Enabling and disabling rebuild is only for 9000 models however the rebuild rate 1 5 applies to all controllers 7000 and 8000 series controllers have only one se...

Страница 59: ...tures such as RAID level migration cx set ondegrade cacheoff follow This command is only for 9000 series controllers This command allows you to set a controller based write cache policy If the policy...

Страница 60: ...is created or migrated into one or more carvesize volumes and a remaining volume Each volume can then be treated as an individual disk with its own file system The default carvesize is 2 TB This featu...

Страница 61: ...tell the controller to rescan without having to specify it as a spare It also means that if you accidentally disconnect a drive causing the controller to see it as a failed drive and then reconnect i...

Страница 62: ...sh cx ux del noscan quiet cx ux set autoverify on off cx ux set cache on off quiet cx ux set ignoreECC on off cx ux set qpolicy on off 9550SX and 9590SE only cx ux set name string 9000 series cx ux se...

Страница 63: ...K OK p6 298 01 624962560 u1 7 DISK OK p7 298 01 624962560 u1 8 DISK OK p8 298 01 624962560 u1 9 DISK OK p9 298 01 624962560 u1 10 DISK OK p10 298 01 624962560 u1 11 DISK OK p11 298 01 624962560 u1 v0...

Страница 64: ...if any of the specified unit Examples localhost c0 u5 show verifystatus c0 u5 is not verifying its current state is OK cx ux show initializestatus This command reports the initializestatus if any of t...

Страница 65: ...perform quiet on page 62 Example localhost c0 u5 show storsave c0 u5 Command Storsave Policy protect cx ux show volumes This feature only applies to 9000 series controllers This command reports the n...

Страница 66: ...u1 v0 VOLUME 500 00 u1 v1 VOLUME 3078 40 cx ux export noscan quiet This command allows you to export or remove a unit Exporting a unit instructs the firmware to remove the specified unit from its pol...

Страница 67: ...to rebuild a degraded unit using the specified disk p Rebuild only applies to redundant arrays such as RAID 1 RAID 5 RAID 10 and RAID 50 During rebuild bad sectors on the source disk will cause the re...

Страница 68: ...lace at specified start and stop times The cx ux pause rebuild command is provided to enable 7000 8000 users to achieve similar functionality with use of Linux provided schedulers such as cron 8 or at...

Страница 69: ...ssary This can include pausing the process and restarting it before the verify finishes For additional information see Setting Up a Verify Schedule on page 48 cx ux set cache on off quiet This command...

Страница 70: ...when the unit is created and is not changeable cx ux set qpolicy on off This command applies only to 9550SX and 9590SE controllers This command sets the queue policy of the firmware If the queue poli...

Страница 71: ...ation message will warn you that there could be data loss in the event of a power failure quiet is used for non interactive mode No confirmation is given and the command is executed immediately This i...

Страница 72: ...is when the source unit has a type of RAID1 and destination unit has a type of single In this case the migrate command splits both drives into two identical single disks The disk name will be duplicat...

Страница 73: ...are used to form the RAID 5 layer These RAID 5 arrays are then integrated into a RAID 0 This attribute allows you to specify the number of disks in the RAID 5 level Valid values are 3 4 5 and 6 For ex...

Страница 74: ...g system One application of this feature is to prevent the operating system from creating block special devices such as dev sdb and dev sdc as some implementations might create naming fragmentation an...

Страница 75: ...to u3 and ux with a RAID type of Single Example of capacity expansion localhost c0 u0 migrate type raid10 disk 3 4 stripe 16 Indicates that the destination unit has a RAID type of raid10 and has the...

Страница 76: ...ype Status Cmpl Port Stripe Size GB Blocks u0 Migrator MIGRATING 0 su0 RAID 1 OK 74 4951 156227584 su0 0 DISK OK p0 74 4951 156227584 su0 1 DISK OK p1 74 4951 156227584 du0 RAID 10 OK 16K 148 99 31245...

Страница 77: ...cx px show This command shows summary information about the specified disk attached to port cx px Typical information looks like Example localhost c1 p5 show Port Status Unit Size Blocks Serial p5 OK...

Страница 78: ...how serial c0 p5 Serial WD WMACK140649 cx px show firmware This command displays the firmware version of the drive attached to the specified port Example localhost c0 p5 show firmware c0 p5 Firmware V...

Страница 79: ...mum SATA link speed supported by the drive attached to the port and the present SATA link speed setting Example localhost c0 p5 show lspeed c0 p5 SATA Link Speed Supported 3 0 Gb s c0 p5 SATA Link Spe...

Страница 80: ...not a drive is present cx px show all This command shows the current setting for all port related attributes status model serial firmware capacity and smart Example localhost c0 p0 show all c0 p0 Stat...

Страница 81: ...n CLI it can be removed physically without powering down the system if a hot swap carrier is available System hangs and damage can occur if a hot swap carrier is not used cx px set identify on off Thi...

Страница 82: ...bbu enable 9000 only cx bbu disable quiet 9000 only cx bbu show This command presents a summary report on the specified BBU object Example localhost c0 bbu show Name OnlineState BBUReady Status Volt T...

Страница 83: ...e test is completed with no error and the BBU status changes to OK the write cache will be re enabled If a FAULT or ERROR occurs during the test the write cache remains in the disabled state until the...

Страница 84: ...tery Contact AMCC to obtain a replacement battery cx bbu show temp This command shows the temperature status of the battery The status can be OK HIGH LOW TOO HIGH and TOO LOW The HIGH and LOW are in w...

Страница 85: ...er Version BBU 0 02 00 002 c1 bbu PCB Revision 65 localhost cx bbu test quiet This command starts the battery capacity test The test may take up to 24 hours to complete During the test the BBU is not...

Страница 86: ...ark at the point in a command where you are uncertain what the attributes are Help with specific commands If you enter the help command at the top level you are considered to be in the Shell Object an...

Страница 87: ...T 9000 only cx set autorebuild on off 9550SX and 9590SE only cx flush cx commit Windows only Also known as shutdown cx start mediascan 7000 8000 only cx stop mediascan 7000 8000 only cx rescan noscan...

Страница 88: ...Displays or modifies controller and unit settings sched Schedules background tasks on controller s 9000 only quit Exits the CLI New Command Syntax focus Changes from one object to another For Interact...

Страница 89: ...ous ways to use the focus command See the section Shell Object Commands on page 23 for more information help cx This command provides specific controller cx related help illustrating various commands...

Страница 90: ...LD To keep the new CLI Input Style following a reboot or when a new window or shell is opened you must edit the environment variables in both Windows and Linux Refer to your operating system s adminis...

Страница 91: ...o view the return code for Windows in a command window type tw_cli c0 show c0 info displayed here if errorlevel 0 echo 0 0 tw_cli c7 show error if errorlevel 1 echo 1 1 This example fails returns 1 be...

Страница 92: ...Chapter 2 Primary CLI Syntax Reference 84 3ware 9000 Series Serial ATA Controller CLI Guide...

Страница 93: ...ler Typical operations include create array delete array rebuild array verify array and remove array from the controller For details see Maint Commands on page 98 Warning Operations under the maint co...

Страница 94: ...9000 Series Serial ATA RAID Controller User Guide Set Setting commands can be used to modify and change controller and array settings Settings that can be changed include rebuild rate verify rate and...

Страница 95: ...or sh enter export TW_CLI_STYLE OLD For Linux csh C shell enter setenv TW_CLI_STYLE OLD For Windows enter set TW_CLI_STYLE OLD To keep the new CLI output style following a reboot or when a new window...

Страница 96: ...e example shows that the controller s rebuild rate RRate is set to 2 and the verify rate VRate is not applicable Additional attributes about individual controllers units ports and disks can be obtaine...

Страница 97: ...05 GB3125818083JS0VG85 p3 OK u1 149 05 GB3125818083JS0VGCY p4 OK u1 149 05 GB3125818083JS0VGGQ p5 OK u2 149 05 GB3125818083JS0VH1P p6 OK 149 05 GB3125818083JS0TF0P p7 OK 149 05 GB3125818083JS0VF43 p8...

Страница 98: ...er cid Example localhost info c0 firmware c0 Firmware Version FGXX 2 01 00 025 info cid bios This command reports the BIOS version of controller cid Example localhost info c0 bios c0 BIOS Version BG9X...

Страница 99: ...oller cid Example localhost info c0 pchip c0 PCHIP Version 1 30 33 info cid achip This command reports the ACHIP ATA Interface Chip version of the specified controller cid Example localhost info c0 ac...

Страница 100: ...numdrives c0 Number of Drives 5 info cid unitstatus This command presents status of units managed by the specified controller cid It provides a list of units their types current status percent complet...

Страница 101: ...1808 3JS0VH1P p6 OK 149 05 GB 312581808 3JS0TF0P p7 OK 149 05 GB 312581808 3JS0VF43 p8 OK 149 05 GB 312581808 3JS0VG8D p9 NOT PRESENT p10 NOT PRESENT p11 NOT PRESENT info cid exportjbod This command s...

Страница 102: ...f a degraded unit has caused the unit to degrade and which disk within that sub unit is the source of degradation Example localhost info c0 u0 Unit UnitType Status Cmpl Port Stripe Size GB Blocks u0 R...

Страница 103: ...Example localhost info c0 u5 verifystatus c0 u5 is not verifying info cid uid initializestatus This command presents the initialize status if any of the specified unit Example localhost info c0 u5 in...

Страница 104: ...acity is computed based on division by 1024 not 1000 as is popular with hard disk vendors For additional information see the explanation at info cid on page 88 Example localhost info c0 p5 capacity c0...

Страница 105: ...Acoustic 1 Feat Ext TimeLimited R W 0 WDMA FUA 0 Stream 0 Acoustic 0xFE def 0xC0 0xFE best performance Security Status 0x7 ENABLED LOCKED SATA NCQ 0 Udma Mode 0x5 UDMA 100 Pwr Cycles 14 SELF TEST all...

Страница 106: ...ot import non JBOD on 7000 8000 models remove c c u u noscan remove c c p p deleteunit c c u u noscan createunit c c r RaidType p p p k stripe nos can nocache g 3 4 5 6 autoverify ignoreECC Raid Type...

Страница 107: ...m administrator to export units to the OS a later time rather than having the CLI do it for them maint remove cid uid noscan This command allows you to remove or export a unit Exporting a unit instruc...

Страница 108: ...stem Alert Removing a drive causes a redundant array to degrade Drives cannot be removed if they are part of a degraded or non redundant array with the exception of Single and JBOD drives Warning Sing...

Страница 109: ...nd controller models pid_list is a list of ports disks to be used in the construction of the specified unit One or more ports can be specified Multiple ports can be specified using a colon to separate...

Страница 110: ...fault as it provides the best of net capacity and performance noscan switch instructs CLI not to notify OS of the creation of the new unit By default CLI informs the OS One application of this feature...

Страница 111: ...em check is recommended once the rebuild is complete Note The ignoreECC option is not required for the 9000 series if the variable is already assigned when you create or set later Refer to the set ove...

Страница 112: ...wing table shows the supported RAID types for verification as a function of controller model and logical unit type N A Not Applicable refers to cases where the given logical unit type is not supported...

Страница 113: ...took place This command allows the end user to complete all pending I Os on disks and clear the in transaction bit Typical application of this feature is when an application is using a given unit in...

Страница 114: ...dant units On the 9000 series non redundant units including spares are also verified by doing a background scrub which reads each sector Verifying RAID 1 involves checking that both drives contain the...

Страница 115: ...24 hours This command will fail if no empty slot is available Note The new schedule is added to the first available slot Events do not need to be added in sequential order For example localhost tw_cl...

Страница 116: ...ed 1 2 Tue 12 00am 24 hr s disabled 3 Wed 12 00am 24 hr s disabled 4 Thu 12 00am 24 hr s disabled 5 Fri 12 00am 24 hr s disabled 6 Sat 12 00am 24 hr s disabled sched verify cid add dday hhour tduratio...

Страница 117: ...fy background tasks on controller cid Note When enabling the verify schedule you must also remember to also enable the autoverify setting for the arrays to be verified For details see set autoverify c...

Страница 118: ...sched selftest cid remove slot_id This command removes or unregisters the selftest background task in slot slot_id For example localhost tw_cli sched selftest c1 remove 3 Removes rebuild selftest task...

Страница 119: ...following levels of severity Errors Warnings Information When the alarms command is executed only AENs that have been logged since the last time the command was executed are displayed For Linux AENs a...

Страница 120: ...lers Note A listing of AEN codes can be found in the Troubleshooting Problems and Solutions section of 3ware 9000 Series Serial ATA RAID Controller User Guide Typical output looks like tw_cli alarms C...

Страница 121: ...asis overwriteECC enables or disables the ignoreECC function dring rebuild per unit basis Note A value of 1 indicates slowest I O and fastest rebuild rate A value of 5 indicates fastest I O and slowes...

Страница 122: ...ify command allows you to specify times for the verify operation it does not associate the operation with a unit This command allows you to associate a unit with the verify operation This feature only...

Страница 123: ...y quit exits the CLI Type help command to get more details about a particular command help info This command provides specific info related help illustrating various ways to use the info command Info...

Страница 124: ...sages are written to standard error On success 0 is returned On failure 1 is returned To view the return code at the shell command prompt type echo The screen prints either a 0 or a 1 depending on whe...

Отзывы:

Нет отзывов

Бренды по названию

Популярные бренды

Загрузить еще бренды