stevleibelt / arch-linux-live-cd-zfs-setup

Easily load ZFS kernel module on any Archiso.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Arch linux live cd zfs setup

This repository contains a simple, free as in freedom, bash script to enable openzfs support on your regular archlinux.iso.

The current change log can be found here.

See my archzfs webpage if you want to know more.

This is a hard fork from eoli3n/archiso-zfs. For the history, eoli3n asked me kindly to do a hard fork, so I did.

How to use

Boot your archiso and run the folloging code

curl -s https://archzfs.leibelt.de/media/setup/init | bash

dkms-screenshot

Debug

By default, command outputs are redirected to /dev/null. To run the script in verbose mode, use:

curl -s https://archzfs.leibelt.de/media/setup/init | sed 's- &>/dev/null--' | bash -s -- -v

Running the script produces a debug.log file in the current directory. To upload this easily, you can

$ pacman -Syy pastebinit
$ pastebinit -b sprunge.us debug.log

And then paste me the url in your issue.

Why does this repository exists?

If you want to install Archlinux on ZFS, you need to deal with the ZFS licensing problem. The kernel module isn't included in the default archiso image, you need to include it into a custom archiso image to be able to install ZFS.

It can happen, that you need a running archiso with the latest kernel quick.
This script lets you include the zfs kernel module on any archiso image without creating a custom one.

What the init script does in short

The Archzfs unofficial user repository offers multiple ways to install the ZFS kernel module.
We can install precompiled module with zfs-linux package or compile the zfs module using DKMS method.
In order to build the module, DKMS needs the linux-headers package for the running kernel.

How does the init-script work?

It extracts running kernel version and try to find a matching ZFS module in Archzfs repositories.
If it doesn't, it fallbacks to the DKMS build of the ZFS module.
In that case, the script uses Arch Linux Archive to install the linux-headers and base-devel packages required for DKMS. You need at least ~6Gb RAM to use that method to be able to store packages in cowspace.

In some very specific cases, you won't be able to get ZFS module working for a specific archiso version.
In that case, just switch to the previous month iso.

Developer informations

#add upstream
git remote add upstream https://github.com/eoli3n/archiso-zfs
git fetch upstream

loadkeys <your keymap, e.g. de-latin1
# In pacman.conf, comment SigLevel line
# Set "SigLevel = Never"
pacman -Syy git
# In pacman.conf, restore Siglevel line

Links

About

Easily load ZFS kernel module on any Archiso.

License:GNU General Public License v3.0


Languages

Language:Shell 100.0%