X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=pve-installation.adoc;h=7414359a91045276a338066d86ca077f461e5034;hp=8321992550b7d5e161cd1b13107241e9406a6f66;hb=e8503c6cca8466168efc1128963dff2c7cda660f;hpb=5c6cf7acdac03f9b9d06779dbcbbd0e238d9cda7 diff --git a/pve-installation.adoc b/pve-installation.adoc index 8321992..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 ----------------------------------- -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. @@ -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. @@ -111,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). @@ -161,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: @@ -171,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]. @@ -194,6 +222,8 @@ Video Tutorials See Also -------- +* link:/wiki/System_Requirements[System Requirements] + * link:/wiki/Package_Repositories[Package Repositories] * link:/wiki/Host_System_Administration[Host System Administration]