Install

From OpenZFS on OS X
Revision as of 21:22, 12 March 2014 by Ilovezfs (Talk | contribs)

Jump to: navigation, search

(Adapted from an article by ZeroBSD.)

If you have any other implementation of ZFS installed, you must uninstall it and reboot before proceeding further.

We'll need to fetch the latest source from the repository on GitHub and then compile it.

For this, we'll need some prerequisites:


To install Homebrew:

ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"

Paste that at a Terminal prompt.

Once Homebrew is installed, we need a couple of things first:

brew install automake libtool gawk

Create two folders in your home directory.

mkdir ~/Developer
mkdir ~/bin

Add the ~/bin directory to your PATH.

echo 'export PATH=$HOME/bin:$PATH' >> ~/.bash_profile

and update your environment by sourcing your profile.

source ~/.bash_profile

To acquire the sources and build ZFS, we'll need the zfsadm script found here.

cd ~/Developer/
git clone https://gist.github.com/7713854.git zfsadm-repo
cp zfsadm-repo/zfsadm ~/bin/
chmod +x ~/bin/zfsadm

All set. Let's go cloning and building ZFS:

zfsadm

Now let it work. This should take a few minutes depending on the speed of your machine.

Before using ZFS, we need to actually install it.

cd ~/Developer/zfs
sudo make install
cd ~/Developer/spl
sudo make install

Now load the kernel extensions.

cd /System/Library/Extensions
sudo kextload spl.kext
sudo kextload -d spl.kext zfs.kext

You can check if they are loaded with

sudo kextstat | grep lundman

If you get something similar to

0xffffff7f80b52000 0xc000 0xc000 net.lundman.spl (1.0.0) <7 5 4 3 1>
0xffffff800b070a00 0x180 0x180 net.lundman.kernel.dependencies (10.0.0)
0xffffff7f8129a000 0x1f3000 0x1f3000 net.lundman.zfs (1.0.0) <92 91 16 7 5 4 3 1>

You should now add /usr/local/sbin to your PATH. This is where you will find the command binaries (zpool, zfs, zdb, etc.).

echo 'export PATH=$PATH:/usr/local/sbin' >> ~/.bash_profile

and update your environment by sourcing your profile again.

source ~/.bash_profile

Now you can try running

sudo zpool

to see if everything is installed and configured properly.

You can go ahead and create your pools at this point.

When you want to get the latest commits from GitHub, here's a quick overview of things you need to run.

First make sure you have exported all of your pools.

zpool list

For every pool listed, run

zpool export $POOLNAME

in order to prevent a kernel panic when the kexts are unloaded.

Now you should be able to upgrade your ZFS installation safely.

cd ~/Developer
 
cd spl
make clean
cd ..
 
cd zfs
make clean
cd ..
 
zfsadm
 
cd spl
sudo make install
cd ..
 
cd zfs
sudo make install
 
cd /System/Library/Extensions
sudo kextload spl.kext
sudo kextload -d spl.kext zfs.kext

If net.lundman.kernel.dependencies has been updated (quite rare) a reboot would be necessary.