X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=pve-installation.adoc;h=7414359a91045276a338066d86ca077f461e5034;hp=032fd5174903a012eb7867cf260f55ec0427759b;hb=fa281da6cba7182480784a657f6830b39c72a954;hpb=0a37d38ec22cdeefed30fc1838bdddee3c9ade19 diff --git a/pve-installation.adoc b/pve-installation.adoc index 032fd51..7414359 100644 --- a/pve-installation.adoc +++ b/pve-installation.adoc @@ -1,34 +1,48 @@ 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[] -* 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 +include::pve-system-requirements.adoc[] + +endif::wiki[] Using the {pve} Installation CD-ROM -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +----------------------------------- + +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 -This is the preferred and recommended installation method. NOTE: By default, the complete server is used and all existing data is removed. @@ -88,8 +102,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 +110,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 @@ -111,32 +124,40 @@ 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). 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 @@ -148,16 +169,19 @@ 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 +{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: @@ -167,16 +191,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. + +You can find a detailed step by step howto on the +{webwiki-url}Install_Proxmox_VE_on_Debian_Jessie[wiki]. -endif::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] @@ -187,7 +220,9 @@ Video Tutorials See Also -~~~~~~~~ +-------- + +* link:/wiki/System_Requirements[System Requirements] * link:/wiki/Package_Repositories[Package Repositories]