Commit Graph

75 Commits

Author SHA1 Message Date
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
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
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
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
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
Richard Laager
180dedbe6f Debian/Ubuntu: Add a hint about multi-disk setups 2022-04-21 23:31:54 -05: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
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
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
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
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
Mathias Gibbens
9ed82cda6e Fix pip3 install command for Debian-based distros
Signed-off-by: Mathias Gibbens <mathias@calenhad.com>
2020-11-25 17:17:29 -06:00
George Melikov
a12e60f437 Use mailing lists anchor everywhere 2020-09-21 19:28:09 +03:00
XnTry
49c255e480 Fix typo for mirrored rpool creation
This was a copy-and-paste from the mirror bpool commands that was not
updated.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
Fixes #53
2020-09-09 17:59:37 -05:00