X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=pve-installation.adoc;h=8726ef98bea136f4451baa7a2ad7bd92ee031db5;hp=28e86aad6c1c66d3aff4e98a4c6301f5158e3630;hb=0d1b9a161a2277dfc19e61617e8f83f201b4fe79;hpb=f77a3c104e3611ff0d42822a5300a12951b9d78e diff --git a/pve-installation.adoc b/pve-installation.adoc index 28e86aa..8726ef9 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. @@ -59,7 +73,7 @@ BIOS is unable to read the boot block from the disk. Test Memory:: -Runs `memtest86+`. This is useful to check if your memory if +Runs `memtest86+`. This is useful to check if your memory is functional and error free. You normally select *Install Proxmox VE* to start the installation. @@ -74,9 +88,9 @@ 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 +The next pages just ask for basic configuration options like time zone and keyboard layout. You also need to specify your email address -and select a superuser password. +and superuser (root) password (must have at least 5 characters). 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 @@ -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 @@ -121,8 +134,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 +146,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 +162,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 +184,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 +213,9 @@ Video Tutorials See Also -~~~~~~~~ +-------- + +* link:/wiki/System_Requirements[System Requirements] * link:/wiki/Package_Repositories[Package Repositories] @@ -199,4 +226,3 @@ See Also * link:/wiki/Installation:_Tips_and_Tricks[Installation: Tips and Tricks] endif::wiki[] -