Commit Graph

326 Commits

Author SHA1 Message Date
Richard Laager
41ea6da337 Reorder SSH step
This reduces the number of steps in the "First Boot" section that are
not related to the first boot.

Reported-by: Jonathan Dumont <JOduMonT>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-10-29 14:01:47 -05:00
Richard Laager
0a2125b845 Debian/Ubuntu: Improve some sudo usage
Reported-by: Jonathan Dumont <JOduMonT>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-10-28 22:07:00 -05:00
Scott G. Ainsworth
f2cda9dad5 Ubuntu/Debian: swapoff when using disks
Use swapoff to ensure swap partitions are not mounted prior to
'sgdisk --zap-all'

Signed-off-by: Scott G. Ainsworth <scott@ainsworth.us>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
[Applied the change to Debian Buster; removed Ubuntu 16.04 and 18.04.]
2021-10-25 14:30:51 -05:00
George Melikov
1f2ff88863 Use upstream sphinx-notfound-page module instead of fork
We waited for changes to make 404s work properly
(absolute links with prefix).
It's in master now, use it.

Signed-off-by: George Melikov <mail@gmelikov.ru>
2021-10-24 21:07:32 +03:00
Scott G. Ainsworth
3c04e929a1 Ubuntu & Debian: Use variable for username
Signed-off-by: Scott G. Ainsworth <scott@ainsworth.us>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
[Applied to Ubuntu 20.04 Raspberry Pi & Debian Buster.]
2021-10-13 23:22:55 -05:00
Fernando Carolo
4c3ec4c594 Update instructions for Ubuntu on Raspberry Pi for 20.04.3 release.
Update the getting started instructions for Ubuntu on a Raspberry Pi to
use the 20.04.3 LTS release.

Signed-off-by: Fernando Carolo <fcarolo@google.com>
2021-10-12 16:53:35 -05:00
j5k
d8061ede68 Fix link 2021-10-11 17:14:52 +03:00
Rich Ercolani
0353028220 Add libcurl-dev{,el} to requirements
openzfs/zfs-buildbot@ed2a648f49 added libcurl-devel to bb-dependencies.sh, but nobody ever told the docs.

Whoops.
2021-10-08 13:37:35 +03:00
Maurice Zhou
89749e285f mention ne9z for pull requests
Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-10-03 21:28:26 +03:00
Maurice Zhou
e34ace390b replace commands parsing ls output with shell glob
Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-10-03 21:28:26 +03:00
Maurice Zhou
d1e8fad976 NixOS: special procedures for building site
Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-10-03 21:28:26 +03:00
Maurice Zhou
f121be16dc For maximum compatibility and redudancy; mirrored vdev
is now always used for boot pool

Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-10-03 21:28:26 +03:00
Maurice Zhou
7fe3e8ceb1 NixOS on ZFS: replace manual root password generation with bash variable
Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-10-03 21:28:26 +03:00
Joe Taber
41cdd28cf6 Add dnf remove -y zfs-fuse step to preparation doc
This change makes the preparation document align with the same recommendation in index.rst
2021-10-03 19:52:28 +03:00
Maurice Zhou
621d45a413 reword warning message; links for 5.10, 4.19 kernel
Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-10-03 13:32:44 +03:00
Maurice Zhou
6e8ae2f854 warn about the risk of using a third-party kernel
Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-10-03 13:32:44 +03:00
Maurice Zhou
783f390aa6 update links to boot environment manager
Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-10-03 13:32:44 +03:00
Allan Jude
9a6ab5f317 Update FreeBSD install instructions
Default version if python 3.8 now, and remove an excess \
2021-10-02 23:34:37 +03:00
Rich Ercolani
cfa01ddfe8 Add warning about containers (#203)
A couple people have come by IRC having issues where the root cause was that they were stuck on the CDDL/GPL prompt from apt never rendering because their container runtime console wasn't being detected as dumb/noninteractive by apt, but wasn't capable of displaying the prompt.

So let's add a warning about that, shall we?
2021-09-14 11:12:32 +03:00
David Pesticcio
3072a80310 Update: SATA drives with power failure protection (#199)
Old location: http://blog.nordeus.com/dev-ops/power-failure-testing-with-ssds.htm (404 Not Found)

Present location: https://engineering.nordeus.com/power-failure-testing-with-ssds
2021-09-14 10:59:31 +03:00
George Melikov
e3bbc6ea30 Update zpool-features section number 2021-09-07 14:50:11 +03:00
George Melikov
8ca34b110b Update link to zpool-features.7 man page 2021-09-07 14:49:32 +03:00
ne9z
d1a20453b6 archlinux liveiso: sept 2021 update (#196)
Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-09-06 20:49:11 +03:00
ne9z
a1f68c37e0 Add support for NixOS + Fedora, Arch, RH minor changes (#195)
* Add support for NixOS

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* updated files for immutable root fs

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* update ssh key location

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* change initrd host key name

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* add missing -p switch

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* comments about SSH and encrypted bpool

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* backup hardware-configuration.nix file

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* clearer wording for backup

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* global useDHCP flag is deprecated

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* point user to configuration.nix

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* fixes for systemd-autofs; network; typo

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* force command to return 0

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* fix command to postMount

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* fix mount command

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* escape $i

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* create mountpoints before booting

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* replace postDevice,preMount command

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* disable zfs-mount

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* generate machine-id

Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-09-06 20:48:50 +03:00
ne9z
f40d19a2c5 Multiple fixes for Root on ZFS guide (#191)
* Let user know that SELinux will be re-enabled after reboot

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* compat with future releases: use zfs-dkms and newer repo

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* rm unused releasever option

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* let user aware of the ignorable errors

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* detailed explanations for errors during grub-menu generation

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* Build ZFS dkms module in installed system

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* switch to dkms package for better compatibility with kernels

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* add direct download links for live iso

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* rm zfs-fuse before install; mirrorlist

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* reformat notes

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* rm netconfig - networkmanager is enabled by default

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* load kernel module in live;

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* rm encrypted bpool: untested

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* use u=r,go= permission on key file

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* fix typo

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* use bash shell

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* suggest clean the disks

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* add grub-menu auto update

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* monitor kernel-core pkg

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* copyright 2021

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* fix kernel var detection

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* read-only cache file

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* replace zfs-mount.service with zfs-mount-generator

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* notes for mount and POSIX-compliant

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* hard-code kernel version

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* fix chroot variable

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* fix grub cfg

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* fix grub

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* missing comment

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* comments

Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-08-28 23:07:35 +03:00
Maurice Zhou
6fcf8e76be Fedora: create bpool with compatibility property
update Arch Linux live loader entries

Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-08-10 11:38:30 +03:00
Maurice Zhou
5717d7bef7 rm refs to arch
Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-08-06 23:33:36 +03:00
Maurice Zhou
ae7c5d19f4 Fixes for Fedora; support Rocky Linux Live ISO
Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-08-06 23:33:36 +03:00
Maurice Zhou
9261cfb4f5 GRUB menu need to be regenerated after kernel update
Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-08-04 12:05:30 +03:00
ne9z
bdb85fc137 Add support for RHEL Root on ZFS (#180)
* Add support for RHEL Root on ZFS

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* require cryptsetup.target before mounting swap

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* disable sshd

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* fedora 34; grub workaround

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* add manual redirect to new page

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* orphan page

Signed-off-by: Maurice Zhou <jasper@apvc.uk>

* Remove `RHEL and CentOS` from index

Co-authored-by: George Melikov <mail@gmelikov.ru>
2021-08-03 17:55:33 +03:00
ne9z
6a60717816 Arch Linux: August 2021 update (#185)
Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-08-03 17:44:45 +03:00
ne9z
de588ca3d3 Add Fedora Root on ZFS support (#177)
* Add support for Fedora Root on ZFS

* use /usr/sbin/zfs

* 2.0.5 is now available with support for latest kernel

* require cryptsetup.target before mounting swap

* disable sshd

* fedora redirect

Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-08-03 17:42:08 +03:00
Václav Skála
f5a2a4e05b Fix zfs_scan_mem_lim_soft_fact documentation
Signed-off-by: Václav Skála <skala@vshosting.cz>
2021-07-13 12:36:55 +03:00
Brian Behlendorf
7344a563b4 Update the dRAID version note
Make it clear dRAID is available as of the 2.1.0 release.

Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov>
2021-07-02 10:07:49 +03:00
Tony Hutter
e121b1422e Missed one small Centos 8.3 -> 8.4 change 2021-06-23 14:53:34 -07:00
Tony Hutter
b90c76e543 Add links to Centos zfs-release.el8_4.*.rpms 2021-06-23 14:52:44 -07:00
Maurice Zhou
fb2317eea2 June-2021 update
fix indentation

GRUB 2.06 does not work with LUKS2

use separate file in /etc/profile.d

Use systemd-firstboot to configure locales, tz, etc

instructions for non-interactive system-firstboot

systemd-firstboot has bugs for setting root password

Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-06-20 16:47:36 -05:00
William Reiske
cd6805a58d Update ZIO Scheduler.rst 2021-06-17 15:42:38 -05:00
Rich Ercolani
4bcc7f69c3 Added ncompress requirement on RPM platforms.
openzfs/zfs#12173 is going to add a requirement for ncompress.

Signed-off-by: Rich Ercolani <rincebrain@gmail.com>
2021-06-04 11:26:31 +03:00
oliverpool
3ffd0fb421 Available typo 2021-05-27 14:13:40 -05:00
ne9z
eae172d920 move to libera.chat (#167)
Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-05-26 14:14:57 -07:00
Rich Ercolani
47c197a98e Updated and corrected build instructions.
While adding python{,3}-packaging to the build requirements, I
suspected that the build instructions hadn't actually been tested
recently. So I checked, found problems, and corrected them.

Signed-off-by: Rich Ercolani <rincebrain@gmail.com>
2021-05-22 23:52:58 +03:00
Maurice Zhou
99b06be59a Notes for encryption; direct link for Live ISO; striped vdev topology;
Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-05-20 00:17:37 -05:00
Maurice Zhou
ff20f0b5d7 Move long code pieces to separate files
Formatting fixes
separate files

Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-05-14 17:37:07 -05:00
Maurice Zhou
578f2901a7 GRUB boot live ISO
customize esp, bpool, swap, reserve size
customize previously hard-coded '/sys/'
add INST_ID to chroot variables
append INST_ID to zfs key name

Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-05-10 18:52:30 -05:00
Maurice Zhou
16cb298acf Examples for GRUB $prefix and $root
fix "efibootmgr -d" argument

dont set hostname in live environment

Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-05-04 02:53:12 -05:00
Fernando Carolo
fd48b2641f Update instructions for Ubuntu on Raspberry Pi for 20.04.2 release.
Update the getting started instructions for Ubuntu on a Raspberry Pi to
use the 20.04.2 LTS release. Add `-a` flag to the `wipefs` command to
make sure it will erase any filesystem header from previous use of the
SD card.

Signed-off-by: Fernando Carolo <fcarolo@google.com>
2021-05-04 00:49:12 -05:00
Maurice Zhou
d022e79773 fix indentation; remove spurious white space
Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-05-04 00:05:52 -05:00
Maurice Zhou
1fd8de8b18 Add hibernation instructions
Use ${DISK}-swap for dm name

Update archlinux live image to May 2021

Other minor improvements

reusable command for mirroring ESP

use glob for initrd keys

apply hostname to live system; use wildcard for network config

separate persistent swap and hibernation

secureboot; temp esp partition

capital letters

Secure Boot needs to be re-enabled

wording: save and reboot

wording, spurious white space

double sharp sign for comment

updates for GRUB tips

reinstall GRUB after entering system

Signed-off-by: Maurice Zhou <ja@apvc.uk>

do not use /dev/sda as example

fix formatting; add notes

update info regarding encryption

use internal links; tweak indentation

other kernel variants

install sudo before editing /etc/sudoers

use colon

use mkinitcpio for initrd generation

only use ~/.local/bin if exist

dependencies for building site

Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-05-04 00:05:52 -05:00
Tony Hutter
45d984ebdb Add Fedora 34 http link in markup 2021-04-27 09:21:22 -07:00