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