Difference between revisions of "ZFS Installation"

From ArchWiki
Jump to: navigation, search
(Add SigLevel required)
(was merged to ZFS, redirect there (should always be done after merging an entire article))
 
(21 intermediate revisions by 9 users not shown)
Line 1: Line 1:
[[Category:File systems]]
+
#REDIRECT [[ZFS]]
{{Article summary start}}
+
{{Article summary text|This article provides several options for the installation of the requisite ZFS software packages.}}
+
{{Article summary heading|Related}}
+
{{Article summary wiki|ZFS}} - Main article on ZFS.
+
{{Article summary wiki|Playing with ZFS}} - Learn ZFS by playing with a zpool made from virtual disks.
+
{{Article summary wiki|Installing Arch Linux on ZFS}} - Describes install Arch onto a ZFS root.
+
{{Article summary wiki|ZFS on FUSE}} - ZFS via FUSE.
+
{{Article summary end}}
+
 
+
==Building from AUR==
+
The ZFS kernel module are related utils are available in the [[AUR]]; all are required:
+
*{{aur|spl-utils}}
+
*{{aur|spl}}
+
*{{aur|zfs-utils}}
+
*{{aur|zfs}}
+
 
+
{{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:
+
*{{pkg|sudo}} - Note that your user needed sudo rights to {{ic|/usr/bin/clean-chroot-manager}} for the script below to work.
+
*{{pkg|rsync}} - Needed for moving over the build files.
+
*{{AUR|cower}} - Needed to grab sources from the AUR.
+
*{{AUR|clean-chroot-manager}} - Needed to build in a clean chroot and add packages to a local repo.
+
 
+
Be sure to add the local repo to {{ic|/etc/pacman.conf}} like so:
+
{{hc|$ tail /etc/pacman.conf|<nowiki>
+
[chroot_local]
+
SigLevel = Optional TrustAll
+
Server = file:///path/to/localrepo/defined/below
+
</nowiki>}}
+
 
+
{{hc|~/bin/build_zfs|<nowiki>
+
#!/bin/bash
+
#
+
# ZFS Builder by graysky
+
#
+
 
+
# define the temp space for building here
+
WORK='/scratch'
+
 
+
# create this dir and chown it to your user
+
# this is the local repo which will store your zfs packages
+
REPO='/var/repo'
+
 
+
# Add the following entry to /etc/pacman.conf for the local repo
+
#[chroot_local]
+
#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; }
+
done
+
 
+
[[ -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
+
done
+
 
+
for i in spl-utils spl zfs-utils zfs; do
+
  cd "$WORK/$i"
+
  sudo ccm s
+
done
+
 
+
rsync -auvxP "$CHROOTPATH/root/repo/" "$REPO"
+
</nowiki>}}
+
 
+
==Unofficial Repository==
+
 
+
For fast and effortless installation and updates, the [http://demizerone.com/archzfs "archzfs"] signed repository is available to add to your {{ic|pacman.conf}}:
+
 
+
{{hc|/etc/pacman.conf|<nowiki>
+
[demz-repo-core]
+
SigLevel = Required
+
Server = http://demizerone.com/$repo/$arch</nowiki>
+
}}
+
 
+
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:
+
 
+
{{hc|/etc/pacman.conf|<nowiki>
+
[demz-repo-archiso]
+
SigLevel = Required
+
Server = http://demizerone.com/$repo/$arch</nowiki>
+
}}
+
 
+
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]].
+

Latest revision as of 12:39, 24 April 2014

Redirect to: