Commit Graph

81 Commits

Author SHA1 Message Date
George Melikov
b3c8a7a868 Add man pages generation via Makefile 2020-06-05 20:24:09 +03:00
George Melikov
4bebe1059d Add man pages into ToC 2020-06-05 20:24:09 +03:00
George Melikov
364654a5f2 Ignore generated man pages 2020-06-05 20:24:09 +03:00
George Melikov
3caaad0474 Add css for man pages 2020-06-05 20:24:09 +03:00
George Melikov
dcd35b7afb Set absolute paths in 404 page
Signed-off-by: George Melikov <mail@gmelikov.ru>
2020-06-05 20:24:09 +03:00
Atemu
50cfe62735 Getting Started: Add NixOS wiki to index 2020-05-31 17:09:02 +03:00
Richard Laager
04d3c1cee4 Ubuntu 20.04: Add errata notes for /boot/grub
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-30 17:45:52 -05:00
Richard Laager
b6fd009edd Ubuntu 20.04: Fix /boot/grub issues
zsys was setting canmount=off on bpool/grub.  It is now
bpool/BOOT/ubuntu_UUID/grub.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
Reported-by: Larry Wagner <larrywagner0@gmail.com>
2020-05-30 17:44:30 -05:00
Richard Laager
12aa83791c Ubuntu 20.04: Disable grub-initrd-fallback.service
This is the service for /boot/grub/grubenv which does not work on
mirrored or raidz topologies.  Disabling this keeps it from blocking
subsequent mounts of /boot/grub if that mount ever fails.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-30 17:43:00 -05:00
Richard Laager
9c2f4a04c1 Ubuntu 20.04: Patch a dependency loop
This is from Launchpad bug #1875577.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-30 17:41:18 -05:00
Richard Laager
3d8bac3772 Ubuntu 20.04: Fixup formatting and wording
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-30 17:04:44 -05:00
Richard Laager
e1705d5660 Ubuntu 20.04: Install vim earlier
This ensures that vim is installed before the first use.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-30 16:58:46 -05:00
Richard Laager
0ccf839233 Drop the Debian package option for building docs
We are now using an extension which is not packaged.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-30 16:58:43 -05:00
Richard Laager
58f5b16286 Ubuntu 20.04: Add Errata section
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-30 16:58:34 -05:00
Richard Laager
3afab9343f Ubuntu 20.04: Fix a file path
Signed-off-by: Richard Laager <rlaager@wiktel.com>
Reported-by: Larry Wagner <larrywagner0@gmail.com>
2020-05-30 15:00:51 -05:00
Richard Laager
c9e868af21 Debian/Ubuntu: Expand disk clearing steps
This covers more scenarios, including the need to stop md arrays and
wipe MD partitions.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
Requested-by: Larry Wagner <larrywagner0@gmail.com>
2020-05-30 15:00:51 -05:00
George Melikov
4d3d0bdf55 Set absolute paths in 404 page
Signed-off-by: George Melikov <mail@gmelikov.ru>
2020-05-30 22:47:21 +03:00
Richard Laager
541ad80d18 Ubuntu 20.04: Install full vim when using SSH
Installing the full vim package fixes terminal problems that occur when
using the vim-tiny package (that ships in the Live CD environment) over
SSH.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-30 00:46:31 -05:00
Richard Laager
b5a4a192a2 Ubuntu 20.04: Fix the password change note
There is no current password prompt.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
Reported-by: Larry Wagner <larrywagner0@gmail.com>
2020-05-30 00:44:14 -05:00
Richard Laager
2e63f173d2 Ubuntu 20.04: Add a note about swap size
This now mentions that the user might want to customize the swap size.
It also specifically mentions hibernation and the requirement to size
the swap at least as large as the system RAM.

Note: I have not tested hibernation.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
Reported-by: Larry Wagner <larrywagner0@gmail.com>
2020-05-30 00:32:51 -05:00
Richard Laager
780f029dd3 Ubuntu 20.04: Separate /boot/grub ESP step
The previous "Install GRUB/Linux/ZFS in the chroot..." step had two
conditionals ("For a single-disk install only" and "Choose one...").  It
was not clear to readers if these were mutually exclusive.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
Reported-by: Larry Wagner <larrywagner0@gmail.com>
2020-05-30 00:28:17 -05:00
Richard Laager
73be195834 Ubuntu 20.04: Fix formatting
This fixes the formatting for Step 5, item 6, "Install the bootloader".

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-30 00:28:13 -05:00
Richard Laager
0c5240e061 Ubuntu 20.04: Add a warning about disabling ACLs 2020-05-29 23:55:39 -05:00
Richard Laager
9451808b1a Revert absolute URL fix
This does not work when the GitHub Action builds it.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-29 14:06:35 -05:00
Richard Laager
f7ba4f4b19 Fix absolute URL fix again
Ugh! This time I accidentally forgot the -i for sed.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-29 13:56:02 -05:00
Richard Laager
d1b3973b92 Ubuntu 20.04: Add zfs load-key
This already existed in the Debian Buster version, but I missed it here.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
Fixes: 11
Reported-by: Alastair Rankine <alastair@girtby.net>
2020-05-29 13:51:03 -05:00
Richard Laager
b261954a6c Fix the last change
The search form has an action= that needs to be fixed.  There are some
absolute links and a fragment link that should not be changed.
2020-05-29 13:38:22 -05:00
Richard Laager
a211c4e3b7 Use absolute links for 404 page
Fixes #12

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-29 13:21:03 -05:00
Richard Laager
c100c5f854 Fix other missing EOF newlines 2020-05-29 13:19:04 -05:00
Richard Laager
783b4b75e5 Fix lack of EOF newline in conf.py 2020-05-29 13:16:57 -05:00
Richard Laager
8ceda7c238 Ubuntu 20.04: Fix /var/lib/AccountsService 2020-05-28 11:34:22 -05:00
Richard Laager
0051643be0 Ubuntu 20.04: Fix a copy-and-paste mistake
The rpool mirroring instructions referenced bpool and partition 3
instead of rpool and partition 4.

Reported-by: reddit.com/u/mishac
2020-05-27 13:11:30 -05:00
Matthew Ahrens
8b5ff856a5 Add missing word
Co-authored-by: George Melikov <mail@gmelikov.ru>
2020-05-27 10:36:47 +03:00
Richard Laager
62c172a8eb Ubuntu 20.04: Use encrypted swap with installer
If someone edits the installer to use encryption, they should also setup
encrypted swap.  I have now added instructions for that.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
bc4eac650a Debian: Update aes-256-gcm note
buster-backports has ZoL 0.8.4.  I am still explicitly specifying
encryption=aes-256-gcm to avoid accidents.  This can probably change to
encryption=on at some point.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
4fb612b336 Debian/Ubuntu: Expand SSH instructions
This makes the PermitRootLogin changes part of the actual steps rather
than a comment.  I've also made its removal an explicit step.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
3e9c328ce5 Debian: Adjust partition types to match Ubuntu
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
c11642d7ae Debian: Drop devices=off from rpool
This makes it consistent with Ubuntu.  This really isn't worth the
trouble, especially since it breaks debootstrap.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
67561688af Debian/Ubuntu: Autonumber (current) HOWTOs
This also involved a bunch of reindenting and rewrapping.

I reworked the Live CD sources on Debian to be more consistent with
Ubuntu (and the chroot sources configuration on Debian).

I reworked the zpool create wrapping and the mirror/raidz notes.  This
should be more clear on how to create the multi-disk topologies.

I fixed a couple formatting issues too (mainly one backtick where
there should have been two).

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
277ad2a070 Debian/Ubuntu: Autonumber Contributing section
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
784b3b7a27 Debian: Simplify /boot mounting
The original idea here was that bpool/BOOT/debian should be able to be
cloned, just like rpool/ROOT/debian. The problem is that it doesn't
really work without special support in the initramfs. Given that, it is
possible to simplify this.

I also set mountpoint=/boot on bpool, for consistency with the Ubuntu
20.04 HOWTO, which is in turn done that way for consistency with the
Ubuntu installer.

Thanks: colmbuckley
Closes: openzfs/zfs#10309
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
7c4861e911 Debian/Ubuntu: Add Ubuntu 20.04
I have backported some of the cosmetic and other minimal changes to
Ubuntu 18.04 and Debian Buster.  This keeps the deltas as small as
reasonably possible.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
417c2a5379 Debian: Set REMAKE_INITRD=yes
The initrd needs to be rebuilt after the ZFS modules are built.
Otherwise, the system can (will?) fail to boot.

Closes: openzfs/zfs#10355
Reported-by: Christian Garbs <mitch@cgarbs.de>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
c5cd813885 Debian/Ubuntu: Update Support links
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
99a0c97413 Debian/Ubuntu: Cleanup and update index pages
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
3bd94cb805 Ubuntu 18.04: Update libvirtd service name
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
ae6aa9cb4d Debian/Ubuntu: Cleanup formatting
This cleans up a bunch of formatting from the rst conversion.  I didn't
make the manual fixes to the 16.04 or Stretch versions, since they
aren't really being maintained these days and are just for reference for
existing installations.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
3c8f6c3195 Debian/Ubuntu: Add "Overview" header
This improves the table of contents.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
0c6f1b9680 Debian/Ubuntu: Fix headers
Some of the headers were at the wrong level after the conversion to
Sphinx.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00
Richard Laager
1ff69e0d4e Debian/Ubuntu: Update Contributing docs
The Contributing docs needed updating after the move to Sphinx.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-05-26 14:40:24 -05:00