User Tools

Site Tools


Step One: installing FreeBSD

  • Boot up on the FreeBSD Current 7.0 CD
  • Choose Country and Locale
  • Go Custom install
  • Partition fdisk with Auto option (one slice, whole disk)
  • Disklabel with options
        A: 1024Mb   UFS2  /
        B: swap
        D: rest of disk
  • To create D you’ll need to enter any mount point you want and then use the M option to clear it. This ensures that it will not mount or be created as a file system.
  • Distribution choose Minimal install
  • Media Select CD/DVD

System will install to the small 1024MB UFS root partition you created.

Step Two: creating the ZFS pool

  • Once installation is complete, remove CD and reboot into our new FreeBSD system.
  • Boot into FreeBSD partition and select “4” for single user mode.
  • Hit ENTER to accept /bin/sh shell.
# mount -w / 

Now create a Disk pool using the D label we prepared during the install. In this example we have a SATA disk at ad4.

# zpool create tank /dev/ad4s1d

Firstly stop ZFS from creating default mountpoints for shares

 zfs set mountpoint=none tank

Create some extra/common mountpoints

zfs set checksum=fletcher4 tank
zfs create -o compression=on -o exec=on -o setuid=off tank/tmp
zfs create tank/root
zfs create tank/usr
zfs create tank/home
zfs create -o compression=lzjb -o setuid=off tank/usr/ports
zfs create -o compression=off -o exec=off -o setuid=off tank/usr/ports/distfiles
zfs create -o compression=off -o exec=off -o setuid=off tank/usr/ports/packages
zfs create -o compression=lzjb -o exec=off -o setuid=off tank/usr/src
zfs create tank/var
zfs create -o compression=lzjb -o exec=off -o setuid=off tank/var/crash
zfs create -o exec=off -o setuid=off tank/var/db
zfs create -o compression=lzjb -o exec=on -o setuid=off tank/var/db/pkg
zfs create -o exec=off -o setuid=off tank/var/empty
zfs create -o compression=lzjb -o exec=off -o setuid=off tank/var/log
zfs create -o compression=gzip -o exec=off -o setuid=off tank/var/mail
zfs create -o exec=off -o setuid=off tank/var/run
zfs create -o compression=lzjb -o exec=on -o setuid=off tank/var/tmp
zfs create -o compression=gzip -o exec=off -o setuid=off tank/var/vmail

Now set the mountpoints of the shares

zfs set mountpoint=/tank tank/root
zfs set mountpoint=/tank/usr tank/usr
zfs set mountpoint=/tank/var tank/var
zfs set mountpoint=/tank/tmp tank/tmp
chmod 1777 /tank/tmp
chmod 1777 /tank/var/tmp

Edit /etc/rc.conf and enable ZFS

# echo 'zfs_enable="YES"' >> /etc/rc.conf

Now copy the UFS bootable slice to the ZFS mountpoint. This gives us a workable FreeBSD installation under ZFS.

# find -x / | cpio -pmd /tank 

Step Three: solving the ZFS boot problem

The problem which remains is that FreeBSD will not be able to boot directly into ZFS since the bootloader doesn’t know anything about ZFS. So a little trick is that we put the kernel onto /boot which lives on the UFS partition. This gets the system running to the point where ZFS can be mounted and the rest of the boot proceeds.

Remove the /tank/boot just copied over from the UFS system:

# rm -rf /tank/boot

Now make the directory in which our UFS partition will be mounted. This will be useful later on when we want to update the contents of that slice from a running system. We also need to make sure that when the ZFS is booting up it can see the UFS bootdir.

mkdir /tank/bootdir
cd /tank
ln -s bootdir/boot boot

Now we tell the loader on the UFS slice to load and boot from the contents of the ZFS volume:

echo 'zfs_load="YES"' >>  /boot/loader.conf
echo 'vfs.root.mountfrom="zfs:tank/root"'  >>  /boot/loader.conf

Edit /tank/etc/fstab so our UFS slice is mounted in the right location for when ZFS boots.

/dev/ad4s1a  /bootdir        ufs     rw      1       1

When we reboot in a minute, we want the ZFS tank to mount in /var /usr /tmp and/ and not within the /tank location it is now. So set the true mountpoints:

zfs set mountpoint=/tmp tank/tmp
zfs set mountpoint=/usr tank/usr
zfs set mountpoint=/var tank/var

Set root mount point to ‘legacy’ so ZFS won’t try to mount it automatically. It should already have been mounted by the loader:

cd /
zfs set mountpoint=legacy tank/root
zfs set readonly=on tank/var/empty

All Done!

zfs create tank/mysql
zfs set atime=off tank/mysql
zfs set mountpoint=/var/db/mysql tank/mysql

zfs create tank/mysql/ibdata
zfs set recordsize=16k tank/mysql/ibdata

zfs create tank/mysql/iblogs
zfs set recordsize=128k tank/mysql/iblogs

Глобально выключаем atime для всех файлов MySQL, указываем различные размеры блоков записи для файлов данных и журналов innodb.За размещение файлов данных и логов в нужном месте будут отвечать следующие директивы файла my.cnf:

fdisk -bB /dev/ad6

All Done!

Reboot and login as root. df -h and zfs list and you will see everything.

# df -h
Filesystem          Size     Used     Avail Capacity  Mounted on
tank/root           282G     454M     281G      0%    /
devfs               1.0K     1.0K     0B      100%    /dev
/dev/ad4s1a         496M     317M     139M     69%    /bootdir
tank/tmp            281G     1.1M     281G      0%    /tmp
tank/usr            287G     5.7G     281G      2%    /usr
tank/var            281G      76M     281G      0%    /var
# zfs list
tank       6.27G  281G     454M    none
tank/root  16.2M  51.3G  16.2M  legacy
tank/tmp   1.10M  281G     1.10M    /tmp
tank/usr    5.75G  281G     5.75G    /usr
tank/var   75.5M  281G     75.5M    /var

All is done. :) Basic install completed. At this point you might want to install a more complete version of FreeBSD, install the ports system or anything else you normally do.

Creating a Mirror

That was pretty exciting.

Now let’s say that we have some important data on that drive and we are pretty keen not to lose it. So, let’s add another drive as a mirror under ZFS. In some ways this is even superior to a hardware RAID setup since ZFS is able to monitor the checksums on the disk and automatically detect which of the two drives has corrupted a block of data, transparently using the other and repairing if necessary.

  • Install the HDD and boot up on the system.
  • Login as root
  • Run sysinstall
  • Enter Custom Install
  • Partition fdisk with Auto option (one slice, who disk) and press ‘w’ to write changes
  • Label with options
        A: 1024Mb   / (you must press M and remove the mount point as you have done previously)
        B: swap
        D: rest of disk empty (for zfs later) 
    and once again, press ‘w’ to save changes and state ‘YES’ to the question it asks you about applying now. You’ll need to make this identical to the labels on the first drive.
  * Exit sysinstall.

Check out what we have:

#zpool status

Add the 2nd drive to our mirror (our second drive comes up as ad6)

# zpool attach tank ad4s1d ad6s1d
# zpool status

and it will now show the two HDD’s in a mirror

pool: tank

state: ONLINE scrub: none requested


      tank        ONLINE       0     0     0
        mirror    ONLINE       0     0     0
          ad4s1d  ONLINE       0     0     0
          ad6s1d  ONLINE       0     0     0

errors: No known data errors

Now we have a mirror, but if we lose the first drive we will need the contents of the UFS slice copied to the second drive in order to reboot.

 newfs /dev/ad6s1a
 mkdir /mnt/bootdir
 mount /dev/ad6s1a /mnt/bootdir
 find -x /bootdir | cpio -pmd /mnt

This gives us another ready to use system on the 2nd HDD in case we have a failure on the 1st HDD with all the necessary zfs tools to move forward. We also need to stop fsck occurring during the boot process for the bootdir so if the first HDD fails (ad4) the system will continue to boot without issue. This means the bootup completes as follows: The first HDD (AD4) is not present in the system, the BIOS will hand over to the MBR on the 2nd HDD (AD6) this will load all the zfs modules and the system will complete its bootup as normal. For this to always function you NEED to make sure the /bootdir/zfs/zpool.cache file is the same on both HDDs.

Edit /etc/fstab so our UFS slice is mounted in the right location for when ZFS boots.

/dev/ad4s1a  /bootdir             ufs     rw      1       0
/dev/ad6s1a  /mnt/bootdir   ufs      rw      1       0

The /bootdir is only needed for when you make changes to your zfs pools, etc

/boot/Loader.conf tweaks

As you know, ZFS within Freebsd is and Experimental system and there are still some bugs to iron out. In particular, it is easy for ZFS to run out of memory and crash the kernel. It helps to place the following in /boot/loader.conf (and if you completed the above make sure you change /mnt/bootdir/boot/loader.conf as well).


The amount for the kmem size is up to you but if you make it too large (something around 1500M) you will kernel panic on boot up. Tuning memory usage for ZFS appears to be an art rather than a science right now, but some useful tips exist.

Disaster recovery

(Maybe necessary if you have just completed the before mentioned tweaks and rebooted)

With the way we have setup our system if the ZFS fails to boot or function for whatever reason we can still boot off the original minimal install at any time. To do this do the following:

  • Boot up
  • Choose #6 (Escape to Loader Prompt) at the boot menu.
  • Suppress the mounting of the ZFS volumes like this and disable the zfs module:
      # unset vfs.root.mountfrom
      # disable-module zfs
  • Suppress of kmem sizes
      # unset vm.kmem_size
      # unset vm.kmem_size_max
  • Single user mode and boot
      # set boot_single
      # boot
  • Login

and edit the /boot/loader.conf as necessary

# df -h
# zpool list

You will notice that it has not picked up the ZFS drives or the pool. Never fear we can import it!

#zpool import -d /boot/zfs

This loads the zpool data so the libraries can find the information it needs, now we need to import our pool using an alternate root.

#zpool import -f -R /tank tank

And check out that it has worked.

# df -h
# zpool list

Useful Commands

Show available pool/resources

#zfs list

Show Status of Disk/pool

#zpool status

Changing Mount points for created resources

#zfs set mountpoint=/<mountpoint> <pool resources>

Data Limiting

# zfs set quota=10g testpool/testfs/dir1

(logically limits space)

# zfs set reservation=20g testpool/testfs/dir2

(logically preallocates space)

Unloading a kernel and choosing another one (in the boot loader mode)

# unload kernel
# boot /boot/kernel.old/kernel

Trouble shooting

To see ZFS debug messages on the console you can add vfs.zfs.debug=1 in the /boot/loader.conf

shitbox/zfs.txt · Last modified: 2010/10/21 12:20 by slayer