man page(1) manual page

NAME

raid - raid configuration control commands

The raid command supports modification of disk devices in the RAID configuration. The raid command supports 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 will return completion status when an operation has completed.

FAServer 1400 systems support a "hot swap" capability which allows removal or addition of disks to the system with minimal interruption to file system activity. The raid swap command is issued prior to physically removing or adding a disk from a FAServer 1400 system to stall I/O activity, once the disk is removed or added, file system activity will automatically continue. If the raid swap command is accidentally typed or you choose not to swap a disk at this time, the raid unswap command can be issued to cancel the swap operation and continue NFS service.

USAGE

add disk_id will add 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 output once the addition has completed.

swap: will stall all I/O on systems which 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 which 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.

unswap: will undo a raid swap command, cancel the swap operation and continue NFS service.

remove disk_id
will remove 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 which 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 which support hot swap, once the disk has been spun down (and the fault "ready for removal" light is on), the raid swap command can be issued to allow physical removal of the disk from the system.

fail disk_id will fail 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 which support hot swap, once the disk has been spun down (and the fault "ready for removal" light is on), the raid swap command can be issued to allow physical removal of the disk from the system.

scrub start|stop
will start or stop 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.

EXAMPLES

The following example uses raid to add spare disk number 4 to the RAID configuration. Note that we first use the sysconfig command to display the current RAID configuration and verify that disk_id 4 is a spare disk:

  toaster> sysconfig -r
  RAID Disk                  DISK_ID#    HA.SCSI#Used (MB/blks)Phys (MB/blks)
  ---------                  --------    ---------------------------
  parity                     0           0.02000/4096002040/4177920
  data 1                     1           0.12000/4096002049/4196352
  data 2                     2           0.21000/2048001033/2115584
  data 3                     3           0.31000/2048001033/2115584
  spare          4           0.4         1000/2048001033/2115584

  toaster> raid add 4
  Addition of disk 4 to the filesystem has been initiated.
  You will be notified when addition is complete.
  toaster>
  Wed Jun 01 00:39:24 GMT [raid_disk_admin]: Addition of disk 4
  to the filesystem has completed successfully.

The next example uses raid remove to remove spare disk number 3 from the RAID configuration and then the raid swap to stall I/O to allow physical removal of the disk from the system:

  toaster> raid remove 3
  Removal and unload of spare disk 3 has been initiated.
  You will be notified when unload is complete.
  toaster>
  Wed Jun 01  22:10:12 GMT 1994 [raid_disk_admin]: Unload of disk
  3 has completed successfully.

  toaster> raid swap
  System has been prepared for a disk swap.  NFS service will continue
  when a disk is removed or added to the system.

  Use the "raid unswap" command to continue NFS service if this
  command was accidentally typed or you choose not to swap a disk
  at this time.

The following messages are seen when the disk is physically removed from the system, confirming a disk hot swap event has occurred and that during the drive unit search no new disk units were found:

  toaster>
  Wed Jun 01 22:10:42 GMT [disk_config_admin]: *** NOTICE ***
          A disk has been swapped (removed or added) to a modular
          storage shelf.  The system will wait 15 seconds and
          then check the status of all disk drives.
  Wed Jun 01 22:10:57 GMT [disk_config_admin]: *** NOTICE ***
          Disk unit status check has completed.

NAME

SYNOPSIS

DESCRIPTION

USAGE

EXAMPLES

SEE ALSO