]> git.proxmox.com Git - pve-docs.git/blobdiff - pve-installation.adoc
pvedocs-include.php: avoid to use javascript
[pve-docs.git] / pve-installation.adoc
index 8bc9b7d30a6a7e92d9a0fef7262d2ece59b900bb..a3090615e17a33c407dc6b8bcec33832f1847a8f 100644 (file)
@@ -1,22 +1,36 @@
 Installing Proxmox VE
----------------------
+=====================
 include::attributes.txt[]
+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.
+{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. This is the preferred and recommended installation method.
 
-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.
+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.
 
-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
-including a basic network setup. You can get a fully functional system
-within a few minutes, including the following:
+ifndef::wiki[]
+
+include::pve-system-requirements.adoc[]
+
+endif::wiki[]
+
+
+Using the {pve} Installation CD-ROM
+-----------------------------------
+
+Includes the following:
 
 * Complete operating system (Debian Linux, 64-bit)
 * Partition the hard drive with ext4 (alternative ext3 or xfs) or ZFS
@@ -25,11 +39,6 @@ within a few minutes, including the following:
 * Web based management interface
 
 
-Using the {pve} Installation CD-ROM
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This is the preferred and recommended installation method.
-
 NOTE: By default, the complete server is used and all existing data is
 removed.
 
@@ -88,8 +97,7 @@ 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.
+(https://youripaddress:8006).
 
 NOTE: Default login is "root" (realm 'PAM') and the root password is
 defined during the installation process.
@@ -97,7 +105,7 @@ defined during the installation process.
 
 [[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
@@ -121,8 +129,7 @@ system.
 
 `maxvz`::
 
-Define the size of the `data` volume, which is mounted at
-`/var/lib/vz`.
+Define the size of the `data` volume.
 
 `minfree`::
 
@@ -134,10 +141,11 @@ required for lvmthin snapshots).
 
 
 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.
+ZFS uses a lot of memory, so it is best to add additional RAM if you
+want to use ZFS. A good calculation is 4GB plus 1GB RAM for each TB
+RAW disk space.
 
 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
@@ -149,17 +157,20 @@ installation using the following command:
 ifdef::wiki[]
 
 link:/wiki/Install_Proxmox_VE_on_Debian_Jessie[Install Proxmox VE on Debian Jessie]
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-----------------------------------------------------------------------------------
+
+link:/wiki/Install_from_USB_Stick[Install from USB Stick]
+---------------------------------------------------------
 
 endif::wiki[]
 
 ifndef::wiki[]
 
 Install {pve} on Debian
-~~~~~~~~~~~~~~~~~~~~~~~
+-----------------------
 
-{pve} ships as a set of Debian packages, so you can simply install it
-on top of a normal Debian installation.  After configuring the
+{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:
 
 [source,bash]
@@ -168,16 +179,25 @@ apt-get update
 apt-get install proxmox-ve
 ----
 
-You can find a detailed step by step howto on the {pve}
-http://pve.proxmox.com/wiki/Install_Proxmox_VE_on_Debian_Jessie[wiki].
+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.
 
-endif::wiki[]
+You can find a detailed step by step howto on the
+{webwiki-url}Install_Proxmox_VE_on_Debian_Jessie[wiki].
 
+include::pve-usbstick.adoc[]
+
+endif::wiki[]
 
 ifdef::wiki[]
 
 Video Tutorials
-~~~~~~~~~~~~~~~
+---------------
 
 * List of all official tutorials on our
   http://www.youtube.com/proxmoxve[Proxmox VE YouTube Channel]
@@ -188,7 +208,9 @@ Video Tutorials
 
 
 See Also
-~~~~~~~~
+--------
+
+* link:/wiki/System_Requirements[System Requirements]
 
 * link:/wiki/Package_Repositories[Package Repositories]
 
@@ -199,4 +221,3 @@ See Also
 * link:/wiki/Installation:_Tips_and_Tricks[Installation: Tips and Tricks]
 
 endif::wiki[]
-