Commit Graph

79 Commits

Author SHA1 Message Date
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
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
Richard Laager
cbec1d359b Debian: Fix some bad whitespace 2021-02-19 23:44:08 -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
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
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
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
Richard Laager
3dd76f39ec Debian/Ubuntu: Fix os-prober change
This was broken in add1e275fb.

Closes #93

Reported-by: Wojtek Siudzinski <admin@suda.pl>
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-12-18 19:34:37 -06:00
Richard Laager
3d862230eb Debian/Ubuntu: Add some blank lines
The convention here is to add a blank line between commands that
cannot be copied-and-pasted together.  apt is such a command, as it
will eat the input from the paste.
2020-12-12 03:49:41 -06:00
Yvan-Masson
d6674f9871 Fix formatting (literal block) 2020-12-11 03:09:33 -06:00
Yvan-Masson
add1e275fb Ubuntu/Debian: use apt instead of dpkg
In general apt is the preferred way to interact with packages, and I
think in this case there is no need/advantage to use dpkg.

Closes #88

Signed-off-by: Richard Laager <rlaager@wiktel.com>
[Fixed the other two instances too.]
2020-12-09 22:35:42 -06:00
Yvan-Masson
69ef236a3f Fix small formatting issue 2020-12-07 21:35:45 +03:00
Richard Laager
d86f52c207 Debian/Ubuntu: Use /dev/disk/by-uuid
This is how the Ubuntu 20.04 installer configures the ESP to mount at
/boot/efi, so it should be fine to use this convention everywhere.

/dev/md0's /dev/disk/by-uuid entry does not show up immediately, so I
removed the swapon there.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-12-05 17:32:40 -06:00
Richard Laager
a4f8837031 Debian: Use UUID instead of PARTUUID for esp
I don't know why this was different from Ubuntu.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-12-05 17:11:47 -06:00
Richard Laager
c94ee2cae4 Debian/Ubuntu: Configure keyboard & charset
On Ubuntu, console-setup, keyboard-configuration (a dependency of
console-setup), and locales are installed by default.  On Debian, we
need to install them manually.  (We were already doing so for locales.)

I merged the various dpkg-reconfigure lines into one to simplify.  The
order isn't important.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
Reported-by: Robert <technic-take3>
Fixes #59
2020-12-05 16:57:34 -06:00
Mathias Gibbens
7f3d021349 Include the debian security and -updates repos as well in sources.list
Users following the ZFS guide may not realize their system won't
receive important security updates between minor point releases
unless additional configuration is added to sources.list.

Signed-off-by: Mathias Gibbens <mathias@calenhad.com>
2020-11-25 17:17:29 -06:00