images: run png-cleanup.pl on all and verify on install

[pmg-docs.git] / pmg-installation.adoc

diff --git a/pmg-installation.adoc b/pmg-installation.adoc
index 1d2f7b2c5b330ef22eef64f4c3c493a5e248622a..cc3d7a2073d25e24d6e2abb2a755ac172a825305 100644 (file)
--- a/pmg-installation.adoc
+++ b/pmg-installation.adoc
@@ -48,11 +48,11 @@ TIP: Make sure that booting from the installation medium (for example, USB) is
 enabled in your server's firmware settings. Secure boot needs to be disabled
 when booting an installer prior to {pmg} version 8.1.
 
+[thumbnail="../installer/pmg-grub-menu.png"]
+
 After choosing the correct entry (for example, Boot from USB) the {pmg} menu
 will be displayed, and one of the following options can be selected:
 
-image::images/installer/pmg-grub-menu.png[]
-
 Install {pmg} (Graphical)::
 
 Start normal installation.
@@ -74,6 +74,8 @@ kernel to use the (first) serial port of the machine for in- and output. This
 can be used if the machine is completely headless and only has a serial console
 available.
 
+[thumbnail="../installer/pmg-tui-installer.png"]
+
 Both modes use the same code base for the actual installation process to
 benefit from more than a decade of bug fixes and ensure feature parity.
 
@@ -113,7 +115,8 @@ of errors. Secure Boot must be turned off in the UEFI firmware setup utility to
 run this option.
 
 You normally select *Install {pmg} (Graphical)* to start the installation.
-image::images/installer/pmg-select-target-disk.png[]
+
+[thumbnail="../installer/pmg-select-target-disk.png"]
 
 The first step is to read our EULA (End User License Agreement). Following
 this, you can select the target hard disk(s) for the installation.
@@ -135,7 +138,7 @@ lets you choose the ZFS RAID level and select which disks will be used.
 WARNING: ZFS on top of any hardware RAID is not supported and can result in data
 loss.
 
-image::images/installer/pmg-select-location.png[]
+[thumbnail="../installer/pmg-select-location.png", float="left"]
 
 The next page asks for basic configuration options like your
 location, timezone, and keyboard layout. The location is used to
@@ -144,7 +147,7 @@ The installer is usually able to auto-detect these settings, so you only need to
 change them in rare situations when auto-detection fails, or when you want to
 use a keyboard layout not commonly used in your country.
 
-image::images/installer/pmg-set-password.png[]
+[thumbnail="../installer/pmg-set-password.png"]
 
 You then need to specify an email address and the superuser (root)
 password. The password must have at least 5 characters, but we highly
@@ -168,13 +171,13 @@ example:
 
 All those notification mails will be sent to the specified email address.
 
-image::images/installer/pmg-setup-network.png[]
+[thumbnail="../installer/pmg-setup-network.png"]
 
 The next step is the network configuration. Please note that you can use either
 IPv4 or IPv6 here, but not both. If you want to configure a dual stack node,
 you can easily do that after the installation.
 
-image::images/installer/pmg-summary.png[]
+[thumbnail="../installer/pmg-installation.png", float="left"]
 
 When you press `Next`, you will see an overview of your entered configuration.
 Please re-check every setting, you can still use the `Previous` button to go
@@ -183,7 +186,7 @@ back and edit any settings.
 After clicking `Install`, the installer will begin to format and copy packages
 to the target disk(s).
 
-image::images/installer/pmg-installation.png[]
+[thumbnail="../installer/pmg-summary.png"]
 
 Copying the packages usually takes several minutes. When this is
 finished, you can reboot the server.
@@ -260,16 +263,34 @@ required for lvmthin snapshots).
 ZFS Performance Tips
 ~~~~~~~~~~~~~~~~~~~~
 
-ZFS uses a lot of memory, so it is best to add additional RAM if you
-want to use ZFS. A good calculation is 4GB plus 1GB RAM for each TB
+ZFS works best with a lot of memory. If you intend to use ZFS make sure to have
+enough RAM available for it. A good calculation is 4GB plus 1GB RAM for each TB
 RAW disk space.
 
-ZFS also provides the ability to use a fast SSD drive as write cache. The
-write cache is called the ZFS Intent Log (ZIL). You can add that after
-the installation using the following command:
+ZFS can use a dedicated drive as write cache, called the ZFS Intent Log (ZIL).
+Use a fast drive (SSD) for it. It can be added after installation with the
+following command:
+
+---
+# zpool add <pool-name> log </dev/path_to_fast_ssd>
+---
+
+Adding the `nomodeset` Kernel Parameter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Problems may arise on very old or very new hardware due to graphics drivers. If
+the installation hangs during the boot. In that case, you can try adding the
+`nomodeset` parameter. This prevents the Linux kernel from loading any
+graphics drivers and forces it to continue using the BIOS/UEFI-provided
+framebuffer.
 
- zpool add <pool-name> log </dev/path_to_fast_ssd>
+On the {pmg} bootloader menu, navigate to 'Install {pmg} (Terminal UI)' and
+press `e` to edit the entry. Using the arrow keys, navigate to the line starting
+with `linux`, move the cursor to the end of that line and add the
+parameter `nomodeset`, separated by a space from the pre-existing last
+parameter.
 
+Then press `Ctrl-X` or `F10` to boot the configuration.
 
 [[pmg_install_on_debian]]
 Install {pmg} on Debian