X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=pve-installation.adoc;h=7e69424d5e34e5e99956f1fa27439d6d4e8897d3;hp=c6e738739389577e1ff36698edc3457d98fbc3a3;hb=8119f671e13272db2d0fd015afb5a4705bc573d4;hpb=b2f242abe4c50227f5610767e6fcaa40654c2b88 diff --git a/pve-installation.adoc b/pve-installation.adoc index c6e7387..7e69424 100644 --- a/pve-installation.adoc +++ b/pve-installation.adoc @@ -1,32 +1,25 @@ 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. +{pve} is based on Debian and comes with an installation CD-ROM +which includes a complete Debian system ("stretch" for version 5.x) as +well as all necessary {pve} packages. -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 +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, {pve} can be installed on top of an existing Debian +system. This option is only recommended for advanced users since +detail knowledge about {pve} is necessary. ifndef::wiki[] @@ -38,11 +31,26 @@ endif::wiki[] Using the {pve} Installation CD-ROM ----------------------------------- -This is the preferred and recommended installation method. +You can download the ISO from http://www.proxmox.com. It includes the +following: + +* Complete operating system (Debian Linux, 64-bit) + +* The {pve} installer, which partitions the hard drive(s) with ext4, + ext3, xfs or ZFS and installs the operating system. + +* {pve} kernel (Linux) 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. +[thumbnail="pve-grub-menu.png"] + Please insert the installation CD-ROM, then boot from that drive. Immediately afterwards you can choose the following menu options: @@ -72,6 +80,8 @@ Test Memory:: Runs `memtest86+`. This is useful to check if your memory is functional and error free. +[thumbnail="pve-select-target-disk.png"] + You normally select *Install Proxmox VE* to start the installation. After that you get prompted to select the target hard disk(s). The `Options` button lets you select the target file system, which @@ -84,14 +94,48 @@ 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 ask for basic configuration options like time -zone and keyboard layout. You also need to specify your email address -and superuser (root) password (must have at least 5 characters). +[thumbnail="pve-select-location.png", float="left"] + +The next page just ask for basic configuration options like your +location, the time zone and keyboard layout. The location is used to +select a download server near you to speedup updates. The installer is +usually able to auto detect those setting, so you only need to change +them in rare situations when auto detection fails, or when you want to +use some special keyboard layout not commonly used in your country. + +[thumbnail="pve-set-password.png"] + +You then need to specify an email address and the superuser (root) +password. The password must have at least 5 characters, but we highly +recommend to use stronger passwords - here are some guidelines: + +- Use a minimum password length of 12 to 14 characters. + +- Include lowercase and uppercase alphabetic characters, numbers and symbols. + +- Avoid character repetition, keyboard patterns, dictionary words, + letter or number sequences, usernames, relative or pet names, + romantic links (current or past) and biographical information (e.g., + ID numbers, ancestors' names or dates). + +It is sometimes necessary to send notification to the system +administrator, for example: + +- Information about available package updates. + +- Error messages from periodic CRON jobs. + +All those notification mails will be sent to the specified email +address. + +[thumbnail="pve-setup-network.png"] 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 dual stack node, you can easily do that after installation. +[thumbnail="pve-installation.png", float="left"] + If you press `Next` now, installation starts to format disks, and copies packages to the target. Please wait until that is finished, then reboot the server. @@ -120,22 +164,37 @@ 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`. ++ +NOTE: If set to `0`, no `swap` volume will be created. `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`. ++ +NOTE: In case of LVM thin, the `data` pool will only be created if `datasize` +is bigger than 4GB. ++ +NOTE: If set to `0`, no `data` volume will be created and the storage +configuration will be adapted accordingly. `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). @@ -157,8 +216,8 @@ installation using the following command: ifdef::wiki[] -link:/wiki/Install_Proxmox_VE_on_Debian_Jessie[Install Proxmox VE on Debian Jessie] ------------------------------------------------------------------------------------ +link:/wiki/Install_Proxmox_VE_on_Debian_Stretch[Install Proxmox VE on Debian Stretch] +------------------------------------------------------------------------------------- link:/wiki/Install_from_USB_Stick[Install from USB Stick] --------------------------------------------------------- @@ -170,7 +229,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: @@ -180,8 +239,16 @@ 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]. +{webwiki-url}Install_Proxmox_VE_on_Debian_Stretch[wiki]. include::pve-usbstick.adoc[]