RAID0, Software, How to setup

The following is a practical guide to setting up software RAID0 on FreeBSD using the GEOM subsystem. This may appear to be written as an aide-memoir however it is a real-working example written by the author actually configuring a real system.

The system is intended to be a file server using Samba.

The Hardware

The system comprises of the following hardware:

• Processor: AMD Athlon XP 3000;
• Motherboard: ASUS KT4AV;
• Memory: 512MB;
• Storage:
  • Hard Drive: Maxtor 30GB IDE (for Operating System);
  • Hard Drive: Seagate 500GB SATA x2 (for RAID0 file share);
  • Hard Drive Controller: Promise PDC20375 SATA150
• Case: basic full-ATX sized;
• PSU: Antec ATX (with SATA power connections).

The Primise SATA controller is capable of RAID0 and RAID1 however it is being used as a simple hard drive controller for the two SATA Seagate drives since the motherboard has no SATA ports. The RAID0 is provided by the FreeBSD software-based solution documented within this article.

The Software

This guide wouldn't be here unless it involved FreeBSD! It is intended that the system will be a file server for media files using Samba to not only share the files but also to offer WINS for name resolution on a small LAN.

Configuring RAID0

The following steps are based on a working implementation however it should be broad enough to cover most instances and be used as a guide to others wishing to implement RAID0.

You will need to su or otherwise become root user to execute these steps.

On FreeBSD the RAID0 "driver" is provided by the GEOM subsystem and is referred to as disk striping. The driver is available as a loadable kernel module called 'geom_striping'. In order to use this driver the following needs adding into the '/boot/loader.conf' file.

geom_stripe_load="YES"

That entry is needed to ensure the driver is available upon rebooting. So rebooting will initiate this driver however running the following command avoids a reboot at this stage.

kldload geom_stripe

There needs to be a mount point on which this RAID drive will mount to. Because this RAID drive is intended to be used with Samba it will be called '/smb' and created as follows.

mkdir /smb

In order to establish the RAID0 drive the underlying drives need to be determined. The following command will highlight the drives that the kernel detected when booting up.

dmesg | grep -e "ad[0-9]:" 

This command uses grep with a regexp expression to find all IDE (including SATA) that begin with 'ad' and numbered between zero and nine, as in ad0, ad1, etc. For SCSI drives use 'da' instead.

Executing this on the system noted above shows.

ad0: 29325MB <Maxtor 6E030L0 NAR61590> at ata0-master UDMA133
ad4: 476940MB <Seagate ST3500630AS 3.AAK> at ata2-master SATA150
ad6: 476940MB <Seagate ST3500630AS 3.AAK> at ata3-master SATA150

This reveals that the drives intended for use as part of the RAID0 setup, those being the Seagate drives, have been allocated 'ad4' and 'ad6'. The operating system drive, the Maxtor, is allocated 'ad0'.

To create the RAID0 drive using the two drives determined above the gstripe command is used as follows.

gstripe label -v st0 /dev/ad4 /dev/ad6  

This creates a RAID0 drive called 'st0', which becomes a virtual device in much the same way as the physical drives were found under 'ad4' and 'ad6'. The use of '-v' instructs the 'gstripe' command to be more verbose ("wordy") which shows the following.

Metadata value stored on /dev/ad4.
Metadata value stored on /dev/ad6.
Done.

Running the 'dmesg' command will reveal more details of what has been actioned.

GEOM_STRIPE: Device st0 created (id=2925520033).
GEOM_STRIPE: Disk ad4 attached to st0.
GEOM_STRIPE: Disk ad6 attached to st0.
GEOM_STRIPE: Device st0 activated.

The new RAID0 drive is located under '/dev/stripe/st0'.

Before FreeBSD can utilise a drive, wither it is a regular single drive or a creation of RAID, it must be initialised and marked as an available drive. This is done by writing a marker to the drive. Under FreeBSD this is done by using the 'bsdlabel' command.

bsdlabel -w /dev/stripe/st0

This simply writes to the new virtual device that hosts the RAID0 drive enabling FreeBSD to reference it as an available drive. As a result of this command executing the virtual device shows a single slice (or "partition" under Microsoft speak) under '/dev/stripe/st0a'.

To allow data to be written to the RAID0 drive it must be formatted. FreeBSD has a native file system called UFS2 but is also capable of reading and writing to file systems of other operating systems. These foreign file systems include Microsoft's variations of the FAT system (called 'MSDOS' on FreeBSD). Since Samba will be running locally on this system the file system will be the native UFS2 and is created using the following command.

newfs -U /dev/stripe/st0

The "-U" instructs newfs to enable soft updates on the file system as it is formatted. The command will fill the screen with output similar to the following.

/dev/stripe/st0a: 953880.0MB (1953546304 sectors) block size 16384, fragment size 2048
        using 5191 cylinder groups of 183.77MB, 11761 blks, 23552 inodes.
        with soft updates
super-block backups (for fsck -b #) at:
 160, 376512, 752864, 1129216, 1505568, 1881920, 2258272, 2634624, 3010976, 3387328, 3763680, 4140032, 4516384, 4892736, 5269088, 5645440, 6021792, 6398144, 6774496, 7150848, 7527200, 7903552, 8279904, 8656256, 9032608, 9408960, 9785312, 10161664, 10538016, 10914368, 11290720, 11667072, 12043424, 12419776, 12796128, 13172480, 13548832, 13925184, 14301536, 14677888, 15054240, 15430592, 15806944, 16183296, 16559648, 16936000, 17312352, 17688704, 18065056, 18441408, 18817760, 19194112, 19570464, 19946816, 20323168, 20699520, 21075872, 21452224, 21828576, 22204928, 22581280, 22957632, 23333984, 23710336, 24086688, 24463040, 24839392, 25215744,  25592096, 25968448, 26344800,
:
(and on...)
:
1944610944, 1944987296, 1945363648, 1945740000, 1946116352, 1946492704, 1946869056, 1947245408, 1947621760, 1947998112, 1948374464, 1948750816, 1949127168, 1949503520, 1949879872, 1950256224, 1950632576, 1951008928, 1951385280, 1951761632, 1952137984, 1952514336, 1952890688, 1953267040

The 'newfs' command has many more options available, including one to specify the size of the drive to format meaning it is possible to create more then one 'slice' (again, akin to "partition") on it. Since no such option was specified the entire drive is formatted as one single slice. This resulted in the creation of almost 1TB of storage using the two 500GB drives.

The final stage in which to permit FreeBSD to access this drive, and from there allow Samba to read and write via network file shares, is to actually mount it. In order to do this the RAID0 drive needs adding as a mountable drive to the '/etc/fstab' file. The following example taken from the above system shows, on the last line, the entry required in particular.

# Device                Mountpoint      FStype  Options         Dump    Pass#
/dev/ad0s1b             none            swap    sw              0       0
/dev/ad0s1a             /               ufs     rw              1       1
/dev/ad0s1e             /tmp            ufs     rw              2       2
/dev/ad0s1f             /usr            ufs     rw              2       2
/dev/ad0s1d             /var            ufs     rw              2       2
/dev/acd0               /cdrom          cd9660  ro,noauto       0       0
/dev/stripe/st0a        /smb            ufs     rw              2       2

After a reboot the drive will be mounted as '/smb' however issuing the following command will save a reboot at this stage.

mount /dev/stripe/st0a /smb

This will allow you to use the RAID0 drive much like any other drive on the system. The drive can be verified and the free space determined by using the df command.

df -g /smb

The "-g" shows free space in Gigabytes.