diff options
| author | Manuel Amador (Rudd-O) <[email protected]> | 2011-03-17 15:18:13 -0700 |
|---|---|---|
| committer | Brian Behlendorf <[email protected]> | 2011-03-17 16:52:04 -0700 |
| commit | ae26d0465a234d7b340566287908c78fe24901e1 (patch) | |
| tree | 07c0604ff755e8df99e758559d2c048cd86d75c2 /dracut/README.dracut.markdown | |
| parent | 01c0e61da027925b71c923a2b3896abf458b45a9 (diff) | |
Add dracut support
To simplify the process of using zfs as your root filesystem a
zfs-drucat sub-package has been added. This sub-package adds a zfs
dracut module which allows your initramfs to be rebuilt with zfs
support. The process for doing this is still complicated but there
is clearly interest from the community about getting this working
well and documented. This should help lay some of the groundwork.
Longer term these changes should be pushed in the upstream dracut
package. Once that occurs this subpackage will no longer be
required for new systems, however we may want to conditionally
build this package in the future for systems running older
dracut versions.
Signed-off-by: Brian Behlendorf <[email protected]>
Diffstat (limited to 'dracut/README.dracut.markdown')
| -rw-r--r-- | dracut/README.dracut.markdown | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/dracut/README.dracut.markdown b/dracut/README.dracut.markdown new file mode 100644 index 000000000..8ec28e484 --- /dev/null +++ b/dracut/README.dracut.markdown @@ -0,0 +1,28 @@ +How to setup a zfs root filesystem using dracut +----------------------------------------------- + +1) Install the zfs-dracut package. This package adds a zfs dracut module +to the /usr/share/dracut/modules.d/ directory which allows dracut to +create an initramfs which is zfs aware. + +2) Set the bootfs property for the bootable dataset in the pool. Then set +the dataset mountpoint property to '/'. + + $ zpool set bootfs=pool/dataset + $ zfs set mountpoint=/ pool/dataset + +Alternately, legacy mountpoints can be used by setting the 'root=' option +on the kernel line of your grub.conf/menu.lst configuration file. Then +set the dataset mountpoint property to 'legacy'. + + $ grub.conf/menu.lst: kernel ... root=ZFS=pool/dataset + $ zfs set mountpoint=legacy pool/dataset + +3) To set zfs module options put them in /etc/modprobe.d/zfs.conf file. +The complete list of zfs module options is available by running the +_modinfo zfs_ command. Commonly set options include: zfs_arc_min, +zfs_arc_max, zfs_prefetch_disable, and zfs_vdev_max_pending. + +4) Finally, create your new initramfs by running dracut. + + $ dracut --force /path/to/initramfs kernel_version |