Using the {pve} Installation CD-ROM
-----------------------------------
-You can download the ISO from {website}. 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="screenshot/pve-grub-menu.png"]
`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="screenshot/pve-select-location.png", float="left"]
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[]