Commit Graph

247 Commits

Author SHA1 Message Date
Peter Ashford
1831d43894 Readability changes to FAQ.rst
Work on grammar, spelling and typos.
2021-03-25 17:38:12 -05:00
Vlad Petrov
8a996a17a3 Arch Linux: Remove DropBear key limitation note
ed25519 support: https://github.com/mkj/dropbear/pull/91

Closes #131

Signed-off-by: Vlad Petrov <ejiek@mail.ru>
Signed-off-by: Maurice Zhou <ja@apvc.uk>
[more concise wording; fix rst formatting]
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-03-23 23:55:35 -05:00
Maurice Zhou
686f234fae Arch Linux: deprecate cachefile; import pools by scan
Arch Linux: install efibootmgr by default

Arch Linux: set zfs hook scan path

Arch Linux: import encrypted pool by mapper

Arch Linux: replace subjective "you" sentences

Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-03-17 17:56:40 -05:00
Peter Ashford
9dbf189300 Update Hardware.rst
Correct minor issue
2021-03-16 11:07:05 +03:00
Richard Laager
17845ca703 Debian: Fix /run/lock code
It looks like I messed this up (for Debian, but not Ubuntu) in my
various changes.  It is not necessary to do this before the chroot in
the normal install path, as it was done earlier.  But it is something
that should be done before the chroot in the rescue path.  I've now
made Debian match Ubuntu.

Fixes #141
Reported-by: Colm <colm@tuatha.org>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-03-15 18:32:01 -05:00
Richard Laager
30598b4875 Debian/Ubuntu: Improve the "Stop zed" message
Fixes #137
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-03-15 18:25:10 -05:00
Richard Laager
32954399c7 Debian/Ubuntu: Improve cryptsetup notes
There was already a note about ignoring a cryptsetup WARNING, but:
A) cryptsetup also prints an ERROR message, and
B) this also occurs at an earlier step.

Fixes #134

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-03-15 18:23:05 -05:00
Maurice Zhou
284bedff91 Arch Linux: Add missing varable to chroot command; IgnorePkg fixes
Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-03-14 12:53:23 -05:00
Maurice Zhou
06387ef96f Remove zfs-utils from IgnorePkg; Reorganize page
Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-03-14 03:41:06 -05:00
Maurice Zhou
5b2a3ec69d Arch: Use mountpoint=none for containers
Arch: Ignore kernel updates with zfs package

Arch Linux: Notes on single disk bash array and EFI system partition

Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-03-13 01:52:17 -06:00
Maurice Zhou
3d4931680d Arch Linux: Use bash array for multi-disk; Overview section for ZFS
package; drop Artix Linux

Arch Linux: index.rst punctuation

Arch Linux: Boot pool encryption key must not be in child dataset

Arch Linux: delete backup after restoration

Remove trailing blanks

Move topology spec above pool creation

Arch Linux: Reintroduce INST_UUID

Arch Linux: secure permissions for key file

Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-03-12 22:11:33 -06:00
Maurice Zhou
91d28894a7 Arch Linux: Fix package installation command
Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-03-09 00:17:33 -06:00
Maurice Zhou
e70da303a3 Arch Linux: Monthly Live image update; multiple fixes
index:
Numbered steps

Arch guide:
Reduce RAM requirement to 2G
March 2021 live image build
Use `pacman -S --needed` to skip reinstalling up-to-date packages
Use "Xonzfs" hostname instead of "localhost"
Remove pool encryption tips: Not relevant
Tip for encrypting boot pool
Add archzfs-testing repo; but commented out
Fix find-root-pool-name-in-grub link
Add missing steps in LUKS bpool
Warn about bricked motherboard for Secure Boot
Remove INST_UUID INST_MNT
Artix guide:
mostly same as above

I have tested the guide with a VM,
including LUKS bpool and hibernation section.

Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-03-07 17:22:18 -06:00
George Melikov
c6b0e597b2 SUSE docs: fix rst warnings and misc. fixes:
- rst warnings
- markdown-styled links
- empty lines with spaces

Signed-off-by: George Melikov <mail@gmelikov.ru>
2021-03-07 16:28:06 -06:00
Suleyman Poyraz
f006fe5729 openSUSE on ZFS has been written
This is a basic HOWTO page for OpenSUSE. This pages not official. This is a personal work represents how I do it.

* Added openSUSE on ZFS basic pages. For Leap and Tumbleweed this pages generated in lights of Debian and Ubuntu pages.

Signed-off-by: Suleyman Poyraz <zaryob.dev@gmail.com>
2021-03-04 04:09:14 -06:00
Maurice Zhou
c25037beb0 Arch Linux: Nest system datasets for more flexibility; encryption warning messages
Arch Linux Root on ZFS: Encrypt boot pool with LUKS

Typo fixes; tweaks

Add Secure Boot

Secure Boot key enrollment differs

Secure Boot: rm HP laptop ref

Strictly follow manu. instructions. I bricked my EliteBook 820 G2 with KeyTool.efi

Example Secure Boot customization links

Back up Secure Boot signing keys

Secure Boot: Add link to bricked motherboard

Replace Secure Boot with a link; out of scope

Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-02-28 18:52:09 -06:00
Maurice Zhou
13271f2467 Arch Linux: Multiple fixes
Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-02-24 03:13:01 -06:00
Richard Laager
904e7253a2 Debian/Ubuntu: Remove /boot/efi automount option
This was mentioned in #99 and I added it as an alternative option.
However, it seems to break GRUB; see #107.  GRUB tries to parse
/proc/mounts and see a line like this:
  systemd-1 /boot/efi autofs ...
From there, it gets "systemd-1" as the device name, and breaks.

Closes #107

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-02-22 14:06:17 -06:00
Richard Laager
2551c34eda Debian/Ubuntu: Add a couple notes
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-02-21 17:22:04 -06:00
Richard Laager
c6ce3a9f6f Ubuntu/Debian: Fix bpool importing
We need the bpool to end up in zpool.cache.  For some reason, this is
not happening normally on Ubuntu 20.04.  I added the same steps to
Debian too, for good measure.

This was discussed in #120.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-02-21 17:21:46 -06:00
Richard Laager
5cefeef05e Ubuntu: Add note to ignore some errors
Closes #120
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-02-21 17:21:27 -06:00
Richard Laager
47751dff49 Ubuntu: Update to 20.04.2
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-02-21 16:49:24 -06:00
Richard Laager
0dd5093187 Debian/Ubuntu: Bring back creating /mnt/run/lock
This should fix issues with zed.

Closes #110
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-02-21 14:46:56 -06:00
Maurice Zhou
8e2cdf4f58 Arch Linux: Multiple fixes for Root on ZFS guides
Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-02-20 03:20:13 -06:00
Richard Laager
6ab3d43847 Arch Linux: Remove alternative solutions
The previous approach to installation is: try this easy one first, and
if it fails, try the hard one.

This commit streamlines the installation experience by minimizing
references to such procedures.

This commit also removes verbose comments from Root on ZFS installation
guides.

As the upstream has fixed glibc, its section is also removed.

Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-02-19 23:55:37 -06:00
Richard Laager
cbec1d359b Debian: Fix some bad whitespace 2021-02-19 23:44:08 -06:00
Richard Laager
339c9d3187 Arch Linux: Fix formatting
We were getting errors about failing to parse some blocks as "sh"
because they weren't.

I made one small textual change when cleaning this up.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-02-15 21:57:40 -06:00
Richard Laager
4fa77b2658 Ubuntu/Debian: Fix formatting
I had one too many spaces.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-02-15 21:57:36 -06:00
Richard Laager
e8763236b6 Ubuntu/Debian: Disable automounting
If the disk has been used before (with partitions at the same offsets),
previous filesystems (e.g. the ESP) will automount if not disabled.

Co-authored-by: attero <service-github@attero.me>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
Closes #119
2021-02-09 18:57:01 -06:00
Maurice Zhou
7e4f2bce78 Handle glibc mismatch
Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-02-06 01:24:21 -06:00
Maurice Zhou
1442ba8828 Update Arch LiveCD; Use IgnorePkg 2021-02-03 04:35:41 -06:00
Maurice Zhou
5bb0cb5999 Solutions for rolling kernel releases 2021-02-02 03:28:38 -06:00
Richard Laager
b2d60382ba Debian & Ubuntu: chmod 700 /root
"The /root dataset is created with default world-readable permissions
 (755).  debootstrap would create /root with 700 permissions, but it
 does not change the permissions if it already exists."

Reported-by: zxyrepf
Closes #115
2021-02-02 03:28:38 -06:00
Richard Laager
d08af47f7a Fix ZFS feature generation script
This was breaking on FreeBSD, as some of the URLs were returning 404.  That
raises an HTTPError.  If we catch those and skip those sources (just as we
were already doing for HTTP codes other than 200), the script completes.  But
then we get a whole bunch of columns full of "no", which does not seem useful.
I added code to skip columns for sources that failed to download.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-02-02 03:28:38 -06:00
Richard Laager
fac3cb834b Ubuntu: Remove canmount=noauto from zed steps
I missed this when eliminating canmount=noauto from /boot and / in
commit eb05d5b190.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-02-02 03:28:34 -06:00
Maurice Zhou
12b9833e24 Fix formatting for incompatible kernel version notes 2021-01-25 15:14:23 -06:00
Maurice Zhou
fe61fd69e8 Add official documentation for Arch Linux
Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-01-25 12:47:23 +03:00
brian
14ff7d6546 Fixed GPG doc issue in Fedora 2021-01-21 14:57:47 -08:00
brian
dab4e9fd34 Fixed GPG doc issue in Centos/RHEL 8 2021-01-21 14:57:47 -08:00
Rakor
142c5da691 Corrected partition number in grub config for efi 2021-01-20 14:02:39 -06:00
Richard Laager
c00aa93389 Debian/Ubuntu: Update /boot/efi fstab entry
I made Debian follow the Ubuntu approach, which comes from the Ubuntu
installer.  There was a report (#99) of a problem with the old approach
used on Debian.  In that issue, user foo-git linked to a Fedora feature
request which discusses automounting /boot/efi instead.  I've offered
that as an alternative.

I am not switching to that outright, as following the Ubuntu installer
(where possible) is a goal of mine.

Suggested-by: foo-git
Closes #99
2021-01-09 16:59:17 -06:00
Richard Laager
2c76e5de97 Debian/Ubuntu: Try again with /run
The fix for #97, 66233a1138, seems to
have created yet another issue (beyond #100):

"the link /etc/resolv.conf -> ../run/systemd/resolve/stub-resolv.conf
is dangling (since /run has just been clobbered by an empty tmpfs).
debootstrap seems to populate all manner of stuff in /run."
f1721edda7 (commitcomment-45770519)

I considered just reverting all of this, since the original issue only
occurred when copying in an existing system.  Ignoring it was my
decision the first time this came up.  But it's come up twice now.
Also, this mode is mentioned in the guide.  Most importantly, if we are
not mounting a /tmpfs at /run in the normal case, then we could end up
with cruft in /run in the root filesystem which could potentially break
something or be confusing later if the /run tmpfs ever failed to mount.
So in the interest of correctness, I'd like to try to handle this.

I am now mounting a tmpfs at /mnt/run before the debootstrap step.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-01-08 16:16:35 -06:00
George Melikov
f36bd91110 feature matrix: fix readonly column width for firefox
Signed-off-by: George Melikov <mail@gmelikov.ru>
2021-01-06 02:53:50 +03:00
Garrett Fields
3375ee0931 Statically add ZOL 0.6.5.11 to the feature matrix (#101)
This resolves #83.  While 0.6.5.11 is old, it still had feature flags.
Since the 0.6.x branch will not receive further minor releases,
this static change should be stable.

Signed-off-by: Garrett Fields <ghfields@gmail.com>
2021-01-06 02:41:46 +03:00
Richard Laager
d06e1a9b13 Debian/Ubuntu: Create /mnt/run/lock
The fix for #97, 66233a1138, seems to have
created another issue.

Closes #100

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-01-05 00:01:22 -06:00
Richard Laager
66233a1138 Debian: Add a work-around to preserve zpool.cache
The zpool.cache file is getting cleared by zfs-import-bpool.service.  A
work-around is to move the cache file out of the way before the import
and restore it after:
https://github.com/openzfs/zfs/discussions/8549#discussioncomment-231334

The suggestion there is suppressing errors with `|| true`, which can
also be done by prefixing the command with `-`.  (I verified that the
systemd in Buster is new enough to support that.)  If we are
suppressing errors anyway, I'm not sure there's a benefit to checking
for the file rather than just trying the move and letting it fail.  The
latter approach avoids the shell entirely.  So I changed it.

Closes #97
Suggested-by: Andrey Prokopenko <9478806+terem42@users.noreply.github.com>
Tested-by: Hevisko <hvjunk@gmail.com>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-12-31 10:48:42 -06:00
Richard Laager
f1721edda7 Mount a tmpfs at /run
It was reported, in #97, that this is required when copying an existing
system installation into the root filesystem.  It is probably a good
idea to do this all the time, to avoid the risk of stray junk ending up
in /run during the install process.

Suggested-by: Hevisko <hvjunk@gmail.com>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-12-30 23:51:28 -06:00
George Melikov
229d45aafb feature matrix: beautify css for readability
Signed-off-by: George Melikov <mail@gmelikov.ru>
2020-12-29 00:35:40 +03:00
George Melikov
a6c93633e8 feature matrix: minify width + highlight hovered row
- rotate versions
- highlight hovered row
- restrict max distor one line lenght

Signed-off-by: George Melikov <mail@gmelikov.ru>
2020-12-29 00:31:59 +03:00
George Melikov
84651d03de feature matrix: add horizontal scroll
Signed-off-by: George Melikov <mail@gmelikov.ru>
2020-12-29 00:27:11 +03:00