X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=pve-installation.adoc;h=7414359a91045276a338066d86ca077f461e5034;hp=0ca70dc7bd93afab1f43a80d28f47f77e85e8f83;hb=fa281da6cba7182480784a657f6830b39c72a954;hpb=cb84ed187ad45a94ab9f1c2c0b8139f65bfeab26

diff --git a/pve-installation.adoc b/pve-installation.adoc
index 0ca70dc..7414359 100644
--- a/pve-installation.adoc
+++ b/pve-installation.adoc
@@ -1,33 +1,23 @@
 Installing Proxmox VE
 =====================
-include::attributes.txt[]
-
-ifdef::wiki[]
+ifndef::manvolnum[]
 :pve-toplevel:
+endif::manvolnum[]
+ifdef::wiki[]
 :title: Installation
 endif::wiki[]
 
-{pve} ships as a set of Debian packages, so you can simply install it
-on top of a normal Debian installation, or download the installation
-CD-ROM and use that to install {pve} on your hardware.
-
-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.
-
-In general, this is not trivial, especially when you use LVM or
-ZFS. This is why we provide an installation CD-ROM for {pve}. That
-installer just ask you a few questions, then partitions the local
-disk(s), installs all required packages and configures the system
+{pve} is based on Debian and comes with an installation CD-ROM 
+which includes a complete Debian ("jessie" for Proxmox VE 4.x) system as 
+well as all necessary Proxmox VE 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, including the following:
+within a few minutes. This is the preferred and recommended installation method.
 
-* Complete operating system (Debian Linux, 64-bit)
-* Partition the hard drive with ext4 (alternative ext3 or xfs) or ZFS
-* {pve} Kernel with LXC and KVM support
-* Complete toolset
-* Web based management interface
+Alternatively, Proxmox VE can be installed on top of an existing Debian system. 
+This option is only recommended for advanced users since detail knowledge about 
+Proxmox VE is necessary.
 
 ifndef::wiki[]
 
@@ -39,7 +29,20 @@ endif::wiki[]
 Using the {pve} Installation CD-ROM
 -----------------------------------
 
-This is the preferred and recommended installation method.
+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
+
+* {pve} kernel with LXC and KVM support
+
+* Complete toolset for administering virtual machines, containers and
+  all necessary resources
+
+* Web based management interface for using the toolset
+
 
 NOTE: By default, the complete server is used and all existing data is
 removed.
@@ -121,22 +124,29 @@ and VG on the same hard disk that can be used for LVM storage).
 
 `swapsize`::
 
-To define the size of the `swap` volume. Default is the same size as
-installed RAM, with 4GB minimum and `hdsize/8` as maximum.
+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`::
 
-The `root` volume size. The `root` volume stores the whole operation
-system.
+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`::
 
-Define the size of the `data` volume.
+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`::
 
-To define the amount of free space left in LVM volume group `pve`.
-16GB is the default if storage available > 128GB, `hdsize/8` otherwise.
+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).
@@ -171,7 +181,7 @@ ifndef::wiki[]
 Install {pve} on Debian
 -----------------------
 
-{pve} ships as a set of Debian packages, so you can simply install it
+{pve} 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:
 
@@ -181,6 +191,14 @@ apt-get update
 apt-get install proxmox-ve
 ----
 
+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.
+
+In general, this is not trivial, especially when you use LVM or
+ZFS.
+
 You can find a detailed step by step howto on the
 {webwiki-url}Install_Proxmox_VE_on_Debian_Jessie[wiki].