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.
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.
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.
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"]
The next page asks for basic configuration options like your
location, timezone, and keyboard layout. The location is used 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", float="left"]
You then need to specify an email address and the superuser (root)
password. The password must have at least 5 characters, but we highly
recommend to use stronger passwords - here are some guidelines:
-- Use a minimum password length of 12 to 14 characters.
+- Use a minimum password length of at least 12 characters.
- Include lowercase and uppercase alphabetic characters, numbers and symbols.
- Error messages from periodic cron jobs.
-All those notification mails will be sent to the specified email address.
+[thumbnail="installer/pmg-setup-network.png"]
-image::images/installer/pmg-setup-network.png[]
+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
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
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, mostly depending on the
+speed of the installation medium and the target disk performance.
+
+When copying and setting up the packages has finished, you can reboot the
+server. This will be done automatically after a few seconds by default.
-Copying the packages usually takes several minutes. When this is
-finished, you can reboot the server.
+.Installation Failure
If the installation failed, check out specific errors on the second TTY
(`CTRL + ALT + F2') and ensure that the systems meets the
-xref:install_minimal_requirements[minimum requirements]. If the installation
-is still not working, look at the xref:getting_help[how to get help chapter].
+xref:install_minimal_requirements[minimum requirements].
-Further configuration is done via the {pmg} web interface:
+If the installation is still not working, look at the xref:getting_help[how to
+get help chapter].
-[thumbnail="pmg-gui-login-window.png"]
-. Point your browser to the IP address given during the installation
-(https://youripaddress:8006).
+Accessing the Management Interface Post-Installation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-. Log in and upload your subscription key.
-+
-NOTE: The default login is "root", and the password is the one chosen during the
-installation.
+[thumbnail="screenshot/pmg-gui-login-window.png"]
+
+After a succesful installation and reboot of the system you can use the {pmg}
+web interface for further configuration.
+
+. Point your browser to the IP address given during the installation and port
+ 8006, for example: https://youripaddress:8006
+
+. Log in using the `root` username and the password chosen during installation.
+
+. 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
+ repositories to get updates for security fixes, bug fixes, and new features.
. Check the IP configuration and hostname.
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.
+
+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
Repository Management
^^^^^^^^^^^^^^^^^^^^^
-[thumbnail="pmg-gui-admin-repositories.png"]
+[thumbnail="screenshot/pmg-gui-admin-repositories.png"]
Since {pmg} 7.0 you can check the repository state in the web interface. The
'Dashboard' shows a high level status overview, while the separate 'Repository'