[pve-devel] [RFC PATCH docs-common 04/13] partials: installation-flow: adapt from pve-docs
Christoph Heiss
c.heiss at proxmox.com
Fri Apr 19 11:05:10 CEST 2024
A trivial s/{pve}/{product}/g again and a additional
s/screenshot\/pve-/screenshot\//g to fix the screenshot paths.
Signed-off-by: Christoph Heiss <c.heiss at proxmox.com>
---
partials/installation-flow.adoc | 47 +++++++++++++++++----------------
1 file changed, 24 insertions(+), 23 deletions(-)
diff --git a/partials/installation-flow.adoc b/partials/installation-flow.adoc
index b796676..9a7d1b3 100644
--- a/partials/installation-flow.adoc
+++ b/partials/installation-flow.adoc
@@ -7,14 +7,14 @@ Please insert the xref:installation_prepare_media[prepared installation media]
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 {pve} version 8.1.
+when booting an installer prior to {product} version 8.1.
-[thumbnail="screenshot/pve-grub-menu.png"]
+[thumbnail="screenshot/grub-menu.png"]
-After choosing the correct entry (for example, 'Boot from USB') the {pve} menu
-will be displayed, and one of the following options can be selected:
+After choosing the correct entry (for example, 'Boot from USB') the {product}
+menu will be displayed, and one of the following options can be selected:
-Install {pve} (Graphical)::
+Install {product} (Graphical)::
Starts the normal installation.
@@ -22,20 +22,20 @@ TIP: It's possible to use the installation wizard with a keyboard only. Buttons
can be clicked by pressing the `ALT` key combined with the underlined character
from the respective button. For example, `ALT + N` to press a `Next` button.
-Install {pve} (Terminal UI)::
+Install {product} (Terminal UI)::
Starts the terminal-mode installation wizard. It provides the same overall
installation experience as the graphical installer, but has generally better
compatibility with very old and very new hardware.
-Install {pve} (Terminal UI, Serial Console)::
+Install {product} (Terminal UI, Serial Console)::
Starts the terminal-mode installation wizard, additionally setting up the Linux
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="screenshot/pve-tui-installer.png"]
+[thumbnail="screenshot/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.
@@ -44,21 +44,21 @@ TIP: The 'Terminal UI' option can be used in case the graphical installer does
not work correctly, due to e.g. driver issues. See also
xref:nomodeset_kernel_param[adding the `nomodeset` kernel parameter].
-Advanced Options: Install {pve} (Graphical, Debug Mode)::
+Advanced Options: Install {product} (Graphical, Debug Mode)::
Starts the installation in debug mode. A console will be opened at several
installation steps. This helps to debug the situation if something goes wrong.
To exit a debug console, press `CTRL-D`. This option can be used to boot a live
system with all basic tools available. You can use it, for example, to
xref:chapter_zfs[repair a degraded ZFS 'rpool'] or fix the
-xref:sysboot[bootloader] for an existing {pve} setup.
+xref:sysboot[bootloader] for an existing {product} setup.
-Advanced Options: Install {pve} (Terminal UI, Debug Mode)::
+Advanced Options: Install {product} (Terminal UI, Debug Mode)::
Same as the graphical debug mode, but preparing the system to run the
terminal-based installer instead.
-Advanced Options: Install {pve} (Serial Console Debug Mode)::
+Advanced Options: Install {product} (Serial Console Debug Mode)::
Same the terminal-based debug mode, but additionally sets up the Linux kernel to
use the (first) serial port of the machine for in- and output.
@@ -77,9 +77,9 @@ Runs `memtest86+`. This is useful to check if the memory is functional and free
of errors. Secure Boot must be turned off in the UEFI firmware setup utility to
run this option.
-You normally select *Install {pve} (Graphical)* to start the installation.
+You normally select *Install {product} (Graphical)* to start the installation.
-[thumbnail="screenshot/pve-select-target-disk.png"]
+[thumbnail="screenshot/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.
@@ -93,15 +93,16 @@ defaults to `ext4`. The installer uses LVM if you select
`ext4` or `xfs` as a file system, and offers additional options to
restrict LVM space (see xref:advanced_lvm_options[below]).
-{pve} can also be installed on ZFS. As ZFS offers several software RAID levels,
-this is an option for systems that don't have a hardware RAID controller. The
-target disks must be selected in the `Options` dialog. More ZFS specific
-settings can be changed under xref:advanced_zfs_options[`Advanced Options`].
+{product} can also be installed on ZFS. As ZFS offers several software RAID
+levels, this is an option for systems that don't have a hardware RAID
+controller. The target disks must be selected in the `Options` dialog. More ZFS
+specific settings can be changed under
+xref:advanced_zfs_options[`Advanced Options`].
WARNING: ZFS on top of any hardware RAID is not supported and can result in data
loss.
-[thumbnail="screenshot/pve-select-location.png"]
+[thumbnail="screenshot/select-location.png"]
The next page asks for basic configuration options like your location, time
zone, and keyboard layout. The location is used to select a nearby download
@@ -110,7 +111,7 @@ 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.
-[thumbnail="screenshot/pve-set-password.png", float="left"]
+[thumbnail="screenshot/set-password.png", float="left"]
Next the password of the superuser (`root`) and an email address needs to be
specified. The password must consist of at least 5 characters. It's highly
@@ -132,7 +133,7 @@ For example:
- Error messages from periodic 'cron' jobs.
-[thumbnail="screenshot/pve-setup-network.png"]
+[thumbnail="screenshot/setup-network.png"]
All those notification mails will be sent to the specified email address.
@@ -142,7 +143,7 @@ that during installation you can either specify an IPv4 or IPv6 address, but not
both. To configure a dual stack node, add additional IP addresses after the
installation.
-[thumbnail="screenshot/pve-installation.png", float="left"]
+[thumbnail="screenshot/installation.png", float="left"]
The next step shows a summary of the previously selected options. Please
re-check every setting and use the `Previous` button if a setting needs to be
@@ -152,7 +153,7 @@ After clicking `Install`, the installer will begin to format the disks and copy
packages to the target disk(s). Please wait until this step has finished; then
remove the installation medium and restart your system.
-[thumbnail="screenshot/pve-install-summary.png"]
+[thumbnail="screenshot/install-summary.png"]
Copying the packages usually takes several minutes, mostly depending on the
speed of the installation medium and the target disk performance.
--
2.44.0
More information about the pve-devel
mailing list