raidctl(1M) System Administration Commands raidctl(1M)
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 controllers that include RAID support. The utility
also updates firmware/fcode/BIOS for both RAID and non-RAID controllers.
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 (for on board)
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 (for on board)
Delete the RAID volume specified as disk1.
Specify disk1 in canonical form, for example, c0t0d0.
-f (for HBA)
Force an update. Do not prompt.
-F filename controller (for HBA)
Update the firmware running on the specified controller (controller).
-l [controller ...] (for on board)
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 |
+-----------------------------+-----------------------------+
SEE ALSO
attributes(5)
System Administration Guide: Basic Administration
SunOS 5.10 17 Aug 2004 raidctl(1M)