NAME

raidutil - RAID Manager Configuration Utility

SYNOPSIS

raidutil -c device [ -s LUN size ] [ -D delete LUN ]

                [ -l RAID level ] [ -z segment size ]
                [ -r reconstruction rate ]
                [ -n LUN number to create ] [ -g drive group ]
                [ -q suppress print output during execution ]
                [ -x segment 0 size ]
                [ -p cache read ahead enable ]
                [ -h create hot spare ] [ -H delete hot spare ]
                [ -i display Inquiry information ]
                [ -w cache enable ] [ -m cache mirroring enable ]
                [ -v volatile caching allowed ]
                [ -V view Page 08 (caching page) ]
                [ -f multiplication factor ]
                [ -t Disable pre-fetch transfer length ]
                [ -k minimum pre-fetch ]
                [ -b maximum pre-fetch ceiling ]

DESCRIPTION

Use raidutil to perform initial configuration of the disk array when installing a disk array on a system. You can also use it to reconfigure the disk array whenever reconfiguration is required (e.g., addition of more disk drives, redefinition of LUNs, RAID levels, etc.).

OPTIONS

-c

Specify the device name, the disk array controller to configure (eg: -c c1t0d0s0, -c drive1, etc).

-D

Delete LUN

With no number (-D all) = delete all LUNs.

With number (-D 1,2) = delete specific LUNs.

-H

Delete hot spare

With no number (-H all) = delete all hot spares.

With number (-H 50,51) = delete specific hot spares where the first number is the channel and the second number is the drive side SCSI ID of each drive. Use commas to separate drives.

-g

Specify drive group (-g 11,21,31,41,51) where the first number is the channel and the second number is the drive side SCSI ID of each drive. Use commas to separate drives.

-h

Create hot spare (-h 50,51) where the first number is the channel and the second number is the drive side SCSI ID of each drive. Use commas to separate drives.

-i

Display inquiry information including the software and firware revision level and date.

-l

Specify RAID level.

-m

Cache mirror option

-m on 0,1 -m off 2,3 would mean cache mirroring is enabled for LUNs 0 and 1, and is disabled for LUNs 2 and 3 (CME - page 2e).

-n

Specify the number of the LUN to be created.

-p

Cache read ahead

-p enable 0,1 -p disable 2,3 would mean that cache read ahead is enabled for LUNs 0 and 1, and is disabled for LUNs 2 and 3 (RCD - page 08). Also see associated parameters -f, -t, -k and -b.

-q

Suppress printing messages during raidutil execution. This is useful when running raidutil from a shell script. For this option to fully suppress all output, it must be the first parameter on the command line.

-r

Specify reconstruction rate (combines delay interval and blocks per delay interval).

-r slow = slow

-r medslow = medium slow

-r med = medium

-r medfast = medium fast

-r fast = fast

-s

Specify LUN size to be created in megabytes.

(eg: -s 1000 would create a 1 gigabyte LUN)

-v

Volatile cache option

-v on 0,1 -v off 2,3 means volatile caching is enabled for LUNs 0 and 1 and is disabled for LUNs 2 and 3 (CWOB - page 2e).

-w

Write cache option

-w on 0,1 -w off 2,3 means write cache is enabled for LUNs 0 and 1 and is disabled for LUNs 2 and 3

(WCE - page 08).

-x

Specify segment 0 size in blocks.

-z

Specify segment size in blocks.

-f

Specify the multiplication factor (0 or 1) followed by the LUN numbers separated by commas.

-t

Disable Pre-fetch Transfer Length value (0 to 0xffff) followed by the LUN numbers separated by commas.

-k

Minimum Pre-fetch value (0 to 0xffff) followed by the LUN numbers separated by commas.

-b

Maximum Pre-fetch Ceiling value (0 to 0xffff) followed by the LUN numbers separated by commas.

-V

Print the values in the Caching mode page (08). -V 0 would display page 08 of LUN 0 for the device given by the -c parameter.

EXIT CODES

0 - Error-free termination

1 - Error termination (event log will contain error)

NOTES

In some cases, raidutil will require exclusive ownership of the hardware modules affected by the operations being performed, meaning, for example, that a logical unit of the array could not be accessed as a filesystem at the same time that its configuration was being fundamentally altered. raidutil does try to be as liberal as possible in terms of permitting those configuration actions that can be performed safely without exclusive ownership. If the program cannot acquire exclusive ownership when needed, it displays an appropriate notice and terminates.

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

EXAMPLE

The following command line entry

raidutil -c c1t3d0s0 -D all -n 0 -l 5 -s 1000 -g 11,21,31,41,51

would delete all existing LUN's, then would create a 5 drive, RAID 5, 1 GB, LUN number 0 on the device c1t3d0s0.

SEE ALSO

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