Using the {pve} Installation CD-ROM
-----------------------------------
-You can download the ISO from http://www.proxmox.com. It includes the
-following:
+You can download the ISO from {website}en/downloads.
+It includes the following:
* Complete operating system (Debian Linux, 64-bit)
* Web based management interface for using the toolset
-NOTE: By default, the complete server is used and all existing data is
-removed.
+NOTE: During the installation process, the complete server
+is used by default and all existing data is removed.
-[thumbnail="pve-grub-menu.png"]
+[thumbnail="screenshot/pve-grub-menu.png"]
Please insert the installation CD-ROM, then boot from that
drive. Immediately afterwards you can choose the following menu
Start normal installation.
+TIP: It is possible to only use the keyboard to progress through the
+installation wizard. Buttons can be pressed by pressing down the `ALT`
+key, combined with the underlined character from the respective Button.
+For example, `ALT + N` to press a `Next` button.
+
Install Proxmox VE (Debug mode)::
Start installation in debug mode. It opens a shell console at several
Runs `memtest86+`. This is useful to check if your memory is
functional and error free.
-[thumbnail="pve-select-target-disk.png"]
+[thumbnail="screenshot/pve-select-target-disk.png"]
You normally select *Install Proxmox VE* to start the installation.
After that you get prompted to select the target hard disk(s). The
`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.
+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. Additionally you can set additional options (see
+<<advanced_zfs_options,below>>).
-[thumbnail="pve-select-location.png", float="left"]
+[thumbnail="screenshot/pve-select-location.png", float="left"]
The next page just ask for basic configuration options like your
location, the time zone and keyboard layout. The location is used to
them in rare situations when auto detection fails, or when you want to
use some special keyboard layout not commonly used in your country.
-[thumbnail="pve-set-password.png"]
+[thumbnail="screenshot/pve-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
All those notification mails will be sent to the specified email
address.
-[thumbnail="pve-setup-network.png"]
+[thumbnail="screenshot/pve-setup-network.png"]
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.
-[thumbnail="pve-installation.png", float="left"]
+[thumbnail="screenshot/pve-installation.png", float="left"]
If you press `Next` now, installation starts to format disks, and
copies packages to the target. Please wait until that is finished,
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`.
++
+NOTE: If set to `0`, no `swap` volume will be created.
`maxroot`::
`datasize = hdsize - rootsize - swapsize - minfree`
+
Where `datasize` cannot be bigger than `maxvz`.
++
+NOTE: In case of LVM thin, the `data` pool will only be created if `datasize`
+is bigger than 4GB.
++
+NOTE: If set to `0`, no `data` volume will be created and the storage
+configuration will be adapted accordingly.
`minfree`::
NOTE: LVM requires free space in the VG for snapshot creation (not
required for lvmthin snapshots).
+[[advanced_zfs_options]]
+Advanced ZFS Configuration Options
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The installer creates a ZFS pool `rpool`. When selecting ZFS, no swap space is
+created by default. You can leave some unpartitioned space for swap or create
+a swap zvol after installation, though the latter can lead to problems
+(see <<zfs_swap,ZFS swap notes>>).
+
+`ashift`::
+
+Defines the `ashift` value for the created pool. The `ashift` needs
+to be set at least to the sector-size of the underlying disks (2 to
+the power of `ashift` is the sector-size), or any disk,
+which might be put in the pool (e.g. during replacing a defective disk).
+
+`compress`::
+
+Defines whether compression is enabled for `rpool`.
+
+`checksum`::
+
+Defines which checksumming algorithm should be used for `rpool`.
+
+`copies`::
+
+Defines the `copies` parameter for `rpool`. Check the `zfs(8)` manpage for the
+semantics, and why this does not replace redundancy on disk-level.
+
+`hdsize`::
+
+Defines the total HD size to be used. This way you can save free
+space on the HD(s) for further partitioning (e.g. for creating a swap-partition).
+`hdsize` is only honored for bootable disks, i.e., only the first disk or
+mirror for RAID0, RAID1 or RAID10, and all disks in RAID-Z[123].
+
ZFS Performance Tips
~~~~~~~~~~~~~~~~~~~~
In general, this is not trivial, especially when you use LVM or
ZFS.
-You can find a detailed step by step howto on the
+You can find a detailed step by step how-to guide on the
{webwiki-url}Install_Proxmox_VE_on_Debian_Stretch[wiki].
include::pve-usbstick.adoc[]
projects / pve-docs.git / blobdiff