Fixed typo in Ceph Metadata Server documentation

[pve-docs.git] / pve-installation.adoc

diff --git a/pve-installation.adoc b/pve-installation.adoc
index 056ce6ecc98b0d9020af70636b2cc9c50396f7b1..775bb84d4f2c0f8bd30a184d502dfc1523b08cd1 100644 (file)
--- a/pve-installation.adoc
+++ b/pve-installation.adoc
@@ -31,8 +31,8 @@ endif::wiki[]
 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)
 
@@ -46,8 +46,8 @@ following:
 
 * 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"]
 
@@ -62,7 +62,7 @@ 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.
-E.g., `ALT + N` to press a `Next` button.
+For example, `ALT + N` to press a `Next` button.
 
 Install Proxmox VE (Debug mode)::
 
@@ -94,10 +94,11 @@ 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.
+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"]
 
@@ -204,6 +205,41 @@ will be used.
 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
 ~~~~~~~~~~~~~~~~~~~~
@@ -252,7 +288,7 @@ configuration is also completely up to you.
 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[]