Introduction The Command Line Interface (CLI) for Linux is provided to ™ manage 7000 and 8000 series 3ware Escalade ATA RAID con- trollers. Multiple systems containing Escalade controllers may be managed using the CLI via a command line or script. CLI is use- ful in environments were a graphical user interface (GUI) is not available.
Features Features The 3ware CLI provides the basic functionality of the 3ware Disk ® Management (3DM ) utility through a Command Line Interface. You can view array status and version information, and perform maintenance functions like adding or removing drives.
The installation location needs to be in the envi- ronment path for root to execute the CLI without using complete paths (i.e., if installed to / , you can usr/sbin/ type tw_cli on the command line, otherwise you will have to type the complete path: /home/user/tw_cli www.3ware.com...
The main prompt is displayed when the program is awaiting a com- mand. Escalade CLI> 2) Single command with output tw_cli <command line arguments> CLI run command Description: This command doesn’t invoke the main CLI prompt if used with com- mand line arguments. Syntax: tw_cli <command line arguments> www.3ware.com...
3ware Escalade ATA RAID Controller CLI User Guide Example: tw_cli info c0 u0 3) Multiple commands through an input file tw_cli -f <filename> CLI run command Description: This method executes a specific filename, where the filename is the name of a text file containing a list of CLI commands which the user types in advance.
Page 9
- provides the status of drives on the controller model - provides drive manufacturer model number serial - provides drive serial number capacity - provides drive capacity smart - provides SMART data in hex format for drive troubleshoot- Syntax: info [c<c>[u<u>|p<p>]] www.3ware.com...
3ware Escalade ATA RAID Controller CLI User Guide Note: • f c is not specified, information for all controllers is dis- played, including a brief description of each • f only c is specified, information about the cth controller is provided in detail.
Page 11
(40000464 blocks): OK (unit 3) Port 4: Maxtor 98196H8 V80HRGRC 81.96 GB (160086528 blocks): OK (unit 4) Port 5: Maxtor 98196H8 V80HRGFC 81.96 GB (160086528 blocks): OK (unit 4) Port 6: DRIVE NOT PRESENT Port 7: DRIVE NOT PRESENT www.3ware.com...
Page 12
3ware Escalade ATA RAID Controller CLI User Guide info for specific unit on a controller Example: Escalade CLI> info c0 u0 Sample of output: Controller 0, Unit 0 -------------------- Status: REBUILDING (54%) Unit type: RAID 5 Size: 60.3 GB (117262592 blocks)
Page 13
BC 00 00 00 00 00 09 32 00 F6 F6 F4 69 00 00 00 00 00 0A 2B 00 FD FC 00 00 00 00 00 00 00 0B 2B Note: The SMART data is displayed in hex format. www.3ware.com...
Page 14
3ware Escalade ATA RAID Controller CLI User Guide unitstatus Description: To get a general status of the units of a controller. Example: Escalade CLI> info c0 unitstatus Sample of output: # of units: 1 Unit 0: RAID 0 163.92 GB (320168960 blocks): OK Example: Escalade CLI>...
5 indicates fastest I/O and slowest rebuild. Interim values scale linearly (e.g., a value of 3 indicates a rebuild rate half as fast as a rebuild of 1 Syntax: set [ rebuild c<c> <1..5> | cache c<c> u<u> [on|off] www.3ware.com...
3ware Escalade ATA RAID Controller CLI User Guide Examples using Interactive Mode Description: Using the set command without the rebuild or cache options displays the current configuration, as shown below: Example: Escalade CLI> set Sample of output: Controller 1 =======================================...
• add - adds a drive. The new drive can be specified as a hot spare or as a new JBOD after it is physically connected to the control- ler. If not specified, it is added as a CBOD; a configurable JBOD which can be used to rebuild a degraded array. www.3ware.com...
3ware Escalade ATA RAID Controller CLI User Guide • remove - removes a drive from a port. After this is done, a drive can safely be removed from the controller. • rebuild - rebuilds a degraded array. Specify a unit number on a controller you want to rebuild, along with the port number of an available disk drive.
Page 19
Escalade CLI> maint rebuild c0 u2 p3 Sample of output: Rebuild started on unit 2 on controller 0 failed maint rebuild Description: To rebuild a degraded array unit 2 (u2) on controller 0, with a disk drive that is attched to port 3. www.3ware.com...
Page 20
3ware Escalade ATA RAID Controller CLI User Guide Example: Escalade CLI> maint rebuild c0 u2 p3 Sample of output: Replace command failed, cannot start rebuild (108) a degraded RAID 10 array maint rebuild Description: To rebuild a degraded array, unit 2 (u2) on controller 0, with a disk drive that is attached to port 3.
Page 22
3ware Escalade ATA RAID Controller CLI User Guide Type help <command> to get more details about a particular command -------------------------- Example: Escalade CLI> help info Sample of output: info [c<c>[u<u>|p<p>]] - If c is not specified, it will show all the...
Page 23
Sample of output: maint [ add c<c> p<p> [JBOD|SPARE] | remove c<c> p<p> | rebuild c<c> u<u> [s<s>] p<p> [ignoreECC]| flush c<c> [u<u>] verify c<c> u<u> Examples: maint add c0 p5 // Add a CBOD to port 5 on controller 0 www.3ware.com...
Page 24
3ware Escalade ATA RAID Controller CLI User Guide maint add c0 p4 spare // Add a Spare drive to port 4 on controller 0 maint remove c2 p5 // Removes drive 5 on controller 2 maint rebuild Rebuild unit4 on controller 1 with a newly...
For specific answers to questions or to give feedback about the product, visit our Web site at http://www.3ware.com/sup- port and use our convenient e-mail form. 3ware also offers toll-free (877) 883-9273 and (650) 327-8600 direct phone support during normal business hours.
Page 26
3ware Escalade ATA RAID Controller CLI User Guide www.3ware.com...
Need help?
Do you have a question about the 720-0087-00 and is the answer not in the manual?
Questions and answers