twedm

Section: Misc. Reference Manual Pages (8)
Updated: 2 October 2004
Index Return to Main Contents
 

NAME

twedm - 3ware RAID controller CLI  

SYNOPSIS

twedm [-bdhvy] [[-c command] ...] device  

DESCRIPTION

twedm allows the user to control a 3ware 7000/8000 series RAID controller. To configure and inspect arrays, trigger rebuilds, etc.

The command-line options are as follows:

-c cmd
Run command cmd as if run interactively. -c may be specified multiple times.

Those commands will be executed serially, except for long-running commands, such as array rebuilds and initializations, which run in the background once started. Also see the -y option.

-d
Log extra information for debugging purposes.
-h
Print usage information.
-v
Print version information.
-y
In non-interactive mode (-c option), answer 'y' ("yes") to all prompts. For example, when prompted for 'y/n' to the confirmation of the command 'unit detach N', the reply will automatically be 'y'. The default is to answer 'n'.

 

TOP LEVEL COMMANDS

drive attach P [CBOD]
Attach drive on port P as a spare (by default) or as a CBOD member. Also see the rescan command.
drive detach P
Detach drive on port P so that the drive may then be removed. If the drive is part of a unit, that unit will become degraded or non-functional if the unit is not redundant or if it is already degraded and can not have more than one sub-unit missing.
drive rescan [P]
Re-scan empty drive ports for present but un-attach drives, i.e. drives that were attached after boot. A particular port P may be specified. New drives will be attached with no associated unit.
exit
Quit.
help
Display help text for a given command. For example: help show OR help show drives
reset
Perform a soft reset of the controller.
set rebuildrate R
Set the controller rebuild (process) rate. R is in the range 1 to 5, 1 being faster rebuild rate and slower I/O and 5 being faster I/O and slower rebuild rate. Slower rebuild rates are better for rebuilding to (or from) border-line drives.
show alarms
Display AENs (Asynchronous Event Notifications).
show drives [verbose]
Display information about the attached drives.
show controller [verbose]
Display information about the controller.
show settings [(cache | rebuildrate)]
Display the controller rebuild-rate and/or unit cache settings. Also see unit cache.
show units
Display information about the currently attached units.
unit attach U [U ...]
Attach unit(s) U to the O/S.
unit cache U (on | off)
Enable or disable unit U's cache. Unit cache does not apply to spare, JBOD, or raid0 units.
unit create <type> [<stripe size>] <port> [<port> ...]
Create an unit of type RAID0, RAID1, RAID10, RAID5, or JBOD using drives on the controller ports port. If type is not RAID5 or JBOD, then the stripe size may be specified following the type as 4k, 8k, 16k, 32k, or 64k. RAID5 is always 64k. The new unit number will be that of the lowest port number used, or lowest unused unit number if that is in use.

Unit initialization for raid1, 5, and 10 is not started automatically after initialization. To start the initialization, execute a unit verify for the new unit.

unit delete U
Delete unit U. This destroys the unit, UNRECOVERABLE!
unit detach U [U ...]
Detach unit(s) U from the O/S. If unit U is mounted by the operating system, this WILL cause problems, thus this requires confirmation.
unit flush N
Flush unit N's cache.
unit replace U S P
Replace sub-unit S of unit U with the drive on port P.
unit rebuild (U | pause | resume)
Start a rebuild of unit U or pause or resume the currently running rebuild. Missing sub-units have to be replaced before a rebuild can be started.
unit rescan [P]
Re-scan populated drive ports which do not have a unit association for unit information. If all the sub-units are not present, the unit will be imcomplete or degraded. A particular port P may be specified. New units will be attached with the port number as their unit number, else the lowest unused unit number.

unit rescan will not re-attach spare units.

unit verify U [stop]
Start a verify of unit U or stop the verify running on unit U.

 

EXAMPLES

To create a RAID 10 unit: choose the pairs of drives, issue the unit create command, followed by an unit verify to start the initialization, and finally attach the unit to the O/S. 
twedm> unit create raid10 2 3 4 5 6 7
twedm> show drives
        Port  0: Missing
        Port  1: Missing
        Port  2: Present        WDC WD1200JB-00FUA0 
                                WD-WCAES1021821
                                unit  2 (sub-unit  0)
        Port  3: Present        WDC WD1200JB-00FUA0 
                                WD-WCAES1020691
                                unit  2 (sub-unit  0)
        Port  4: Present        WDC WD1200JB-00FUA0 
                                WD-WCAES1015931
                                unit  2 (sub-unit  1)
        Port  5: Present        WDC WD1200JB-00FUA0 
                                WD-WCAES1021661
                                unit  2 (sub-unit  1)
        Port  6: Present        WDC WD1200JB-00FUA0 
                                WD-WCAES1021531
                                unit  2 (sub-unit  2)
        Port  7: Present        WDC WD1200JB-00FUA0 
                                WD-WCAES1012321
                                unit  2 (sub-unit  2)
twedm> show units verbose
        1 units
        Unit  2: Online, Normal
                 RAID10, 64k stripe
                 3 sub-units
                 703318800 blocks
                 sub-unit 0:
                         sub-sub-unit 0: port 2
                         sub-sub-unit 1: port 3
                 sub-unit 1:
                         sub-sub-unit 0: port 4
                         sub-sub-unit 1: port 5
                 sub-unit 2:
                         sub-sub-unit 0: port 6
                         sub-sub-unit 1: port 7
twedm> unit verify 2
twedm> show units
        1 units
        Unit  2: Online, Initializing (0%)
                 RAID10, 64k stripe
                 3 sub-units
                 703318800 blocks
twedm> unit attach 2
ld0 at twe0 unit 2: 64K stripe RAID10, status: Initializing
ld0: 335 GB, 43779 cyl, 255 head, 63 sec, 512 bytes/sect x 703318800 sectors
 

EXIT STATUS

In non-interactive mode (-c option), twedm exits with a non-zero status upon internal, controller, or input error.  

FILES

$HOME/.twedm.history
twedm command history file.

 

TERMINOLOGOY

3ware and the controller driver generally refer to an array of any type including JBOD and spare as a "unit" comprising some number of "sub-units". However, a drive is also referred to as a unit and sub-unit.  

AUTHOR

John Heasley, NTT/Verio.

This package is free software which you are welcome to redistribute under certain conditions and comes with ABSOLUTELY NO WARRANTY; for details see the COPYING file that came with the distribution.

This product includes software developed by (or for) the NetBSD Foundation, Inc. and its contributors.  

BUGS

Probably!

 

Index

NAME
SYNOPSIS
DESCRIPTION
TOP LEVEL COMMANDS
EXAMPLES
EXIT STATUS
FILES
TERMINOLOGOY
AUTHOR
BUGS
This document was created by man2html, using the manual pages.
Time: 16:44:12 GMT, February 10, 2023