Commit Graph

390 Commits

Author SHA1 Message Date
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
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
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
jumbi77
3799dc4ff7 Update OpenZFS Exceptions
Although openzfs/zfs is the new default repo and the OpenZFS patch
exceptions are obsolete, the list should be as accurate as possible.
2020-12-23 15:15:23 -08: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
Brian Behlendorf
5acc40912c Update CentOS/Fedora zfs-release package links
Move the CentOS/Fedora release packages to a secure https address
at the official zfsonlinux.org domain.

Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov>
2020-12-18 13:20:44 -08:00
Tru Huynh
627b9b814f Update RHEL and CentOS.rst (#91)
fixing 8.2 -> 8.3 for current CentOS-8 release
2020-12-15 09:39:46 -08:00
Tony Hutter
facf600a32 "EL8.2 Package" -> "EL8.3 Package" 2020-12-14 13:31:04 -08:00
Tony Hutter
148e979f91 Add missing archived el8_2 link 2020-12-14 13:29:50 -08:00
Tony Hutter
35525a14fe Add Centos 8.3 zfs-release for zfs-0.8.6 2020-12-14 13:28:42 -08:00
Richard Laager
e08d1c19ef Ubuntu Pi: Fix a formatting syntax error 2020-12-12 03:53:49 -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
Richard Laager
6bfb226bf0 Ubuntu: Drop gdm InitialSetupEnable=false
I can't remember why this was added and it does not seem to be particularly
necessary.
2020-12-12 03:46:14 -06:00
Richard Laager
e536ce98a0 Ubuntu: Drop dd ... of=/dev/stdout
This does not make any sense to me.  dd outputs to stdout by default.
2020-12-12 03:42:26 -06:00
Richard Laager
b0506fe2ae Ubuntu: Fix a formatting mistake 2020-12-12 03:40:19 -06:00
Richard Laager
cd896b85b5 Ubuntu: Stop enabling universe in Live CD
It is not necessary to enable universe in the Live CD. zfs-initramfs is
in main these days.

I left universe (and multiverse) enabled in the installed system.
People who care can customize.
2020-12-12 03:34:50 -06:00
Richard Laager
e4cc9f9799 Ubuntu: Set autotrim=on
The Ubuntu installer sets this.
2020-12-12 03:34:17 -06:00
Esteban Flores
0e42253039 Fixed small typo
Fixed small typo, missing "i" in either "After installing the *zfs-release* package and verifying the public key
users can opt to install `either` the DKMS or..."
2020-12-11 18:09:55 -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
44170fdbd5 Ubuntu: Go back to bpool/grub
For a mirror or raidz topology, /boot/grub is on a separate dataset.
This was originally bpool/grub, then changed on 2020-05-30 to
bpool/BOOT/ubuntu_UUID/grub to work-around zsys setting canmount=off
which would result in /boot/grub not mounting.  This work-around lead
to issues with snapshot restores. The underlying zsys issue
ubuntu/zsys#164 was fixed and backported to 20.04, so it is now back to
being bpool/grub.

This reverts commit b6fd009edd.  It
conceptually reverts the errata notes from commit
04d3c1cee4, but includes new steps for
people in the pre-2020-05-30 state.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
Fixes #55
2020-12-05 18:22:34 -06:00
Richard Laager
eb05d5b190 Ubuntu: Remove canmount=noauto on / and /boot
I think (but am not absolutely certain) that things behave as follows:

- The non-zsys initramfs script expects canmount=noauto for the root
  filesystem.  It then mounts the active one (e.g. in the case of
  clones) manually, overriding that.
- zsys manages the canmount attribute.

I am sure that when the system boots with zsys, the initial datasets,
which were created with canmount=noauto, have canmount=on.

Therefore, there seems to be no reason to set canmount=noauto for the
zsys scenario, and I have removed it.  This simplifies the instructions
and may avoid issues like #73.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
Fixes #73
2020-12-05 17:53:27 -06:00
Richard Laager
19ce5874b7 Ubuntu: Use grub-efi-amd64's multiple disk code
Ubuntu 20.04's GRUB supports multiple EFI disks.  There is a small
caveat in that it doesn't prompt in the chroot, but it works fine after
the reboot.  Using the stock support means that the ESPs will be kept in
sync automatically.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
Refs issue #55
2020-12-05 17:44:13 -06:00
Richard Laager
f1a7f4ef62 Ubuntu: Use "defaults" for /boot/efi
This matches the 20.04 installer.

Also, disable fsck, because that's what the installer does.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-12-05 17:33:13 -06: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
Richard Laager
605463d8dd Ubuntu: Update URL for 20.04.1
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-12-05 16:35:49 -06:00
Richard Laager
84417c52db Ubuntu: bpool must be named bpool
Fixes #85
Reported-by: Bob Ziuchkovski <bob.ziuchkovski@gmail.com>
2020-11-30 00:42:06 -06:00
Brian Behlendorf
1a774f7dd9 Update RHEL/CentOS install documentation
Refresh the documentation to more clear and to account for changes
for made in the recent RHEL/CentOS releases.

- Replaced most ZFS on Linux references with OpenZFS.

- Condensed the list of repositories and made it clear which repos
  are updated with new packages and which had been archived.

- Added separate instructions for RHEL/CentOS 6,7 and for RHEL/CentOS
  8 and newer since the package manager was changes from yum to dnf.

- Recommend using `yum-config-manager` or `dnf config-manager` rather
  than manually modifing the zfs.repo file.

- Converted the important notices to "notes" and reworded them.  The
  exact commands in the documention were also for much older versions
  of ZFS and were removed entirely.  This should be less of an issue
  with more modern releases.

- Add a comment explaining the modules are automatically loaded
  when a pool is detected, but they can always be loaded at boot
  time by creating a /etc/modules-load.d/zfs.conf file.

Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov>
2020-11-26 22:24:15 +03:00
Brian Behlendorf
2aa6fd156d Update Fedora install documentation
Refresh the documentation to more clear and to account for changes
for made in the recent Fedora releases.

- Replaced most ZFS on Linux references with OpenZFS.

- Reworded kernel compatibility note and link directly to the
  latest supported OpenZFS release to make it easy to check the
  maximum supported kernel version.

- Removed the kernel-devel package from the dnf install command.
  The pacakge is now correctly brought in as a dkms dependency.

- Add a comment explaining the modules are automatically loaded
  when a pool is detected, but they can always be loaded at boot
  time by creating a /etc/modules-load.d/zfs.conf file.

Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov>
2020-11-26 11:46:08 +03: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
Brian Behlendorf
cadc18c97b Update dRAID documentation (#78)
Refresh the dRAID documentation page to accurately reflect the
implementation of dRAID which has been merged.

Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov>
2020-11-25 13:51:48 -08:00
Brian Behlendorf
f7ee059f28 Update OpenZFS module parameters (#76)
- Renamed the page to "Module Parameter" since it now applies
  equally to Linux and FreeBSD.

- Updated spl_kmem_cache_expire, spl_kmem_cache_obj_per_slab_min,
  spl_kmem_cache_kmem_limit to note the last version they were
  included in.

- Added new l2arc_mfuonly, l2arc_rebuild_blocks_min_l2size,
  l2arc_rebuild_enabled, and l2arc_trim_ahead options which
  were added in OpenZFS 2.0 for the persistent L2ARC feature.

Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov>
2020-11-25 09:42:02 -08:00
AJ Jordan
40e194d6fc s/ZFS on Linux/OpenZFS/ in build docs 2020-11-22 22:13:30 +03:00
AJ Jordan
9ef3c08880 Remove references to separate SPL repository 2020-11-22 22:13:30 +03:00