Manual Pages
Table of Contents
raid - raid configuration control commands
raid swap
raid unswap
raid add disk_id
raid remove disk_id
raid fail disk_id
raid scrub on | off
The raid family of commands supports modification of disk
devices in the RAID configuration, including removal of
spare disks, addition of new file system member disks and
forced failure of file system disks from a RAID configuration.
All commands report status messages when the operation
is initiated and return completion status when an
operation has completed.
The filer's ``hot swap'' capability allows removal or addition
of disks to the system with minimal interruption to
file system activity. Before you physically remove or add a
disk, use the raid swap command to stall I/O activity. Once
you've removed or added the disk, file system activity will
automatically continue. If you should type the raid swap
command accidentally, or you choose not to swap a disk at
this time, use the raid unswap to cancel the swap operation
and continue service.
Before you swap or remove a disk, it's a good idea to run
syconfig -r to verify which disks are where.
raid add disk_id
adds the specified spare disk to the
existing RAID configuration for use by
the file system. The disk_id specified
should be a spare disk in the current
configuration. Use sysconfig -r to
check for the existence of spare disks.
For systems that support hot swap, a
spare disk may be swapped into the system
by using raid swap at any time and
then added to the file system using the
raid add command. For systems without
hot swap support, a spare drive in the
existing configuration can be used and
added to the file system. Note that in
both cases, the disk will be zeroed
before being added to the file system
and a completion status message will be
displayed once the addition has completed.
- raid swap
- stalls all I/O on systems that support
hot swap to allow a disk to be physically
added or removed from a disk
shelf. Typically, this command would be
used to allow removal of a failed disk
or a spare or filesystem disk that was
prepared for removal using the raid
remove or raid fail commands, respectively.
Once a disk is physically added
or removed from a disk shelf, system I/O
will automatically continue. NOTE: it is
important to only issue the raid swap
command when you have a disk drive that
you want to physically remove or add to
a disk shelf because all I/O will stall
until a disk is added or removed from
the shelf.
- raid unswap
- undoes a raid swap command, cancels the
swap operation and continues service.
raid remove disk_id removes the specified spare disk from
the RAID configuration, spinning the
disk down when removal is complete. raid
remove is useful to allow removal of a
spare disk for use in another filer system
(as a replacement for a failed disk
or to expand file system space). For
systems that do not support "hot swap",
the spare disk is spun down and the system
could, for example, be quickly
halted, the disk removed and the system
rebooted and the spare moved to another
system for use. For systems that support
hot swap, once the disk has been spun
down (and the ``ready for removal''
fault light is on), the raid swap command
can be issued to allow physical
removal of the disk from the system.
raid fail disk_id disables the specified file system disk
from the RAID configuration, spinning
the disk down when removal is complete.
raid fail is useful to allow removal of
a file system disk that may be logging
excessive errors and requires replacement.
Note that when a file system disk
has been removed in this manner, the
RAID configuration will enter degraded
mode (meaning a disk is missing from the
array). For systems that support hot
swap, once the disk has been spun down
(and the ``ready for removal'' fault
light is on), the raid swap command can
be issued to allow physical removal of
the disk from the system.
raid scrub start | stop
starts or stops a RAID scrubbing operation.
raid scrub start starts the
scrubbing process and raid scrub stop
stops the scrubbing process. The
raid.scrub.enable option is ignored.
na_sysconfig(1)
Table of Contents