sysadmin.adoc: improve install docs
authorDietmar Maurer <dietmar@proxmox.com>
Sun, 17 Jan 2016 09:53:35 +0000 (10:53 +0100)
committerDietmar Maurer <dietmar@proxmox.com>
Sun, 17 Jan 2016 09:53:35 +0000 (10:53 +0100)
sysadmin.adoc

index a543e7e..9f0d431 100644 (file)
@@ -223,22 +223,53 @@ 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 if
 functional and error free.
 
-You normally select *Install Proxmox VE* to start the installation. 
-
+You normally select *Install Proxmox VE* to start the installation.
 After that you get prompted to select the target hard disk(s). The
 `Options` button aside lets you select the target file system, and
 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.
+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 asks for basic configuration options like time
+zone and keyboard layout. You also need to specify your email address
+and select a superuser password.
+
+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). {pve} is tested for IE9, Firefox 10
+and higher, and Google Chrome.
 
 
-.Advanced LVM configuration options
-****
+[[advanced_lvm_options]]
+Advanced LVM configuration options
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
 The installer creates a Volume Group (VG) called `pve`, and additional
 Logical Volumes (LVs) called `root`, `data` and `swap`. The size of
 those volumes can be controlled with:
@@ -269,43 +300,21 @@ Define the size of the `data` volume, which is mounted at
 To define the amount of free space left in LVM volume group `pve`.
 16GB is the default if storage available > 128GB, `hdsize/8` otherwise.
 +
-NOTE: LVM requires free space for snapshot creation.
-****
+NOTE: LVM requires free space in the VG for snapshot creation (not
+required for lvmthin snapshots).
 
-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.
 
-.ZFS Performance Tips
-****
+ZFS Performance Tips
+^^^^^^^^^^^^^^^^^^^^
+
 ZFS uses a lot of memory, so it is best to add additional 8-16GB RAM
 if you want to use ZFS.
 
-.Use fast SSD as write cache
-
-ZFS provides the feature to use a fast SSD drive as write cache. The
+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>
-****
-
-The next pages just asks for basic configuration options like time
-zone and keyboard layout. You also need to specify your email address
-and select a superuser password.
-
-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). {pve} is tested for IE9, Firefox 10
-and higher, Google Chrome (latest).
 
 
 Network Configuration