mirror of
https://git.proxmox.com/git/pmg-docs
synced 2025-07-27 13:03:42 +00:00
installation: iso: improve & align wording with pve-docs
Most of the changes are taken from pve-docs to align the exact wording in general, as well as changing a few subtle things to improve the overall reading flow. The equivalent changes will be done for pve-docs too to ensure they are really the same in the end. Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
This commit is contained in:
parent
72b70a0038
commit
2a4f8914f5
@ -1,5 +1,5 @@
|
|||||||
Installation
|
Installing {pmg}
|
||||||
============
|
================
|
||||||
|
|
||||||
{pmg} is based on Debian. This is why the install disk images (ISO files)
|
{pmg} is based on Debian. This is why the install disk images (ISO files)
|
||||||
provided by Proxmox include a complete Debian system as well as all necessary
|
provided by Proxmox include a complete Debian system as well as all necessary
|
||||||
@ -8,11 +8,11 @@ provided by Proxmox include a complete Debian system as well as all necessary
|
|||||||
TIP: See the xref:faq-support-table[support table in the FAQ] for the
|
TIP: See the xref:faq-support-table[support table in the FAQ] for the
|
||||||
relationship between {pmg} releases and Debian releases.
|
relationship between {pmg} releases and Debian releases.
|
||||||
|
|
||||||
The installer will guide you through the setup, allowing you to partition the local
|
The installer will guide you through the setup, allowing you to partition the
|
||||||
disk(s), apply basic system configurations (for example, timezone, language,
|
local disk(s), apply basic system configurations (for example, time zone,
|
||||||
network) and install all required packages. This process should not take more
|
language, network) and install all required packages. This process should not
|
||||||
than a few minutes. Installing with the provided ISO is the recommended method
|
take more than a few minutes. Installing with the provided ISO is the
|
||||||
for new and existing users.
|
recommended method for new and existing users.
|
||||||
|
|
||||||
Alternatively, {pmg} can be installed on top of an existing Debian system. This
|
Alternatively, {pmg} can be installed on top of an existing Debian system. This
|
||||||
option is only recommended for advanced users because detailed knowledge about
|
option is only recommended for advanced users because detailed knowledge about
|
||||||
@ -21,8 +21,8 @@ option is only recommended for advanced users because detailed knowledge about
|
|||||||
include::pmg-installation-media.adoc[]
|
include::pmg-installation-media.adoc[]
|
||||||
|
|
||||||
[[pmg_install_iso]]
|
[[pmg_install_iso]]
|
||||||
Using the {pmg} Installation CD-ROM
|
Using the {pmg} Installer
|
||||||
-----------------------------------
|
-------------------------
|
||||||
|
|
||||||
The installer ISO image includes the following:
|
The installer ISO image includes the following:
|
||||||
|
|
||||||
@ -31,15 +31,15 @@ The installer ISO image includes the following:
|
|||||||
* The {pmg} installer, which partitions the hard drive(s) with ext4,
|
* The {pmg} installer, which partitions the hard drive(s) with ext4,
|
||||||
XFS or ZFS and installs the operating system
|
XFS or ZFS and installs the operating system
|
||||||
|
|
||||||
* Linux kernel
|
* {pmg} Linux kernel
|
||||||
|
|
||||||
* Postfix MTA, ClamAV, Spamassassin and the {pmg} toolset
|
* Postfix MTA, ClamAV, Spamassassin and the {pmg} toolset
|
||||||
|
|
||||||
* Web-based management interface for using the toolset
|
* Web-based management interface for using the toolset
|
||||||
|
|
||||||
NOTE: All existing data on the for installation selected drives will be removed
|
NOTE: All existing data on the selected drives will be removed during the
|
||||||
during the installation process. The installer does not add boot menu entries
|
installation process. The installer does not add boot menu entries for other
|
||||||
for other operating systems.
|
operating systems.
|
||||||
|
|
||||||
Please insert the xref:installation_prepare_media[prepared installation media]
|
Please insert the xref:installation_prepare_media[prepared installation media]
|
||||||
(for example, USB flash drive or CD-ROM) and boot from it.
|
(for example, USB flash drive or CD-ROM) and boot from it.
|
||||||
@ -50,12 +50,12 @@ when booting an installer prior to {pmg} version 8.1.
|
|||||||
|
|
||||||
[thumbnail="installer/pmg-grub-menu.png"]
|
[thumbnail="installer/pmg-grub-menu.png"]
|
||||||
|
|
||||||
After choosing the correct entry (for example, Boot from USB) the {pmg} menu
|
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:
|
will be displayed, and one of the following options can be selected:
|
||||||
|
|
||||||
Install {pmg} (Graphical)::
|
Install {pmg} (Graphical)::
|
||||||
|
|
||||||
Start normal installation.
|
Starts the normal installation.
|
||||||
|
|
||||||
TIP: It's possible to use the installation wizard with a keyboard only. Buttons
|
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
|
can be clicked by pressing the `ALT` key combined with the underlined character
|
||||||
@ -67,13 +67,6 @@ Starts the terminal-mode installation wizard. It provides the same overall
|
|||||||
installation experience as the graphical installer, but has generally better
|
installation experience as the graphical installer, but has generally better
|
||||||
compatibility with very old and very new hardware.
|
compatibility with very old and very new hardware.
|
||||||
|
|
||||||
Install {pmg} (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="installer/pmg-tui-installer.png"]
|
[thumbnail="installer/pmg-tui-installer.png"]
|
||||||
|
|
||||||
Both modes use the same code base for the actual installation process to
|
Both modes use the same code base for the actual installation process to
|
||||||
@ -82,6 +75,13 @@ benefit from more than a decade of bug fixes and ensure feature parity.
|
|||||||
TIP: The 'Terminal UI' option can be used in case the graphical installer does
|
TIP: The 'Terminal UI' option can be used in case the graphical installer does
|
||||||
not work correctly, due to e.g. driver issues.
|
not work correctly, due to e.g. driver issues.
|
||||||
|
|
||||||
|
Install {pmg} (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.
|
||||||
|
|
||||||
Advanced Options: Install {pmg} (Graphical, Debug Mode)::
|
Advanced Options: Install {pmg} (Graphical, Debug Mode)::
|
||||||
|
|
||||||
Starts the installation in debug mode. A console will be opened at several
|
Starts the installation in debug mode. A console will be opened at several
|
||||||
@ -128,63 +128,66 @@ installation.
|
|||||||
The `Options` button lets you select the target file system, which
|
The `Options` button lets you select the target file system, which
|
||||||
defaults to `ext4`. The installer uses LVM if you select
|
defaults to `ext4`. The installer uses LVM if you select
|
||||||
`ext4` or `xfs` as a file system, and offers additional options to
|
`ext4` or `xfs` as a file system, and offers additional options to
|
||||||
restrict LVM space (see <<advanced_lvm_options,below>>)
|
restrict LVM space (see xref:advanced_lvm_options[below]).
|
||||||
|
|
||||||
If you have more than one disk, you can also use ZFS as a file system.
|
{pmg} can also be installed on ZFS. As ZFS offers several software RAID levels,
|
||||||
ZFS supports several software RAID levels, which is particularly useful
|
this is an option for systems that don't have a hardware RAID controller. The
|
||||||
if you do not have a hardware RAID controller. The `Options` button
|
target disks must be selected in the `Options` dialog. More ZFS specific
|
||||||
lets you choose the ZFS RAID level and select which disks will be used.
|
settings can be changed under `Advanced Options`.
|
||||||
|
|
||||||
WARNING: ZFS on top of any hardware RAID is not supported and can result in data
|
WARNING: ZFS on top of any hardware RAID is not supported and can result in data
|
||||||
loss.
|
loss.
|
||||||
|
|
||||||
[thumbnail="installer/pmg-select-location.png"]
|
[thumbnail="installer/pmg-select-location.png"]
|
||||||
|
|
||||||
The next page asks for basic configuration options like your
|
The next page asks for basic configuration options like your location, time
|
||||||
location, timezone, and keyboard layout. The location is used to
|
zone, and keyboard layout. The location is used to select a nearby download
|
||||||
select a nearby download server, in order to increase the speed of updates.
|
server, in order to increase the speed of updates. The installer is usually able
|
||||||
The installer is usually able to auto-detect these settings, so you only need to
|
to auto-detect these settings, so you only need to change them in rare
|
||||||
change them in rare situations when auto-detection fails, or when you want to
|
situations when auto-detection fails, or when you want to use a keyboard layout
|
||||||
use a keyboard layout not commonly used in your country.
|
not commonly used in your country.
|
||||||
|
|
||||||
[thumbnail="installer/pmg-set-password.png", float="left"]
|
[thumbnail="installer/pmg-set-password.png", float="left"]
|
||||||
|
|
||||||
You then need to specify an email address and the superuser (root)
|
Next the password of the superuser (`root`) and an email address needs to be
|
||||||
password. The password must have at least 5 characters, but we highly
|
specified. The password must consist of at least 5 characters. It's highly
|
||||||
recommend to use stronger passwords - here are some guidelines:
|
recommended to use a stronger password. Some guidelines are:
|
||||||
|
|
||||||
- Use a minimum password length of at least 12 characters.
|
- Use a minimum password length of at least 12 characters.
|
||||||
|
|
||||||
- Include lowercase and uppercase alphabetic characters, numbers and symbols.
|
- Include lowercase and uppercase alphabetic characters, numbers and symbols.
|
||||||
|
|
||||||
- Avoid character repetition, keyboard patterns, dictionary words, letter or
|
- Avoid character repetition, keyboard patterns, common dictionary words,
|
||||||
number sequences, usernames, relative or pet names, romantic links (current
|
letter or number sequences, usernames, relative or pet names, romantic links
|
||||||
or past) and biographical information (e.g., ID numbers, ancestors' names or
|
(current or past), and biographical information (for example ID numbers,
|
||||||
dates).
|
ancestors' names or dates).
|
||||||
|
|
||||||
It is sometimes necessary to send notification to the system administrator, for
|
The email address is used to send notifications to the system administrator.
|
||||||
example:
|
For example:
|
||||||
|
|
||||||
- Information about available package updates.
|
- Information about available package updates.
|
||||||
|
|
||||||
- Error messages from periodic cron jobs.
|
- Error messages from periodic 'cron' jobs.
|
||||||
|
|
||||||
[thumbnail="installer/pmg-setup-network.png"]
|
[thumbnail="installer/pmg-setup-network.png"]
|
||||||
|
|
||||||
All those notification mails will be sent to the specified email address.
|
All those notification mails will be sent to the specified email address.
|
||||||
|
|
||||||
The next step is the network configuration. Please note that you can use either
|
The last step is the network configuration. Network interfaces that are 'UP'
|
||||||
IPv4 or IPv6 here, but not both. If you want to configure a dual stack node,
|
show a filled circle in front of their name in the drop down menu. Please note
|
||||||
you can easily do that after the installation.
|
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="installer/pmg-installation.png", float="left"]
|
[thumbnail="installer/pmg-installation.png", float="left"]
|
||||||
|
|
||||||
When you press `Next`, you will see an overview of your entered configuration.
|
The next step shows a summary of the previously selected options. Please
|
||||||
Please re-check every setting, you can still use the `Previous` button to go
|
re-check every setting and use the `Previous` button if a setting needs to be
|
||||||
back and edit any settings.
|
changed.
|
||||||
|
|
||||||
After clicking `Install`, the installer will begin to format and copy packages
|
After clicking `Install`, the installer will begin to format the disks and copy
|
||||||
to the target disk(s).
|
packages to the target disk(s). Please wait until this step has finished; then
|
||||||
|
remove the installation medium and restart your system.
|
||||||
|
|
||||||
[thumbnail="installer/pmg-summary.png"]
|
[thumbnail="installer/pmg-summary.png"]
|
||||||
|
|
||||||
@ -197,7 +200,7 @@ server. This will be done automatically after a few seconds by default.
|
|||||||
.Installation Failure
|
.Installation Failure
|
||||||
|
|
||||||
If the installation failed, check out specific errors on the second TTY
|
If the installation failed, check out specific errors on the second TTY
|
||||||
(`CTRL + ALT + F2') and ensure that the systems meets the
|
('CTRL + ALT + F2') and ensure that the systems meets the
|
||||||
xref:install_minimal_requirements[minimum requirements].
|
xref:install_minimal_requirements[minimum requirements].
|
||||||
|
|
||||||
If the installation is still not working, look at the xref:getting_help[how to
|
If the installation is still not working, look at the xref:getting_help[how to
|
||||||
@ -215,7 +218,8 @@ web interface for further configuration.
|
|||||||
. Point your browser to the IP address given during the installation and port
|
. Point your browser to the IP address given during the installation and port
|
||||||
8006, for example: https://youripaddress:8006
|
8006, for example: https://youripaddress:8006
|
||||||
|
|
||||||
. Log in using the `root` username and the password chosen during installation.
|
. Log in using the `root` (realm 'PAM') username and the password chosen during
|
||||||
|
installation.
|
||||||
|
|
||||||
. Upload your subscription key to gain access to the Enterprise repository.
|
. Upload your subscription key to gain access to the Enterprise repository.
|
||||||
Otherwise, you will need to set up one of the public, less tested package
|
Otherwise, you will need to set up one of the public, less tested package
|
||||||
|
Loading…
Reference in New Issue
Block a user