SunOS man pages


sun.com \| docs.sun.com		How To Buy \| My Sun \| Worldwide Sites

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
EXIT STATUS
ATTRIBUTES
SEE ALSO

NAME

raidctl - RAID hardware utility

SYNOPSIS

raidctl -c disk1 disk2

raidctl -d disk1

raidctl [-f] -F filename controller...

raidctl -l [controller...]

DESCRIPTION

The raidctl utility creates, deletes, or displays RAID volumes of the LSI1030 HW Raid controller.

The raidctl utility requires privileges that are controlled by the underlying file-system permissions. Only privileged users can manipulate the RAID system configuration. If a non-privileged user attempts to create or delete a RAID volume, the command fails with EPERM.

Without options, raidctl displays the current RAID configuration on all exisiting controllers.

OPTIONS

The following options are supported:

-c disk1 disk2

Create a mirror using disk1 and disk2. Replace the contents of disk2 with the contents of disk1. Specify disk1 and disk2 in canonical form, for example, c0t0d0.

When you create a a RAID volume, the RAID volume assumes the identity of the first target in the disk pair (disk1). The second target (disk2) disappears from the system. Therefore, the RAID volume appears as one disk.

To have a successful RAID creation, there must not already be a RAID configuration present on the specified controller. Additionally, the secondary disk must not be mounted, as it has all its data erased and replaced with the primary disk's data.

-d disk1

Delete the RAID volume specified as disk1.

Specify disk1 in canonical form, for example, c0t0d0.

-f

Force an update. Do not prompt.

-F filename controller

Update the firmware running on the specified controller (controller).

-l [controller ...]

List the system's RAID configuration. If controller is specified, list RAID configurations for controller.

Output from the -l lists the following information:

RAID Volume: Displays logical RAID volume name.
RAID Status: Displays RAID status as either RESYNCING (disks are syncing), DEGRADED RAID is operating with reduced functionality), OK (operating optimally), or FAILED (non-functional).
RAID Disk: Displays RAID disk name.
Disk Status: Displays disk status as either OK or FAILED.

EXAMPLES

Example 1. Creating the RAID Configuration

The following command creates the RAID configuration:

# raidctl -c c0t0d0 c0t1d0
RAID Volume 'c0t0d0' created

Example 2. Displaying the RAID Configuration

The following command displays the RAID configuration:

# raidctl
RAID      RAID      RAID      Disk      
Volume    Status    Disk      Status    
----------------------------------------
c0t0d0    RESYNCING c0t0d0    OK        
                    c0t1d0    OK

Example 3. Deleting the RAID Configuration

The following command deletes the RAID configuration:

# raidctl -d c0t0d0
RAID Volume 'c0t0d0' deleted

Example 4. Updating Flash Images on the Controller

The following command updates flash images on the controller:

# raidctl -F lsi1030.fw 0
Update flash image on controller 0? (y/N): y
Flash updated successfully

EXIT STATUS

The following exit values are returned:

0: Successful completion.
1: Invalid command line input.
2: Request operation failed.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu