X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=pve-installation.adoc;h=7e69424d5e34e5e99956f1fa27439d6d4e8897d3;hp=ce11c934bbdbcd2b9af30c74471413a10a228c92;hb=12eb9705ac209cefb35c66d53e4e172ee7c8047e;hpb=a1856f276981975175b3cea76f47915641936326 diff --git a/pve-installation.adoc b/pve-installation.adoc index ce11c93..7e69424 100644 --- a/pve-installation.adoc +++ b/pve-installation.adoc @@ -1,6 +1,5 @@ Installing Proxmox VE ===================== -include::attributes.txt[] ifndef::manvolnum[] :pve-toplevel: endif::manvolnum[] @@ -8,17 +7,19 @@ ifdef::wiki[] :title: Installation endif::wiki[] -{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 +{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. + +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. +within a few minutes. This is the preferred and recommended +installation method. -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. +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[] @@ -30,18 +31,26 @@ endif::wiki[] Using the {pve} Installation CD-ROM ----------------------------------- -Includes the following: +You can download the ISO from http://www.proxmox.com. It includes the +following: -* Complete operating system (Debian Linux, 64-bit, "jessie" for {pve} 4.x) -* Partitioning of the hard drive(s) containing the OS with ext4, ext3, xfs or ZFS -* {pve} Kernel derived from Unbuntu 16.04 LTS with LXC and KVM support -* Complete toolset for administering virtual machines, containers and all necessary resources -* Web based management interface for using the toolset +* 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: @@ -71,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 @@ -83,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. @@ -119,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). @@ -156,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] --------------------------------------------------------- @@ -188,7 +248,7 @@ 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[]