Commit Graph

99 Commits

Author SHA1 Message Date
Pariksheet Nanda
577bcc4f93 Debian: Install NTP service on Bullseye to avoid web login failures
Closes #344
2022-11-29 12:56:07 +03:00
Richard Laager
81b6c209e4 Debian: Add work-around for bpool import failures
I am not sure under what circumstances this occurs, or whether it also
affects Debian Buster or Ubuntu.

Closes #349
Co-authored-by: Immanuel Albrecht <immanuel.albrecht@dlh.de>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-10-01 04:50:09 -05:00
bajjer
f7aafbd853 Revise example to tune to the recordsize for rpool
Change the provided example to tune the ``recordsize`` to apply to the
root dataset when creating the rpool. See
https://github.com/openzfs/openzfs-docs/issues/345#issuecomment-1242657449

Closes #345
Closes #346

Signed-off-by: Richard Laager <rlaager@wiktel.com>
[applied the change to all the distros]
2022-09-10 16:28:09 -05:00
Adam Kalisz
90fbd14df3 Add cryptsetup-initramfs package to include cryptsetup into initrd.
The initrd cannot otherwise decrypt the partition.
2022-08-23 12:25:31 +03:00
George Melikov
1d2ffe3528 Apt: use kernel/headers meta packages
- `generic` packages exist since bullseye
- older versions have `amd64` meta package
2022-07-13 23:41:59 +03:00
Richard Laager
e1f251bba1 Debian: Correct backports pinning
The source package is zfs-linux, not zfsutils-linux.  I had this wrong
in the fix for #314.

Closes #318
Reported-by: Piscium
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-06-13 12:40:50 -05:00
Antoine Beaupré
bc5882432b reorder the bpool to be consistent with the rpool
We stick to two rules here:

 * -o options come before -O

 * pool-specific options are wedged in between -o and
   -O (e.g. compatibility=grub2)

I don't know if that was a deliberate policy, I'm just trying to guess
what the pattern was

Signed-off-by: Antoine Beaupré <anarcat@debian.org>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-06-09 12:28:47 -05:00
Antoine Beaupré
16d2fe20df reorder and regroup zpool create commands
This regroups the options passed to zpool create in a more logical
way.

 1. the ACL/xattr/dnodesize settings are all on one line, since they
    are all related (latter being optimizations because we enable the
    former)

 2. ashift, autotrim, compression, normalization, relatime are all
    independent options that merit their own line for better
    visibility, they are also optional and therefore it makes sense to
    have them separate

 3. canmount, mountpoint and -R are all related as well

This is only a "whitespace" fix: there should be no functional change
to this patch.

I also noted that dnodesize=auto is *not* passed to the bpool cache
creation, even though it's passed to the rpool creation. I suspect
that might be an omission. This also goes to show that ordering those
options consistently makes it easier to spot those errors.

This is a followup to #307.

Signed-off-by: Antoine Beaupré <anarcat@debian.org>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-06-09 12:28:30 -05:00
Richard Laager
9e7a1e8c54 Add "the" to a phrase
I noticed this while looking at #317.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-06-09 12:18:48 -05:00
Richard Laager
36c1f2f5cd Debian: Update backports pinning
According to the apt_preferences man page, we should be able to use
"Package: src:zfsutils-linux".  Then we don't have to worry about keeping
the list of packages up-to-date, especially as library soversions change.

Reported-by: udf2457
Closes #314
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-06-08 01:14:00 -05:00
Richard Laager
f30e459aa2 Debian/Ubuntu: Strengthen "New version" messages
This makes it more clear that the old guides are not receiving updates.

This came up in #309.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-05-25 13:53:46 -05:00
Richard Laager
7493fd37e4 Debian: Revert compatibility=grub2
This doesn't work on Debian Bullseye.  While I tested the actual
create command on unstable, I know I looked at a file list on
packages.debian.org.  I must have looked at bullseye-backports by
mistake.  That's what I get for not testing the whole thing!

This partially reverts commit 7343c2253f.

Reported-by: anarcat
Closes #309
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-05-20 23:23:17 -05:00
Richard Laager
db5c8c4785 Debian & Ubuntu: Rework dataset creation step
The major change for Ubuntu is to mark many of these as optional, like
with Debian and the old guides.  As I move away from zsys, this will end
up being more like the old way.

This was also discussed in #306 and #307, but this change has
trade-offs.  It can reduce the number of datasets created on the
system, but it does so by increasing the complexity to read and follow
the guide.

Then I just harmonized Debian with Ubuntu.  Aside from whitespace,
reordering, rewording, the substantive changes were to drop /opt and
add /var/lib/NetworkManager.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-05-19 23:17:17 -05:00
Richard Laager
7343c2253f Debian & Ubuntu: Use compatibility=grub2
This reduces the number of features I need to enable explicitly.

As discussed in #306 and #307.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-05-19 23:17:17 -05:00
Richard Laager
c084a2ebff Debian: Set autotrim=on on Bullseye
I had this for Ubuntu 22.04.  This should be supported on Debian Bullseye too.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-05-19 23:17:17 -05:00
Richard Laager
f110d52486 Debian Bullseye: Fix issue with zed steps
Running "zfs set canmount=off rpool/ROOT/debian" causes the root
filesystem to be remounted read-only.  I have no idea why, but that's
mostly beside the point.

I have no idea why I added these commands in the first place.  The
other guides were not this way.  These steps showed up in the initial
add of the Bullseye instructions.

Reported-by: Cameron Skappel <cskappel@wiktel.com>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-05-19 00:56:53 -05:00
Richard Laager
fc9bcbadb9 Debian: Fix some wording
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-05-19 00:52:31 -05:00
Richard Laager
903d631033 Set encryption=on
encryption=aes-256-gcm is now the default.

anarcat mentioned this in PR #306.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-05-19 00:51:52 -05:00
Richard Laager
8105d010fe Ubuntu 22.04 / Debian: Deprecate zsys
Ubuntu almost removed support for ZFS from the installer, and zsys is
on life support:
https://bugs.launchpad.net/ubuntu/+source/ubiquity/+bug/1966773
https://bugs.launchpad.net/ubuntu/+source/ubiquity/+bug/1968150

I plan to rework the Ubuntu 22.04 instructions to be closer to those for
Debian Buster.  This will be straightforward, but I need to actually test
the resulting instructions before pushing that change.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-04-29 16:44:46 -05:00
Jonathan Dumont
d8e15645f6 Debian: Create /etc/dropbear-initramfs
/etc/dropbear-initramfs is not create automatically - at least on Debian
testing

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-04-27 14:21:06 -05:00
Richard Laager
5543afab03 Debian: Use tasksel --new-install
This switch makes tasksel include the "standard system utilities" task.

Unfortunately, it also defaults to installing a desktop environment, so
we need to warn users about that.

Co-authored-by: Marcello Mamino <m2@ciovil.li>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-04-27 14:18:00 -05:00
Matt Bentley
4007f89319 Added note about boot pool size consideration; fixes #296
Signed-off-by: Matt Bentley <mbentley@mbentley.net>
2022-04-24 16:40:53 -05:00
Martín Gómez
33b846f3e6 Debian: Use bullseye-backports
Update to use Debian bullseye-backports repository.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-04-22 22:50:53 -05:00
Richard Laager
180dedbe6f Debian/Ubuntu: Add a hint about multi-disk setups 2022-04-21 23:31:54 -05:00
krumelmonster
bbea2a1c1b exporting bpool would reproducibly fail for me, suggesting import -f in initramfs on reboot as a fix 2022-02-02 21:08:58 +03:00
krumelmonster
02ade43665 suggest to use wipefs on disks containing obsolete zfs labels 2022-02-02 21:08:58 +03:00
Kevin P. Fleming
5713bc08ed Use 'private' bind mounts
When plain '--rbind' is used, the 'umount' process executed later in the
setup process completely unmounts the bound filesystem, resulting in various
forms of breakage on the host used to do the setup. When a Live CD is used
and the system will be immediately shutdown/rebooted, this isn't an issue,
but in other scenarios it can be problematic.

Making the bind mounts 'private' avoids this problem. This patch changes
the setup guides for 'modern' distribution versions but does not touch
the older ones where this functionality may not be available.

Signed-off-by: Kevin P. Fleming <kevin@km6g.us>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-01-17 12:35:02 -06:00
Richard Laager
a408cc2d67 Debian/Ubuntu: Set hostname in Live environment
This ensures that the Live hostname does not leak into e.g. OpenSSH
server keys.  It's not a huge deal either way, but this is nicer.

Closes #158
Thanks: anarcat
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-12-12 14:24:41 -06:00
Richard Laager
a90b19b0f7 Debian: Update initrd example
This now uses a /BOOT instead of /ROOT.  I also changed
rpool/ROOT/debian-1 to rpool/ROOT/debian.  These changes make it match
the Root on ZFS systems.  I have no actually tested this.

Closes #215
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-12-12 13:52:12 -06:00
Richard Laager
567524c1e0 Debian: Add dropbear instructions
The dropbear-initramfs package can be used to add dropbear SSH support
to the initramfs.  That can be used to remotely unlock the root pool
using the `zfsunlock` script.

Closes #46
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-12-11 20:26:15 -06:00
Richard Laager
db8b190f73 Debian: Fix formatting error
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-12-11 20:08:15 -06:00
Richard Laager
cbb49c7fb4 Debian/Ubuntu: Simplify os-prober removal
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-12-11 19:14:30 -06:00
Richard Laager
c2ecfb8cbb Debian: Update for Bullseye
Besides the obvious s/buster/bullseye/ sort of changes, this:
  - Removes the use of backports.  At this time, the difference is
    minimal (2.0.6 vs 2.0.3) and I do not see a need to force backports
    on users.  They are free to add it later if they wish.
  - Updates the sources.list for bullseye-security also being at
    deb.debian.org.
  - Updates the bpool features:
    - device_rebuild has an explanation of why it is not used.
    - livelist is now used.
    - log_spacemap has been tested, but shares the same explanation as
      spacemap_v2 for why it is not used.

Fixes #204
Closes #126
Closes #205

Thanks: Juri Grabowski <git-commit@jugra.de>
Thanks: Freezed <freezed@users.noreply.github.com>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-12-11 19:14:30 -06:00
Richard Laager
8c5031d63e Revert "Introduce Debian Bullseye root on ZFS howto"
This reverts commit b81a471939.

We clashed while working on this.  The Bullseye HOWTO in the above
commit was not rebased on the current Buster HOWTO, so a lot of its
delta between Buster and Bullseye is improper.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-12-11 19:13:53 -06:00
Juri Grabowski
b81a471939 Introduce Debian Bullseye root on ZFS howto
Based on Buster howto

Co-authored-by: George Melikov <mail@gmelikov.ru>
2021-12-12 00:55:48 +03:00
Hank Barta
95160f34b6 Debian: Update for 2.0.3
/etc/zfs/zed.d/history_event-zfs-list-cacher.sh exists by default.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-12-11 14:52:30 -06:00
Teodor Spæren
30c7752fe4 Add more packages to the APT preference file
When doing `apt upgrade` on my Debian machine, I saw that two packages was being held back. The reason cited was that the names had somewhat changed I think. It is worth noting that I'm running bullseye, so this might not be applicable to buster, which is the version documented here.
2021-11-04 20:19:48 +03:00
Richard Laager
b32a8075a9 Debian: Fix stray whitespace
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2021-10-30 00:47:21 -05:00
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
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
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
ne9z
eae172d920 move to libera.chat (#167)
Signed-off-by: Maurice Zhou <ja@apvc.uk>
2021-05-26 14:14:57 -07: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
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