mirror of
https://git.proxmox.com/git/pmg-docs
synced 2025-08-15 06:31:32 +00:00
add pmg-installation.adoc
This commit is contained in:
Dietmar Maurer
parent
9cd4e0f5a8
commit
03c03402b9
@ -25,6 +25,8 @@ include::pmg-quick-start.adoc[]
|
||||
|
||||
include::pmg-planning-deployment.adoc[]
|
||||
|
||||
include::pmg-installation.adoc[]
|
||||
|
||||
include::pmgconfig.adoc[]
|
||||
|
||||
// Return to normal title levels.
|
||||
|
||||
184
pmg-installation.adoc
Normal file
184
pmg-installation.adoc
Normal file
@ -0,0 +1,184 @@
|
||||
Installation
|
||||
============
|
||||
|
||||
{pmg} is based on Debian and comes with an installation CD-ROM
|
||||
which includes a complete Debian ("stretch" for version 5.x) system as
|
||||
well as all necessary {pmg} packages.
|
||||
|
||||
The installer just asks you a few questions, then partitions the local
|
||||
disk(s), installs all required packages, and configures the system
|
||||
including a basic network setup. You can get a fully functional system
|
||||
within a few minutes. This is the preferred and recommended
|
||||
installation method.
|
||||
|
||||
Alternatively, {pmg} can be installed on top of an existing Debian
|
||||
system. This option is only recommended for advanced users since
|
||||
it requires more detailed knowledge about {pmg} and Debian.
|
||||
|
||||
Using the {pmg} Installation CD-ROM
|
||||
-----------------------------------
|
||||
|
||||
Includes the following:
|
||||
|
||||
* Complete operating system (Debian Linux, 64-bit)
|
||||
|
||||
* Partitioning of the hard drive(s) containing the operating system
|
||||
with ext4, ext3, xfs or ZFS
|
||||
|
||||
* Linux kernel
|
||||
|
||||
* Postfix MTA, ClamAV, Spamassassin and the {pmg} toolset
|
||||
|
||||
* Web based management interface for using the toolset
|
||||
|
||||
Please insert the installation CD-ROM, then boot from that
|
||||
drive. Immediately afterwards you can choose the following menu
|
||||
options:
|
||||
|
||||
image::images/installer/pmg-grub-menu.png[]
|
||||
|
||||
Install {pmg}::
|
||||
|
||||
Start normal installation.
|
||||
|
||||
Install {pmg} (Debug mode)::
|
||||
|
||||
Start installation in debug mode. It opens a shell console at several
|
||||
installation steps, so that you can debug things if something goes
|
||||
wrong. Please press `CTRL-D` to exit those debug consoles and continue
|
||||
installation. This option is mostly for developers and not meant for
|
||||
general use.
|
||||
|
||||
Rescue Boot::
|
||||
|
||||
This option allows you to boot an existing installation. It searches
|
||||
all attached hard disks and, if it finds an existing installation,
|
||||
boots directly into that disk using the existing Linux kernel. This
|
||||
can be useful if there are problems with the boot block (grub), or the
|
||||
BIOS is unable to read the boot block from the disk.
|
||||
|
||||
Test Memory::
|
||||
|
||||
Runs `memtest86+`. This is useful to check if your memory is
|
||||
functional and error free.
|
||||
|
||||
You normally select *Install {pmg}* to start the installation. First
|
||||
step ist to read our EULA (End User License Agreement).
|
||||
|
||||
image::images/installer/pmg-license-agreement.png[]
|
||||
|
||||
After that you get prompted to select the target hard disk(s).
|
||||
|
||||
NOTE: By default, the complete server is used and all existing data is
|
||||
removed.
|
||||
|
||||
image::images/installer/pmg-select-target-disk.png[]
|
||||
|
||||
The `Options` button lets you select the target file system, which
|
||||
defaults to `ext4`. The installer uses LVM if you select `ext3`,
|
||||
`ext4` or `xfs` as file system, and offers additional option to
|
||||
restrict LVM space (see <<advanced_lvm_options,below>>)
|
||||
|
||||
If you have more than one disk, you can also use ZFS as file system.
|
||||
ZFS supports several software RAID levels, so this is specially useful
|
||||
if you do not have a hardware RAID controller. The `Options` button
|
||||
lets you select the ZFS RAID level, and you can choose disks there.
|
||||
|
||||
The next pages just ask for basic configuration options like time
|
||||
zone and keyboard layout. You also need to specify your email address
|
||||
and superuser (root) password (must have at least 5 characters).
|
||||
|
||||
The last 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 installation.
|
||||
|
||||
If you press `Next` now, installation starts to format disks, and
|
||||
copies packages to the target. Please wait until that is finished,
|
||||
then reboot the server.
|
||||
|
||||
Further configuration is done via the Proxmox web interface. Just
|
||||
point your browser to the IP address given during installation
|
||||
(https://youripaddress:8006).
|
||||
|
||||
NOTE: Default login is "root" and the root password is
|
||||
defined during the installation process.
|
||||
|
||||
|
||||
[[advanced_lvm_options]]
|
||||
Advanced LVM Configuration Options
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
The installer creates a Volume Group (VG) called `pmg`, and additional
|
||||
Logical Volumes (LVs) called `root` and `swap`. The size of
|
||||
those volumes can be controlled with:
|
||||
|
||||
`hdsize`::
|
||||
|
||||
Defines the total HD size to be used. This way you can save free
|
||||
space on the HD for further partitioning (i.e. for an additional PV
|
||||
and VG on the same hard disk that can be used for LVM storage).
|
||||
|
||||
`swapsize`::
|
||||
|
||||
Defines the size of the `swap` volume. The default is the size of the
|
||||
installed memory, minimum 4 GB and maximum 8 GB. The resulting value cannot
|
||||
be greater than `hdsize/8`.
|
||||
|
||||
`maxroot`::
|
||||
|
||||
Defines the maximum size of the `root` volume, which stores the operation
|
||||
system. The maximum limit of the `root` volume size is `hdsize/4`.
|
||||
|
||||
`maxvz`::
|
||||
|
||||
Defines the maximum size of the `data` volume. The actual size of the `data`
|
||||
volume is:
|
||||
+
|
||||
`datasize = hdsize - rootsize - swapsize - minfree`
|
||||
+
|
||||
Where `datasize` cannot be bigger than `maxvz`.
|
||||
|
||||
`minfree`::
|
||||
|
||||
Defines the amount of free space left in LVM volume group `pve`.
|
||||
With more than 128GB storage available the default is 16GB, else `hdsize/8`
|
||||
will be used.
|
||||
+
|
||||
NOTE: LVM requires free space in the VG for snapshot creation (not
|
||||
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
|
||||
RAW disk space.
|
||||
|
||||
ZFS also provides the feature to use a fast SSD drive as write cache. The
|
||||
write cache is called the ZFS Intent Log (ZIL). You can add that after
|
||||
installation using the following command:
|
||||
|
||||
zpool add <pool-name> log </dev/path_to_fast_ssd>
|
||||
|
||||
|
||||
Install {pmg} on Debian
|
||||
-----------------------
|
||||
|
||||
{pmg} ships as a set of Debian packages, so you can install it
|
||||
on top of a normal Debian installation. After configuring the
|
||||
repositories, you need to run:
|
||||
|
||||
[source,bash]
|
||||
----
|
||||
apt-get update
|
||||
apt-get install proxmox-mailgateway
|
||||
----
|
||||
|
||||
Installing on top of an existing Debian installation looks easy, but
|
||||
it presumes that you have correctly installed the base system, and you
|
||||
know how you want to configure and use the local storage. Network
|
||||
configuration is also completely up to you.
|
||||
|
||||
NOTE: In general, this is not trivial, especially when you use LVM or
|
||||
ZFS.
|
||||
Loading…
Reference in New Issue
Block a user