Commit Graph

96 Commits

Author SHA1 Message Date
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
eca3482e2a Update RHEL and CentOS.rst - add CentOS 7.9 repository
Add CentOS 7.9 zfs-release link.

Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov>
2020-11-12 19:18:58 -08:00
Richard Laager
04db2386fd Ubuntu: Fix a typo
Reported-by: donniep
Fixes #71
2020-11-09 19:35:24 -06:00
Soputtra San
7129f378c5 Update Fedora.rst (#69)
Minor update about Fedora Releases, remove eol **30**, add **33**.
2020-11-03 22:21:25 +03:00
Tony Hutter
f29b59da69 Fix Fedora 33 zfs-release link typo 2020-10-28 17:27:46 -07:00
Tony Hutter
ee95e7c761 Update Fedora.rst - add F33, remove F30
Add Fedora 33 zfs-release link, remove EOL'd F30
2020-10-28 17:27:10 -07:00
James Bennett
966ebaa629 Rework FreeBSD start page for newcomer
- Additional instructions to build
- Remove duplicate info about OpenZFS

Co-authored-by: Ryan Moeller <ryan@freqlabs.com>
Co-authored-by: George Melikov <mail@gmelikov.ru>
Signed-off-by: George Melikov <mail@gmelikov.ru>

Apply suggestions from @freqlabs

Co-authored-by: Ryan Moeller <ryan@freqlabs.com>
2020-10-08 19:25:36 +03:00
George Melikov
519ac78dc3 Convert FreeBSD page as is from ZoF repo
Signed-off-by: George Melikov <mail@gmelikov.ru>
2020-10-08 19:25:36 +03:00
Richard Laager
0e030ab146 Ubuntu: Remove zpool_checkpoint from bpool
The docs note that I tested this, but I'm going to remove this, out of
an abundance of caution given the report of failure in #57.  I may re-test
later, but this isn't a huge priority for me.

Fixes #57
2020-09-27 14:17:18 -05: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
Richard Laager
c7534660ee Ubuntu: Flatten bootloader partitioning steps
This makes it easier to follow (and specifically, harder to miss the
second step).

Reported-by: Niall Douglas <ned14>
Issue #54
2020-09-09 15:26:36 -05:00
Richard Laager
f54ea18312 Debian: Skip manual mount of bpool/BOOT/debian
This was missed in 784b3b7a27 which
eliminated the canmount=noauto.  With that gone, it is not necessary to
manually mount bpool/BOOT/debian.

Reported-by: Danny <suavedandy>
2020-09-08 17:04:06 -05:00
Richard Laager
28ccb936b3 Ubuntu: Add a password length warning
If the user gives too short of a password when encryption via a hacked
installer, the installer will crash.  (I haven't personally verified
this, but it sounds plausible.)

Reported-by: Sithuk
Closes: 52
2020-09-08 00:41:04 -05:00
Richard Laager
5523d6cb6b Ubuntu: Fix patch commands
These were missing "sudo".

Reported-by: Sithuk
Issue #52
2020-09-07 00:44:54 -05:00
Richard Laager
08832a3454 Ubuntu 20.04 Pi: Fix Pi 4 B name
There is no 4 B+.
2020-08-31 01:47:45 -05:00
Richard Laager
5b4f4779ea Ubuntu 20.04 Pi: Simplify SD card clearing
Zeroing the entire disk takes a long time.  These steps _should_ be
sufficient.
2020-08-31 01:20:49 -05:00
Richard Laager
51a4f5055e Ubuntu: Add instructions for the Raspberry Pi
I have not tested encryption, but otherwise this works.
2020-08-31 01:12:02 -05:00
Richard Laager
e2d9dcd2ad Debian/Ubuntu: Fix locales formatting 2020-08-31 00:21:38 -05:00
Christian Nassif-Haynes
ceb02668a3 Fix typo
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-08-24 23:09:10 -05:00
Richard Laager
371d3cf08b Debian/Ubuntu: Update pip3 command
This now matches the example in the top-level README.

Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-08-12 17:34:27 -05:00
Karsten Weiss
5c67d3d1fc Spelling fixes 2020-08-02 03:39:10 -05:00
George Melikov
bc36143d46 Fix typo in Debian-on-root man 2020-07-24 23:51:49 -05:00
Richard Laager
ba04f2100c Ubuntu: Fix bug URL
I was linking to the wrong bug (bad copy-and-paste).
2020-07-17 03:54:19 -05:00
Richard Laager
ce83696a66 Ubuntu: Line wrap 2020-07-17 03:54:09 -05:00
Spotlight
ba1752bad9 Specify buster-backports usage
Without buster-backports, everything ZFS is from the buster repository.
Adding this to the Live CD installation instructions allows our initial
pool to be created with newer versions.

Signed-off-by: Spotlight <spotlight@joscomputing.space>
2020-06-26 01:56:15 -05:00
Luca Citi
338b567574 Ubuntu 20.04: Fix rescue instructions
/boot is no longer in /etc/fstab.

Closes: #32
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2020-06-26 01:52:24 -05:00