NAME

rdacutil - redundant disk array controller management utility

SYNOPSIS

rdacutil -i <raid module specifier>

rdacutil -m <mode> [-b] <raid module specifier>
rdacutil -f <raid controller specifier>
rdacutil -u <raid controller specifier>
rdacutil -U <raid controller specifier>

DESCRIPTION

rdacutil is a very basic redundant controller management utility having the ability to retrieve information about the redundant controller configuration, set controller modes, balance LUNs between controllers, and fail a particular controller in a module.

OPTIONS

-b

Valid only in conjunction with "-m 2"; instructs rdacutil to establish a "nominal" LUN load balancing.

-f

Fail the indicated controller; the operand <raid controller specifier> may be either an RM6 module-relative controller name(e.g., "RAID Module 01.a") or an operating system device name(e.g., "c0t5d0s0") referring to a controller or one of the LUNs currently attached to the controller.

-i

Display information about the redundant controller configuration for a RAID module, including controller mode (non-redundant, active/passive, active/failed, or dual-active) and LUN distribution. The operand <raid module specifier> may be either an RM6 module name(e.g., "RAID Module 01") or an operating system device name(e.g., "c0t5d2s0") referring to a controller or logical unit within the module.

Examples ilustration the format of the displayed infomation:

RAID Module 01: dual-active

active controller a (c1t5d0s0) units: 0 1 2 3

passive controller b (c2t5d0s0) units: none

RAID Module 02: single-controller

active controller a (c3t4d0s0) units: 0 1 2 3 4 5

RAID Module 03: active/passive

active controller a (c2t2d0s0) units: 0 1 2 3

failed controller b (c1t1d0s0) units: none

-m

Set the mode of the controllers in the RAID module, where <mode> is 1 for active/passive and 2 for dual-active. The operand <raid module specifier> is the same as for the "-i" option. On a transition from mode 2 to mode 1, the first controller (controller "a") will become active. If the RAID module is already in mode 1 when "-m 1" is specified, the controller roles will be swapped.

-u

Restore (unfail) a failed controller in a module; rdacutil unfails whichever controller is failed. The operand <raid controller specifier> is the same as for the "-f" option.

-U

Restore (unfail) a failed controller in a module unconditionally; rdacutil unfails the alternate to the controller that the command is issued to. The operand <raid controller specifier> is the same as for the "-f" option. This option should be used when the RAID Module is connected to different hosts.

EXIT CODES

0 - Error-free termination

1 - Error termination (event log will contain error)

NOTES

When using the -u or -U options and you are using the cXtXdXs0 device argument form, the device you specify must be the operational controller in the module.

Invoking rdacutil with no arguments or with an unrecognized function key letter will cause usage information to be displayed.

You must enclose the entire module specifier/controller specifier in double quotation marks, if it contains spaces.

EXAMPLES

1. rdacutil -m 2 "RAID Module 01"

   Put "RAID Module 01" in mode 2.

2. rdacutil -m 2 -b "RAID Module 01"

   Put "RAID Module 01" in mode 2 and balance LUNs.

3. rdacutil -f "RAID Module 01.a"

   Fail controller "a"(the first controller) in "RAID Module 01".

4. rdacutil -u c1t5d0s0

   Restore the failed controller which is the alternate controller of c1t5d0s0.

SEE ALSO

arraymon(1M), lad(1M), nvutil(1M), parityck(1M), raidutil(1M), rdac(7), rdaemon(1M), rdriver(4), rm6(1M), rmevent(4), rmparams(4), rmscript(1M)