background image

Chapter 2. Primary CLI Syntax Reference

52

3ware 9000 Series Serial ATA Controller CLI Guide

Example:

 

//localhost> /c0 set autorebuild=enable

Setting Auto-Rebuild Policy on /c0 to enable ... Done.

/cx start mediascan

This command applies only to 7000/8000 controllers. For 9000 series 
controllers, use the verify command.

This command provides media scrubbing for validating the functionality of a 
disk, including bad block detection, remapping, and so forth. The command 
starts a media scan operation on the specified controller

 /cx

/cx stop mediascan

This command applies only to 7000/8000 controllers. 

This commands stops a media scan operation on the specified controller 

/cx

(Media scans are started using

 /cx start mediascan

.)

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

Страница 1: ...3ware Serial ATA RAID Controller Command Line Interface Supports the 9000 Series 9500S and 9550SX PN 720 0127 02 November 2005 CLI Guide...

Страница 2: ...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 AMCC All ot...

Страница 3: ...I 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 Refe...

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

Страница 5: ...7 cx px show 67 cx px show attribute attribute 67 cx px show status 67 cx px show model 68 cx px show serial 68 cx px show firmware 68 cx px show identify 68 cx px show ncq 68 cx px show lspeed 69 cx...

Страница 6: ...cid numdrives 90 info cid unitstatus 90 info cid allunitstatus 90 info cid drivestatus 91 info cid exportjbod 91 info cid ondegrade 91 info cid spinup 91 info cid stagger 92 info cid uid 92 info cid...

Страница 7: ...tduration 106 sched verify cid remove slot_id 107 sched verify cid enable 107 sched verify cid disable 107 sched selftest cid 107 sched selftest cid add dday hhour 108 sched selftest cid remove slot_i...

Страница 8: ...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: ...y Logical Units Usually shortened to units These are block devices presented to operating systems A logical unit can be a one tier two tier or three tier arrangement JBOD Spare and Single logical unit...

Страница 13: ...ese 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 is located on the 3...

Страница 14: ...o available in nroff and html formats These are located in packages cli tw_cli 8 html or tw_cli 8 nroff You will need to be root or have root privileges to install the CLI to usr sbin and to run the C...

Страница 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: ...You can set the desired level of data protection versus performance for a unit by specifying the StorSave Profile to be used Three profiles are provided Protection maximum data protection Performance...

Страница 25: ...od of time up to 72 hours in the event of a power failure Write Journaling Write journaling tracks the writing of data to disk and preserves a copy of data that has not yet been written to the disk me...

Страница 26: ...you must enable the write cache manually using 3DM2 3BM or the CLI The write cache will not automatically reenable when the unit is rebuilt The Protection profile enables this feature so that write c...

Страница 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 62 Delete a unit cx ux del 57 Remove a unit export cx ux export 57 Name a unit cx ux set name 61 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 40 rescan This command sends a rescan command to all 3ware controllers in the system For more information see cx rescan noscan on page 39 commit This co...

Страница 36: ...y 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 only name st...

Страница 37: ...f the condition no longer exists Cmpl reports the percent completion of REBUILDING VERIFYING INITIALIZING or MIGRATING units The Port summary section lists all present ports and specifies the port num...

Страница 38: ...eries driver drivestatus exportjbod 9000 series firmware memory model monitor numdrives numports numunits ondegrade 9500S pcb pchip qpolicy serial spinup 9000 series stagger 9000 series and unitstatus...

Страница 39: ...al number of the specified controller cx Example localhost c0 show serial c0 Serial Number F12705A3240009 cx show pcb This command reports the PCB Printed Circuit Board version of the specified contro...

Страница 40: ...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 show smart on page 69 for...

Страница 41: ...icy cx show autocarve This feature only applies to 9000 series controllers This command reports the Auto Carve policy If the policy is on all newly created or migrated units larger than the carvesize...

Страница 42: ...9500S controllers ship with 128 MBytes of cache yet only 112MB shows as memory installed The other 16 MB is reserved for use by the controller Example localhost c0 show memory c0 Memory Installed 112M...

Страница 43: ...e Status Cmpl Stripe Size GB Cache AVerify IgnECC u0 RAID 5 OK 64K 223 485 OFF OFF ON u1 JBOD OK 76 3352 OFF OFF u2 RAID 0 OK 64K 148 99 ON ON cx show allunitstatus This command presents a count of to...

Страница 44: ...Version 3 xx c0 Number of Ports 12 c0 Number of Units 2 c0 Number of Drives 12 c0 Total Optimal Units 2 c0 NotOptimalUnits 0 c0 Total Units 2 c0 JBOD Export Policy off c0 Disk Spinup Policy 7 c0 Spinu...

Страница 45: ...ique 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 disk p p consists of a l...

Страница 46: ...or 10 disks the default 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 pro...

Страница 47: ...In order to use reserved characters etc put double quotes around the name string The name can be changed after the unit has been created For more information see cx ux set name string on page 61 and...

Страница 48: ...r the specified controller cx show alarms reverse Asynchronous events also referred to as AENs or alarms are originated by firmware and captured by their respective device drivers These events reflect...

Страница 49: ...ort 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 tw_cli c0 show diag dia...

Страница 50: ...rebuild is needed and a 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 t...

Страница 51: ...5 INIT PAUSED 0 64K 521 466 ON OFF OFF Port Status Unit Size Blocks Serial p0 NOT PRESENT p1 OK u0 76 33 GB 160086528 Y2NXL7FE p2 NOT PRESENT p3 OK u0 76 33 GB 160086528 Y2NXLB9E p4 NOT PRESENT p5 OK...

Страница 52: ...that came with your 3ware RAID controller The show verify command displays the current verify background task schedule as illustrated below localhost c1 show verify Verify Schedule for Controller c1 S...

Страница 53: ...ler to check certain SMART supported thresholds by the disk vendor An AEN is logged to the alarms page if a drive reports a SMART failure The show selftest command displays the current selftest backgr...

Страница 54: ...to also disable the schedule Otherwise the applicable background task will never occur cx add verify ddd hh duration This command adds a new background verify task to be executed on the day ddd where...

Страница 55: ...Fri and Sat at hour hh range 0 23 Notice that selftest runs to completion and as such no duration is provided A maximum of seven selftest tasks can be scheduled This command will fail if no empty task...

Страница 56: ...e schedule Otherwise the verify background task will never occur cx del selftest slot_id This command removes or unregisters the selftest background task in slot slot_id Example localhost c1 del selft...

Страница 57: ...1 implies fastest verify and 5 implies fastest I O Enabling and disabling verify is only for 9000 models however the verify rate 1 5 applies to all controllers Note When enabling the verify schedule y...

Страница 58: ...ault is 1 This policy is used to stagger spinups of disks at boot time in order to spread the power consumption on the power supply For example given a spinup policy of 2 the controller will spin up t...

Страница 59: ...Size on c0 to 2000 GB Done cx set autorebuild on off This command is only for 9550SX controllers This command turns the Auto Rebuild policy on or off By default autorebuild is on If the policy is on...

Страница 60: ...rs For 9000 series controllers use the verify command This command provides media scrubbing for validating the functionality of a disk including bad block detection remapping and so forth The command...

Страница 61: ...ld 7000 8000 only cx ux resume rebuild 7000 8000 only cx ux stop verify cx ux flush 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...

Страница 62: ...sted Specifying an invalid attribute will terminate the loop Possible attributes are initializestatus rebuildstatus status and verifystatus cx ux show status This command reports the status of the spe...

Страница 63: ...he specified unit Examples localhost c0 u5 show name c0 u5 name Joe cx ux show serial This feature only applies to 9000 series controllers This command reports the unique serial number of the specifie...

Страница 64: ...f the auto carve policy was on at the time the unit was created and the unit is over 2TB the number of multiple volumes will be displayed Example localhost c0 u1 show all c0 u1 status OK c0 u1 is not...

Страница 65: ...swap carriers are required to do this while the system is online Otherwise you must power down the system to prevent system hangs and damage cx ux del noscan quiet This command allows you to delete a...

Страница 66: ...dd new drives or to retry the original drive If you are rebuilding a RAID 50 or RAID 10 unit multiple drives can be specified if more than one sub array is degraded When you issue this command the spe...

Страница 67: ...s to achieve similar functionality with use of Linux provided schedulers such as cron 8 or at 1 or user supplied programs cx ux stop verify This command stops a background verification process on the...

Страница 68: ...ontroller model and logical unit type N A Not Applicable refers to cases where the given logical unit type is not supported on a particular controller model The quiet attribute turns off interactive m...

Страница 69: ...controllers This command sets the storsave policy to be either protect balance or perform when the unit write cache is enabled The default setting is protect The storsave policy adjusts several facto...

Страница 70: ...l be ignored For additional information see Setting the StorSave Profile for a Unit in the 3ware 9550SX Serial ATA RAID Controller User Guide Example localhost c0 u5 set storsave protect Setting Comma...

Страница 71: ...ore capacity as the existing one A four drive RAID 5 unit can migrate to a four drive RAID 0 but a four drive RAID 0 unit cannot migrate to a four drive RAID 5 without adding another drive due to the...

Страница 72: ...ouping varies based on number of disks For 6 and 9 disks default grouping is 3 For 8 disks the default grouping is 4 For 10 disks the default grouping is 5 and for 12 disks the default grouping is 4 I...

Страница 73: ...g this time Once the migration is finished a reboot will be required if you are booted from the unit For secondary storage depending on your operating system you may need to first unmount the unit the...

Страница 74: ...IGRATING 0 74 4951 ON OFF OFF Port Status Unit Size Blocks Serial p0 OK u0 74 53 GB 156301488 3JV2Q1VA p1 OK u0 232 83 GB 488281250 WD WMAEH15764 p2 OK u0 232 83 GB 488281250 WD WMAEH17004 p3 OK u0 23...

Страница 75: ...d 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 u0 149 05 GB 312581808...

Страница 76: ...he specified port Example localhost c0 p5 show firmware c0 p5 Firmware Version 65 13G65 cx px show identify This command applies only to 9550SX model controllers that have chassis control hardware enc...

Страница 77: ...the drive attached to the specified port in two formats GB and blocks Note that of this version the GB format is computed based on division by 1000 not 1024 Example localhost c0 p5 show capacity 149...

Страница 78: ...Speed Supported 1 5 Gb s c0 p0 SATA Link Speed 1 5 Gb s c0 p0 NCQ Supported No c0 p0 NCQ Enabled No c0 p0 Belongs to Unit u1 c0 p0 Drive Smart Data 0A 00 01 0F 00 3D 33 25 8C BA 03 00 00 00 03 03 00 6...

Страница 79: ...controllers This command sets the LED status of the port to on or off If identify is set to on the firmware activates the setting of the corresponding LED of the port on the controller and causes it t...

Страница 80: ...bbu enable 9000 only cx bbu disable 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 Temp Ho...

Страница 81: ...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...

Страница 82: ...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...

Страница 83: ...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...

Страница 84: ...a question mark 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 She...

Страница 85: ...only cx set selftest enable disable task UDMA SMART 9000 only cx set autorebuild on off 9550SX only cx flush cx commit Windows only Also known as shutdown cx start mediascan 7000 8000 only cx stop med...

Страница 86: ...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...

Страница 87: ...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...

Страница 88: ...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...

Страница 89: ...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...

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

Страница 91: ...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 96 Warning Operations under the maint co...

Страница 92: ...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...

Страница 93: ...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...

Страница 94: ...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...

Страница 95: ...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...

Страница 96: ...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...

Страница 97: ...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...

Страница 98: ...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...

Страница 99: ...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...

Страница 100: ...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...

Страница 101: ...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...

Страница 102: ...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 86 Example localhost info c0 p5 capacity c0...

Страница 103: ...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...

Страница 104: ...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...

Страница 105: ...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...

Страница 106: ...tem 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 Singl...

Страница 107: ...types and 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 s...

Страница 108: ...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 is to avoid OS creating...

Страница 109: ...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...

Страница 110: ...ing for validating the operationality of a disk including bad block detection and remapping The start or stop operations start or stop media scan operation on the specified controller For the 9000 ser...

Страница 111: ...the process by instructing the controller to finish pending requests and clear the DCBs in transaction flag as the disk is going down Note that block devices cooked devices do not require this command...

Страница 112: ...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...

Страница 113: ...ur range 0 23 for a duration of duration range 1 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...

Страница 114: ...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...

Страница 115: ...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 cid uid on off on page 112 sched verify cid disab...

Страница 116: ...l order Also the selftests are completed almost 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 se...

Страница 117: ...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...

Страница 118: ...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...

Страница 119: ...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...

Страница 120: ...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...

Страница 121: ...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...

Страница 122: ...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...

Отзывы: