Diff for /wikisrc/guide/raidframe.mdwn between versions 1.12 and 1.13

version 1.12, 2013/04/29 16:45:04 version 1.13, 2015/06/19 19:18:31
Line 12  NetBSD uses the [CMU RAIDframe](http://w Line 12  NetBSD uses the [CMU RAIDframe](http://w
 its RAID subsystem. NetBSD is the primary platform for RAIDframe development.  its RAID subsystem. NetBSD is the primary platform for RAIDframe development.
 RAIDframe can also be found in older versions of FreeBSD and OpenBSD. NetBSD  RAIDframe can also be found in older versions of FreeBSD and OpenBSD. NetBSD
 also has another way of bundling disks, the  also has another way of bundling disks, the
 [ccd(4)](http://netbsd.gw.com/cgi-bin/man-cgi?ccd+4+NetBSD-5.0.1+i386) subsystem  [[!template id=man name="ccd" section="4"]] subsystem
 (see [Concatenated Disk Device](/guide/ccd)). You should possess some [basic  (see [Concatenated Disk Device](/guide/ccd)). You should possess some [basic
 knowledge](http://www.acnc.com/04_00.html) about RAID concepts and terminology  knowledge](http://www.acnc.com/04_00.html) about RAID concepts and terminology
 before continuing. You should also be at least familiar with the different  before continuing. You should also be at least familiar with the different
 levels of RAID - Adaptec provides an [excellent  levels of RAID - Adaptec provides an [excellent
 reference](http://www.adaptec.com/en-US/_common/compatibility/_education/RAID_level_compar_wp.htm),  reference](http://www.adaptec.com/en-US/_common/compatibility/_education/RAID_level_compar_wp.htm),
 and the [raid(4)](http://netbsd.gw.com/cgi-bin/man-cgi?raid+4+NetBSD-5.0.1+i386)  and the [[!template id=man name="raid" section="4"]]
 manpage contains a short overview too.  manpage contains a short overview too.
   
 ### A warning about Data Integrity, Backups, and High Availability  ### A warning about Data Integrity, Backups, and High Availability
Line 64  If you encounter problems using RAIDfram Line 64  If you encounter problems using RAIDfram
 obtaining help.  obtaining help.
   
  1. Read the RAIDframe man pages:   1. Read the RAIDframe man pages:
     [raid(4)](http://netbsd.gw.com/cgi-bin/man-cgi?raid+4+NetBSD-5.0.1+i386) and      [[!template id=man name="raid" section="4"]] and
     [raidctl(8)](http://netbsd.gw.com/cgi-bin/man-cgi?raidctl+8+NetBSD-5.0.1+i386)      [[!template id=man name="raidctl" section="8"]]
     thoroughly.      thoroughly.
   
  2. Search the mailing list archives. Unfortunately, there is no NetBSD list   2. Search the mailing list archives. Unfortunately, there is no NetBSD list
Line 86  obtaining help. Line 86  obtaining help.
  4. If your problem persists: Post to the mailing list most appropriate   4. If your problem persists: Post to the mailing list most appropriate
     (judgment call). Collect as much verbosely detailed information as possible      (judgment call). Collect as much verbosely detailed information as possible
     before posting: Include your      before posting: Include your
     [dmesg(8)](http://netbsd.gw.com/cgi-bin/man-cgi?dmesg+8+NetBSD-5.0.1+i386)      [[!template id=man name="dmesg" section="8"]]
     output from `/var/run/dmesg.boot`, your kernel      output from `/var/run/dmesg.boot`, your kernel
     [config(5)](http://netbsd.gw.com/cgi-bin/man-cgi?config+5+NetBSD-5.0.1+i386) ,      [[!template id=man name="config" section="5"]] ,
     your `/etc/raid[0-9].conf`, any relevant errors on `/dev/console`,      your `/etc/raid[0-9].conf`, any relevant errors on `/dev/console`,
     `/var/log/messages`, or to `stdout/stderr` of      `/var/log/messages`, or to `stdout/stderr` of
     [raidctl(8)](http://netbsd.gw.com/cgi-bin/man-cgi?raidctl+8+NetBSD-5.0.1+i386).      [[!template id=man name="raidctl" section="8"]].
     The output of **raidctl -s** (if available) will be useful as well. Also      The output of **raidctl -s** (if available) will be useful as well. Also
     include details on the troubleshooting steps you've taken thus far, exactly      include details on the troubleshooting steps you've taken thus far, exactly
     when the problem started, and any notes on recent changes that may have      when the problem started, and any notes on recent changes that may have
Line 113  options: Line 113  options:
   
 The RAID support must be detected by the NetBSD kernel, which can be checked by  The RAID support must be detected by the NetBSD kernel, which can be checked by
 looking at the output of the  looking at the output of the
 [dmesg(8)](http://netbsd.gw.com/cgi-bin/man-cgi?dmesg+8+NetBSD-5.0.1+i386)  [[!template id=man name="dmesg" section="8"]]
 command.  command.
   
     # dmesg|grep -i raid      # dmesg|grep -i raid
Line 136  redundant power, this will improve drive Line 136  redundant power, this will improve drive
 redundant power, the write cache could endanger the integrity of RAID data in  redundant power, the write cache could endanger the integrity of RAID data in
 the event of a power loss.  the event of a power loss.
   
 The [dkctl(8)](http://netbsd.gw.com/cgi-bin/man-cgi?dkctl+8+NetBSD-5.0.1+i386)  The [[!template id=man name="dkctl" section="8"]]
 utility to can be used for this on all kinds of disks that support the operation  utility to can be used for this on all kinds of disks that support the operation
 (SCSI, EIDE, SATA, ...):  (SCSI, EIDE, SATA, ...):
   
Line 285  the entire disk for NetBSD`, answer `yes Line 285  the entire disk for NetBSD`, answer `yes
  * [NetBSD/sparc64 Install](http://ftp.NetBSD.org/pub/NetBSD/NetBSD-5.0.2/sparc64/INSTALL.html)   * [NetBSD/sparc64 Install](http://ftp.NetBSD.org/pub/NetBSD/NetBSD-5.0.2/sparc64/INSTALL.html)
   
 Once the installation is complete, you should examine the  Once the installation is complete, you should examine the
 [disklabel(8)](http://netbsd.gw.com/cgi-bin/man-cgi?disklabel+8+NetBSD-5.0.1+i386)  [[!template id=man name="disklabel" section="8"]]
 and [fdisk(8)](http://netbsd.gw.com/cgi-bin/man-cgi?fdisk+8+NetBSD-5.0.1+i386) /  and [[!template id=man name="fdisk" section="8"]] /
 [sunlabel(8)](http://netbsd.gw.com/cgi-bin/man-cgi?sunlabel+8+NetBSD-5.0.1+i386)  [[!template id=man name="sunlabel" section="8"]]
 outputs on the system:  outputs on the system:
   
     # df      # df
Line 364  On Sparc64 the command and output differ Line 364  On Sparc64 the command and output differ
 Once you have a stock install of NetBSD on Disk0/wd0, you are ready to begin.  Once you have a stock install of NetBSD on Disk0/wd0, you are ready to begin.
 Disk1/wd1 will be visible and unused by the system. To setup Disk1/wd1, you will  Disk1/wd1 will be visible and unused by the system. To setup Disk1/wd1, you will
 use  use
 [disklabel(8)](http://netbsd.gw.com/cgi-bin/man-cgi?disklabel+8+NetBSD-5.0.1+i386)  [[!template id=man name="disklabel" section="8"]]
 to allocate the entire second disk to the RAID-1 set.  to allocate the entire second disk to the RAID-1 set.
   
 *Tip*:  *Tip*:
 > The best way to ensure that Disk1/wd1 is completely empty is to 'zero'  > The best way to ensure that Disk1/wd1 is completely empty is to 'zero'
 > out the first few sectors of the disk with  > out the first few sectors of the disk with
 > [dd(1)](http://netbsd.gw.com/cgi-bin/man-cgi?dd+1+NetBSD-5.0.1+i386) . This will  > [[!template id=man name="dd" section="1"]] . This will
 > erase the MBR (i386) or Sun disk label (sparc64), as well as the NetBSD disk  > erase the MBR (i386) or Sun disk label (sparc64), as well as the NetBSD disk
 > label. If you make a mistake at any point during the RAID setup process, you can  > label. If you make a mistake at any point during the RAID setup process, you can
 > always refer to this process to restore the disk to an empty state.  > always refer to this process to restore the disk to an empty state.
Line 434  the MBR on the second disk using the val Line 434  the MBR on the second disk using the val
 must remember to mark the NetBSD partition active or the system will not boot.  must remember to mark the NetBSD partition active or the system will not boot.
 You must also create a NetBSD disklabel on Disk1/wd1 that will enable a RAID  You must also create a NetBSD disklabel on Disk1/wd1 that will enable a RAID
 volume to exist upon it. On sparc64, you will need to simply  volume to exist upon it. On sparc64, you will need to simply
 [disklabel(8)](http://netbsd.gw.com/cgi-bin/man-cgi?disklabel+8+NetBSD-5.0.1+i386)  [[!template id=man name="disklabel" section="8"]]
 the second disk which will write the proper Sun Disk Label.  the second disk which will write the proper Sun Disk Label.
   
 *Tip*:  *Tip*:
 [disklabel(8)](http://netbsd.gw.com/cgi-bin/man-cgi?disklabel+8+NetBSD-5.0.1+i386)  [[!template id=man name="disklabel" section="8"]]
 will use your shell' s environment variable `$EDITOR` variable to edit the  will use your shell' s environment variable `$EDITOR` variable to edit the
 disklabel. The default is  disklabel. The default is
 [vi(1)](http://netbsd.gw.com/cgi-bin/man-cgi?vi+1+NetBSD-5.0.1+i386)  [[!template id=man name="vi" section="1"]]
   
 On i386:  On i386:
   
Line 705  Next, format the newly created `/` parti Line 705  Next, format the newly created `/` parti
   
 The new RAID filesystems are now ready for use. We mount them under `/mnt` and  The new RAID filesystems are now ready for use. We mount them under `/mnt` and
 copy all files from the old system. This can be done using  copy all files from the old system. This can be done using
 [dump(8)](http://netbsd.gw.com/cgi-bin/man-cgi?dump+8+NetBSD-5.0.1+i386) or  [[!template id=man name="dump" section="8"]] or
 [pax(1)](http://netbsd.gw.com/cgi-bin/man-cgi?pax+1+NetBSD-5.0.1+i386).  [[!template id=man name="pax" section="1"]].
   
     # mount /dev/raid0a /mnt      # mount /dev/raid0a /mnt
     # df -h /mnt      # df -h /mnt
Line 740  from which disk the system is booting. Line 740  from which disk the system is booting.
   
 *Caution*: Although it may seem logical to install the 1st stage boot block into  *Caution*: Although it may seem logical to install the 1st stage boot block into
 `/dev/rwd1{c,d}` (which is historically correct with NetBSD 1.6.x  `/dev/rwd1{c,d}` (which is historically correct with NetBSD 1.6.x
 [installboot(8)](http://netbsd.gw.com/cgi-bin/man-cgi?installboot+8+NetBSD-5.0.1+i386)  [[!template id=man name="installboot" section="8"]]
 , this is no longer the case. If you make this mistake, the boot sector will  , this is no longer the case. If you make this mistake, the boot sector will
 become irrecoverably damaged and you will need to start the process over again.  become irrecoverably damaged and you will need to start the process over again.
   
Line 780  rebooted. After the reboot everything is Line 780  rebooted. After the reboot everything is
     # shutdown -r now      # shutdown -r now
   
 *Warning*: Always use  *Warning*: Always use
 [shutdown(8)](http://netbsd.gw.com/cgi-bin/man-cgi?shutdown+8+NetBSD-5.0.1+i386)  [[!template id=man name="shutdown" section="8"]]
 when shutting down. Never simply use  when shutting down. Never simply use
 [reboot(8)](http://netbsd.gw.com/cgi-bin/man-cgi?reboot+8+NetBSD-5.0.1+i386).  [[!template id=man name="reboot" section="8"]].
 [reboot(8)](http://netbsd.gw.com/cgi-bin/man-cgi?reboot+8+NetBSD-5.0.1+i386)  [[!template id=man name="reboot" section="8"]]
 will not properly run shutdown RC scripts and will not safely disable swap. This  will not properly run shutdown RC scripts and will not safely disable swap. This
 will cause dirty parity at every reboot.  will cause dirty parity at every reboot.
   
Line 846  effectively bringing Disk0/wd0 into the  Line 846  effectively bringing Disk0/wd0 into the 
     # disklabel -R -r wd0 /tmp/disklabel.wd1      # disklabel -R -r wd0 /tmp/disklabel.wd1
   
 As a last-minute sanity check, you might want to use  As a last-minute sanity check, you might want to use
 [diff(1)](http://netbsd.gw.com/cgi-bin/man-cgi?diff+1+NetBSD-5.0.1+i386) to  [[!template id=man name="diff" section="1"]] to
 ensure that the disklabels of Disk0/wd0 match Disk1/wd1. You should also backup  ensure that the disklabels of Disk0/wd0 match Disk1/wd1. You should also backup
 these files for reference in the event of an emergency.  these files for reference in the event of an emergency.
   
Line 1020  And the second disk: Line 1020  And the second disk:
     [...snip...]      [...snip...]
   
 At each boot, the following should appear in the NetBSD kernel  At each boot, the following should appear in the NetBSD kernel
 [dmesg(8)](http://netbsd.gw.com/cgi-bin/man-cgi?dmesg+8+NetBSD-5.0.1+i386) :  [[!template id=man name="dmesg" section="8"]] :
   
     Kernelized RAIDframe activated      Kernelized RAIDframe activated
     raid0: RAID Level 1      raid0: RAID Level 1

Removed from v.1.12  
changed lines
  Added in v.1.13


CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb