Difference between revisions of "ZFS Installation"

From ArchWiki
Jump to: navigation, search
m (A little script to build these automatically)
Line 3: Line 3:
{{Article summary text|This article provides several options for the installation of the requisite ZFS software packages.}}
{{Article summary text|This article provides several options for the installation of the requisite ZFS software packages.}}
{{Article summary heading|Related}}
{{Article summary heading|Related}}
{{Article summary wiki|ZFS}}
{{Article summary wiki|ZFS}} - Main article on ZFS.
{{Article summary wiki|Installing Arch Linux on ZFS}}
{{Article summary wiki|Playing with ZFS}} - Learn ZFS by playing with a zpool made from virtual disks.
{{Article summary wiki|ZFS on FUSE}}
{{Article summary wiki|Installing Arch Linux on ZFS}} - Describes install Arch onto a ZFS root.
{{Article summary wiki|Playing with ZFS}}
{{Article summary wiki|ZFS on FUSE}} - ZFS via FUSE.
{{Article summary end}}
{{Article summary end}}

Revision as of 20:58, 22 October 2013

Template:Article summary start Template:Article summary text Template:Article summary heading Template:Article summary wiki - Main article on ZFS. Template:Article summary wiki - Learn ZFS by playing with a zpool made from virtual disks. Template:Article summary wiki - Describes install Arch onto a ZFS root. Template:Article summary wiki - ZFS via FUSE. Template:Article summary end

Building from AUR

The ZFS kernel module are related utils are available in the AUR; all are required:

Note: The ZFS and SPL (Solaris Porting Layer is a Linux kernel module which provides many of the Solaris kernel APIs) kernel modules are tied to a specific kernel version. It would not be possible to apply any kernel updates until updated packages are uploaded to AUR or the archzfs repository.

Should you wish to update the core/linux package before the AUR/zfs and AUR/spl packages' dependency lists are updated, a possible work-around is to remove (uninstall) spl and zfs packages (the respective modules and file system may stay in-use), update the core/linux package, build + install zfs and spl packages - just do not forget to edit PKGBUILD and correct the core/linux version number in "depends" section to match the updated version). Finally, the system may be rebooted. [ This is only for the situation, when ZFS is not used for root filesystem. ]

A little script to build these automatically

The build order of the above is important due to nested dependencies. One can automate the entire process, including downloading the packages with the following shell script. The only requirements for it to work are:

  • sudo - Note that your user needed sudo rights to /usr/bin/clean-chroot-manager for the script below to work.
  • rsync - Needed for moving over the build files.
  • cowerAUR - Needed to grab sources from the AUR.
  • clean-chroot-managerAUR - Needed to build in a clean chroot and add packages to a local repo.

Be sure to add the local repo to /etc/pacman.conf like so:

$ tail /etc/pacman.conf
SigLevel = Optional TrustAll
Server = file:///path/to/localrepo/defined/below
# ZFS Builder by graysky

# define the temp space for building here

# create this dir and chown it to your user
# this is the local repo which will store your zfs packages

# Add the following entry to /etc/pacman.conf for the local repo
#SigLevel = Optional TrustAll
#Server = file:///path/to/localrepo/defined/above

for i in rsync cower clean-chroot-manager; do
  command -v $i >/dev/null 2>&1 || {
  echo "I require $i but it's not installed. Aborting." >&2
  exit 1; }

[[ -f ~/.config/clean-chroot-manager.conf ]] &&
  . ~/.config/clean-chroot-manager.conf || exit 1

[[ ! -d "$REPO" ]] &&
  echo "Make the dir for your local repo and chown it: $REPO" && exit 1

[[ ! -d "$WORK" ]] &&
  echo "Make a work directory: $WORK" && exit 1

cd "$WORK"
for i in spl-utils spl zfs-utils zfs; do
  [[ -d $i ]] && rm -rf $i
  cower -d $i

for i in spl-utils spl zfs-utils zfs; do
  cd "$WORK/$i"
  sudo ccm s

rsync -auvxP "$CHROOTPATH/root/repo/" "$REPO"

Unofficial Repository

For fast and effortless installation and updates, the "archzfs" signed repository is available to add to your pacman.conf:

Server = http://demizerone.com/$repo/$arch

The repository and packages are signed with the maintainer's PGP key which is verifiable here: http://demizerone.com. This key is not trusted by any of the Arch Linux master keys, so it will need to be locally signed before use. See pacman-key.

Add the maintainer's key,

# pacman-key -r 0EE7A126

and locally sign to add it to the system's trust database,

# pacman-key --lsign-key 0EE7A126

Once the key has been signed, it is now possible to update the package database,

# pacman -Syyu

and install ZFS packages:

# pacman -S archzfs

Archiso Tracking Repository

ZFS can easily be used from within the archiso live environment by using the special archiso tracking repository for ZFS. This repository makes it easy to install Arch Linux on a root ZFS filesystem, or to mount ZFS pools from within an archiso live environment using an up-to-date live medium. To use this repository from the live environment, add the following server line to pacman.conf:

Server = http://demizerone.com/$repo/$arch

This repository and packages are also signed, so the key must be locally signed following the steps listed in the previous section before use. For a guide on how to install Arch Linux on to a root ZFS filesystem, see Installing Arch Linux on ZFS.