]>
Commit | Line | Data |
---|---|---|
e71b5d0d | 1 | Installing Proxmox VE |
6b5fc47b | 2 | ===================== |
194d2f29 | 3 | ifndef::manvolnum[] |
5f09af76 | 4 | :pve-toplevel: |
194d2f29 DM |
5 | endif::manvolnum[] |
6 | ifdef::wiki[] | |
cb84ed18 | 7 | :title: Installation |
5f09af76 DM |
8 | endif::wiki[] |
9 | ||
2d99ce9b DM |
10 | {pve} is based on Debian and comes with an installation CD-ROM |
11 | which includes a complete Debian system ("stretch" for version 5.x) as | |
12 | well as all necessary {pve} packages. | |
13 | ||
14 | The installer just asks you a few questions, then partitions the local | |
115aef16 | 15 | disk(s), installs all required packages, and configures the system |
d91f8c1e | 16 | including a basic network setup. You can get a fully functional system |
2d99ce9b DM |
17 | within a few minutes. This is the preferred and recommended |
18 | installation method. | |
d91f8c1e | 19 | |
2d99ce9b DM |
20 | Alternatively, {pve} can be installed on top of an existing Debian |
21 | system. This option is only recommended for advanced users since | |
22 | detail knowledge about {pve} is necessary. | |
d91f8c1e | 23 | |
bc1c71d4 DM |
24 | ifndef::wiki[] |
25 | ||
26 | include::pve-system-requirements.adoc[] | |
27 | ||
28 | endif::wiki[] | |
29 | ||
5eba0743 | 30 | |
d91f8c1e | 31 | Using the {pve} Installation CD-ROM |
6b5fc47b | 32 | ----------------------------------- |
d91f8c1e | 33 | |
91ef956f | 34 | You can download the ISO from {website}. It includes the |
2d99ce9b | 35 | following: |
115aef16 | 36 | |
e69c1847 DM |
37 | * Complete operating system (Debian Linux, 64-bit) |
38 | ||
2d99ce9b DM |
39 | * The {pve} installer, which partitions the hard drive(s) with ext4, |
40 | ext3, xfs or ZFS and installs the operating system. | |
e69c1847 | 41 | |
2d99ce9b | 42 | * {pve} kernel (Linux) with LXC and KVM support |
e69c1847 DM |
43 | |
44 | * Complete toolset for administering virtual machines, containers and | |
45 | all necessary resources | |
46 | ||
a1856f27 | 47 | * Web based management interface for using the toolset |
115aef16 | 48 | |
078924cd DM |
49 | NOTE: By default, the complete server is used and all existing data is |
50 | removed. | |
51 | ||
1ff5e4e8 | 52 | [thumbnail="screenshot/pve-grub-menu.png"] |
2d99ce9b | 53 | |
d91f8c1e DM |
54 | Please insert the installation CD-ROM, then boot from that |
55 | drive. Immediately afterwards you can choose the following menu | |
56 | options: | |
57 | ||
58 | Install Proxmox VE:: | |
59 | ||
60 | Start normal installation. | |
61 | ||
62 | Install Proxmox VE (Debug mode):: | |
63 | ||
64 | Start installation in debug mode. It opens a shell console at several | |
65 | installation steps, so that you can debug things if something goes | |
66 | wrong. Please press `CTRL-D` to exit those debug consoles and continue | |
67 | installation. This option is mostly for developers and not meant for | |
68 | general use. | |
69 | ||
70 | Rescue Boot:: | |
71 | ||
72 | This option allows you to boot an existing installation. It searches | |
f77a3c10 | 73 | all attached hard disks and, if it finds an existing installation, |
d91f8c1e DM |
74 | boots directly into that disk using the existing Linux kernel. This |
75 | can be useful if there are problems with the boot block (grub), or the | |
76 | BIOS is unable to read the boot block from the disk. | |
77 | ||
78 | Test Memory:: | |
79 | ||
d7495642 | 80 | Runs `memtest86+`. This is useful to check if your memory is |
d91f8c1e DM |
81 | functional and error free. |
82 | ||
1ff5e4e8 | 83 | [thumbnail="screenshot/pve-select-target-disk.png"] |
2d99ce9b | 84 | |
d91f8c1e DM |
85 | You normally select *Install Proxmox VE* to start the installation. |
86 | After that you get prompted to select the target hard disk(s). The | |
8e4bb261 | 87 | `Options` button lets you select the target file system, which |
8c1189b6 FG |
88 | defaults to `ext4`. The installer uses LVM if you select `ext3`, |
89 | `ext4` or `xfs` as file system, and offers additional option to | |
d91f8c1e DM |
90 | restrict LVM space (see <<advanced_lvm_options,below>>) |
91 | ||
92 | If you have more than one disk, you can also use ZFS as file system. | |
93 | ZFS supports several software RAID levels, so this is specially useful | |
94 | if you do not have a hardware RAID controller. The `Options` button | |
95 | lets you select the ZFS RAID level, and you can choose disks there. | |
96 | ||
1ff5e4e8 | 97 | [thumbnail="screenshot/pve-select-location.png", float="left"] |
2d99ce9b DM |
98 | |
99 | The next page just ask for basic configuration options like your | |
100 | location, the time zone and keyboard layout. The location is used to | |
101 | select a download server near you to speedup updates. The installer is | |
102 | usually able to auto detect those setting, so you only need to change | |
103 | them in rare situations when auto detection fails, or when you want to | |
104 | use some special keyboard layout not commonly used in your country. | |
105 | ||
1ff5e4e8 | 106 | [thumbnail="screenshot/pve-set-password.png"] |
2d99ce9b DM |
107 | |
108 | You then need to specify an email address and the superuser (root) | |
109 | password. The password must have at least 5 characters, but we highly | |
110 | recommend to use stronger passwords - here are some guidelines: | |
111 | ||
112 | - Use a minimum password length of 12 to 14 characters. | |
113 | ||
114 | - Include lowercase and uppercase alphabetic characters, numbers and symbols. | |
115 | ||
116 | - Avoid character repetition, keyboard patterns, dictionary words, | |
117 | letter or number sequences, usernames, relative or pet names, | |
118 | romantic links (current or past) and biographical information (e.g., | |
119 | ID numbers, ancestors' names or dates). | |
120 | ||
121 | It is sometimes necessary to send notification to the system | |
122 | administrator, for example: | |
123 | ||
124 | - Information about available package updates. | |
125 | ||
126 | - Error messages from periodic CRON jobs. | |
127 | ||
128 | All those notification mails will be sent to the specified email | |
129 | address. | |
130 | ||
1ff5e4e8 | 131 | [thumbnail="screenshot/pve-setup-network.png"] |
d91f8c1e DM |
132 | |
133 | The last step is the network configuration. Please note that you can | |
134 | use either IPv4 or IPv6 here, but not both. If you want to configure a | |
135 | dual stack node, you can easily do that after installation. | |
136 | ||
1ff5e4e8 | 137 | [thumbnail="screenshot/pve-installation.png", float="left"] |
2d99ce9b | 138 | |
d91f8c1e DM |
139 | If you press `Next` now, installation starts to format disks, and |
140 | copies packages to the target. Please wait until that is finished, | |
141 | then reboot the server. | |
142 | ||
143 | Further configuration is done via the Proxmox web interface. Just | |
144 | point your browser to the IP address given during installation | |
69255fd2 | 145 | (https://youripaddress:8006). |
d91f8c1e | 146 | |
fe6c04d5 DM |
147 | NOTE: Default login is "root" (realm 'PAM') and the root password is |
148 | defined during the installation process. | |
149 | ||
d91f8c1e DM |
150 | |
151 | [[advanced_lvm_options]] | |
5eba0743 | 152 | Advanced LVM Configuration Options |
6b5fc47b | 153 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
d91f8c1e DM |
154 | |
155 | The installer creates a Volume Group (VG) called `pve`, and additional | |
156 | Logical Volumes (LVs) called `root`, `data` and `swap`. The size of | |
157 | those volumes can be controlled with: | |
158 | ||
159 | `hdsize`:: | |
160 | ||
161 | Defines the total HD size to be used. This way you can save free | |
162 | space on the HD for further partitioning (i.e. for an additional PV | |
163 | and VG on the same hard disk that can be used for LVM storage). | |
164 | ||
165 | `swapsize`:: | |
166 | ||
fa281da6 TL |
167 | Defines the size of the `swap` volume. The default is the size of the |
168 | installed memory, minimum 4 GB and maximum 8 GB. The resulting value cannot | |
169 | be greater than `hdsize/8`. | |
e8fe2b1b FG |
170 | + |
171 | NOTE: If set to `0`, no `swap` volume will be created. | |
d91f8c1e DM |
172 | |
173 | `maxroot`:: | |
174 | ||
fa281da6 TL |
175 | Defines the maximum size of the `root` volume, which stores the operation |
176 | system. The maximum limit of the `root` volume size is `hdsize/4`. | |
d91f8c1e DM |
177 | |
178 | `maxvz`:: | |
179 | ||
fa281da6 TL |
180 | Defines the maximum size of the `data` volume. The actual size of the `data` |
181 | volume is: | |
182 | + | |
183 | `datasize = hdsize - rootsize - swapsize - minfree` | |
184 | + | |
185 | Where `datasize` cannot be bigger than `maxvz`. | |
e8fe2b1b FG |
186 | + |
187 | NOTE: In case of LVM thin, the `data` pool will only be created if `datasize` | |
188 | is bigger than 4GB. | |
189 | + | |
190 | NOTE: If set to `0`, no `data` volume will be created and the storage | |
191 | configuration will be adapted accordingly. | |
d91f8c1e DM |
192 | |
193 | `minfree`:: | |
194 | ||
fa281da6 TL |
195 | Defines the amount of free space left in LVM volume group `pve`. |
196 | With more than 128GB storage available the default is 16GB, else `hdsize/8` | |
197 | will be used. | |
d91f8c1e DM |
198 | + |
199 | NOTE: LVM requires free space in the VG for snapshot creation (not | |
200 | required for lvmthin snapshots). | |
201 | ||
202 | ||
203 | ZFS Performance Tips | |
6b5fc47b | 204 | ~~~~~~~~~~~~~~~~~~~~ |
d91f8c1e | 205 | |
cdf58596 WL |
206 | ZFS uses a lot of memory, so it is best to add additional RAM if you |
207 | want to use ZFS. A good calculation is 4GB plus 1GB RAM for each TB | |
208 | RAW disk space. | |
d91f8c1e DM |
209 | |
210 | ZFS also provides the feature to use a fast SSD drive as write cache. The | |
211 | write cache is called the ZFS Intent Log (ZIL). You can add that after | |
212 | installation using the following command: | |
213 | ||
214 | zpool add <pool-name> log </dev/path_to_fast_ssd> | |
215 | ||
078924cd DM |
216 | |
217 | ifdef::wiki[] | |
218 | ||
acb3e8d7 DM |
219 | link:/wiki/Install_Proxmox_VE_on_Debian_Stretch[Install Proxmox VE on Debian Stretch] |
220 | ------------------------------------------------------------------------------------- | |
078924cd | 221 | |
5c6cf7ac DM |
222 | link:/wiki/Install_from_USB_Stick[Install from USB Stick] |
223 | --------------------------------------------------------- | |
224 | ||
078924cd DM |
225 | endif::wiki[] |
226 | ||
227 | ifndef::wiki[] | |
228 | ||
229 | Install {pve} on Debian | |
6b5fc47b | 230 | ----------------------- |
078924cd | 231 | |
115aef16 | 232 | {pve} ships as a set of Debian packages, so you can install it |
0a37d38e | 233 | on top of a normal Debian installation. After configuring the |
078924cd DM |
234 | repositories, you need to run: |
235 | ||
236 | [source,bash] | |
237 | ---- | |
238 | apt-get update | |
239 | apt-get install proxmox-ve | |
240 | ---- | |
241 | ||
115aef16 FR |
242 | Installing on top of an existing Debian installation looks easy, but |
243 | it presumes that you have correctly installed the base system, and you | |
244 | know how you want to configure and use the local storage. Network | |
245 | configuration is also completely up to you. | |
246 | ||
247 | In general, this is not trivial, especially when you use LVM or | |
248 | ZFS. | |
249 | ||
22e65cdf | 250 | You can find a detailed step by step howto on the |
acb3e8d7 | 251 | {webwiki-url}Install_Proxmox_VE_on_Debian_Stretch[wiki]. |
078924cd | 252 | |
5c6cf7ac | 253 | include::pve-usbstick.adoc[] |
078924cd | 254 | |
5c6cf7ac | 255 | endif::wiki[] |
078924cd | 256 | |
078924cd DM |
257 | ifdef::wiki[] |
258 | ||
259 | Video Tutorials | |
6b5fc47b | 260 | --------------- |
078924cd DM |
261 | |
262 | * List of all official tutorials on our | |
263 | http://www.youtube.com/proxmoxve[Proxmox VE YouTube Channel] | |
264 | ||
265 | * Tutorials in Spanish language on | |
266 | http://www.youtube.com/playlist?list=PLUULBIhA5QDBdNf1pcTZ5UXhek63Fij8z[ITexperts.es | |
267 | YouTube Play List] | |
268 | ||
269 | ||
270 | See Also | |
6b5fc47b | 271 | -------- |
078924cd | 272 | |
bc1c71d4 DM |
273 | * link:/wiki/System_Requirements[System Requirements] |
274 | ||
078924cd DM |
275 | * link:/wiki/Package_Repositories[Package Repositories] |
276 | ||
277 | * link:/wiki/Host_System_Administration[Host System Administration] | |
278 | ||
279 | * link:/wiki/Network_Configuration[Network Configuration] | |
280 | ||
e723066c DM |
281 | * link:/wiki/Installation:_Tips_and_Tricks[Installation: Tips and Tricks] |
282 | ||
078924cd | 283 | endif::wiki[] |