]>
Commit | Line | Data |
---|---|---|
e71b5d0d | 1 | Installing Proxmox VE |
6b5fc47b | 2 | ===================== |
e71b5d0d | 3 | include::attributes.txt[] |
194d2f29 | 4 | ifndef::manvolnum[] |
5f09af76 | 5 | :pve-toplevel: |
194d2f29 DM |
6 | endif::manvolnum[] |
7 | ifdef::wiki[] | |
cb84ed18 | 8 | :title: Installation |
5f09af76 DM |
9 | endif::wiki[] |
10 | ||
115aef16 FR |
11 | {pve} is based on Debian and comes with an installation CD-ROM |
12 | which includes a complete Debian ("jessie" for Proxmox VE 4.x) system as | |
13 | well as all necessary Proxmox VE packages. The | |
14 | installer just asks you a few questions, then partitions the local | |
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 |
115aef16 | 17 | within a few minutes. This is the preferred and recommended installation method. |
d91f8c1e | 18 | |
115aef16 FR |
19 | Alternatively, Proxmox VE can be installed on top of an existing Debian system. |
20 | This option is only recommended for advanced users since detail knowledge about | |
21 | Proxmox VE is necessary. | |
d91f8c1e | 22 | |
bc1c71d4 DM |
23 | ifndef::wiki[] |
24 | ||
25 | include::pve-system-requirements.adoc[] | |
26 | ||
27 | endif::wiki[] | |
28 | ||
5eba0743 | 29 | |
d91f8c1e | 30 | Using the {pve} Installation CD-ROM |
6b5fc47b | 31 | ----------------------------------- |
d91f8c1e | 32 | |
115aef16 FR |
33 | Includes the following: |
34 | ||
e69c1847 DM |
35 | * Complete operating system (Debian Linux, 64-bit) |
36 | ||
37 | * Partitioning of the hard drive(s) containing the operating system | |
38 | with ext4, ext3, xfs or ZFS | |
39 | ||
40 | * {pve} kernel with LXC and KVM support | |
41 | ||
42 | * Complete toolset for administering virtual machines, containers and | |
43 | all necessary resources | |
44 | ||
a1856f27 | 45 | * Web based management interface for using the toolset |
115aef16 | 46 | |
078924cd DM |
47 | |
48 | NOTE: By default, the complete server is used and all existing data is | |
49 | removed. | |
50 | ||
d91f8c1e DM |
51 | Please insert the installation CD-ROM, then boot from that |
52 | drive. Immediately afterwards you can choose the following menu | |
53 | options: | |
54 | ||
55 | Install Proxmox VE:: | |
56 | ||
57 | Start normal installation. | |
58 | ||
59 | Install Proxmox VE (Debug mode):: | |
60 | ||
61 | Start installation in debug mode. It opens a shell console at several | |
62 | installation steps, so that you can debug things if something goes | |
63 | wrong. Please press `CTRL-D` to exit those debug consoles and continue | |
64 | installation. This option is mostly for developers and not meant for | |
65 | general use. | |
66 | ||
67 | Rescue Boot:: | |
68 | ||
69 | This option allows you to boot an existing installation. It searches | |
f77a3c10 | 70 | all attached hard disks and, if it finds an existing installation, |
d91f8c1e DM |
71 | boots directly into that disk using the existing Linux kernel. This |
72 | can be useful if there are problems with the boot block (grub), or the | |
73 | BIOS is unable to read the boot block from the disk. | |
74 | ||
75 | Test Memory:: | |
76 | ||
d7495642 | 77 | Runs `memtest86+`. This is useful to check if your memory is |
d91f8c1e DM |
78 | functional and error free. |
79 | ||
80 | You normally select *Install Proxmox VE* to start the installation. | |
81 | After that you get prompted to select the target hard disk(s). The | |
8e4bb261 | 82 | `Options` button lets you select the target file system, which |
8c1189b6 FG |
83 | defaults to `ext4`. The installer uses LVM if you select `ext3`, |
84 | `ext4` or `xfs` as file system, and offers additional option to | |
d91f8c1e DM |
85 | restrict LVM space (see <<advanced_lvm_options,below>>) |
86 | ||
87 | If you have more than one disk, you can also use ZFS as file system. | |
88 | ZFS supports several software RAID levels, so this is specially useful | |
89 | if you do not have a hardware RAID controller. The `Options` button | |
90 | lets you select the ZFS RAID level, and you can choose disks there. | |
91 | ||
a6ae7778 | 92 | The next pages just ask for basic configuration options like time |
d91f8c1e | 93 | zone and keyboard layout. You also need to specify your email address |
a6ae7778 | 94 | and superuser (root) password (must have at least 5 characters). |
d91f8c1e DM |
95 | |
96 | The last step is the network configuration. Please note that you can | |
97 | use either IPv4 or IPv6 here, but not both. If you want to configure a | |
98 | dual stack node, you can easily do that after installation. | |
99 | ||
100 | If you press `Next` now, installation starts to format disks, and | |
101 | copies packages to the target. Please wait until that is finished, | |
102 | then reboot the server. | |
103 | ||
104 | Further configuration is done via the Proxmox web interface. Just | |
105 | point your browser to the IP address given during installation | |
69255fd2 | 106 | (https://youripaddress:8006). |
d91f8c1e | 107 | |
fe6c04d5 DM |
108 | NOTE: Default login is "root" (realm 'PAM') and the root password is |
109 | defined during the installation process. | |
110 | ||
d91f8c1e DM |
111 | |
112 | [[advanced_lvm_options]] | |
5eba0743 | 113 | Advanced LVM Configuration Options |
6b5fc47b | 114 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
d91f8c1e DM |
115 | |
116 | The installer creates a Volume Group (VG) called `pve`, and additional | |
117 | Logical Volumes (LVs) called `root`, `data` and `swap`. The size of | |
118 | those volumes can be controlled with: | |
119 | ||
120 | `hdsize`:: | |
121 | ||
122 | Defines the total HD size to be used. This way you can save free | |
123 | space on the HD for further partitioning (i.e. for an additional PV | |
124 | and VG on the same hard disk that can be used for LVM storage). | |
125 | ||
126 | `swapsize`:: | |
127 | ||
128 | To define the size of the `swap` volume. Default is the same size as | |
129 | installed RAM, with 4GB minimum and `hdsize/8` as maximum. | |
130 | ||
131 | `maxroot`:: | |
132 | ||
133 | The `root` volume size. The `root` volume stores the whole operation | |
134 | system. | |
135 | ||
136 | `maxvz`:: | |
137 | ||
79b698ed | 138 | Define the size of the `data` volume. |
d91f8c1e DM |
139 | |
140 | `minfree`:: | |
141 | ||
142 | To define the amount of free space left in LVM volume group `pve`. | |
143 | 16GB is the default if storage available > 128GB, `hdsize/8` otherwise. | |
144 | + | |
145 | NOTE: LVM requires free space in the VG for snapshot creation (not | |
146 | required for lvmthin snapshots). | |
147 | ||
148 | ||
149 | ZFS Performance Tips | |
6b5fc47b | 150 | ~~~~~~~~~~~~~~~~~~~~ |
d91f8c1e | 151 | |
cdf58596 WL |
152 | ZFS uses a lot of memory, so it is best to add additional RAM if you |
153 | want to use ZFS. A good calculation is 4GB plus 1GB RAM for each TB | |
154 | RAW disk space. | |
d91f8c1e DM |
155 | |
156 | ZFS also provides the feature to use a fast SSD drive as write cache. The | |
157 | write cache is called the ZFS Intent Log (ZIL). You can add that after | |
158 | installation using the following command: | |
159 | ||
160 | zpool add <pool-name> log </dev/path_to_fast_ssd> | |
161 | ||
078924cd DM |
162 | |
163 | ifdef::wiki[] | |
164 | ||
165 | link:/wiki/Install_Proxmox_VE_on_Debian_Jessie[Install Proxmox VE on Debian Jessie] | |
6b5fc47b | 166 | ----------------------------------------------------------------------------------- |
078924cd | 167 | |
5c6cf7ac DM |
168 | link:/wiki/Install_from_USB_Stick[Install from USB Stick] |
169 | --------------------------------------------------------- | |
170 | ||
078924cd DM |
171 | endif::wiki[] |
172 | ||
173 | ifndef::wiki[] | |
174 | ||
175 | Install {pve} on Debian | |
6b5fc47b | 176 | ----------------------- |
078924cd | 177 | |
115aef16 | 178 | {pve} ships as a set of Debian packages, so you can install it |
0a37d38e | 179 | on top of a normal Debian installation. After configuring the |
078924cd DM |
180 | repositories, you need to run: |
181 | ||
182 | [source,bash] | |
183 | ---- | |
184 | apt-get update | |
185 | apt-get install proxmox-ve | |
186 | ---- | |
187 | ||
115aef16 FR |
188 | Installing on top of an existing Debian installation looks easy, but |
189 | it presumes that you have correctly installed the base system, and you | |
190 | know how you want to configure and use the local storage. Network | |
191 | configuration is also completely up to you. | |
192 | ||
193 | In general, this is not trivial, especially when you use LVM or | |
194 | ZFS. | |
195 | ||
22e65cdf FG |
196 | You can find a detailed step by step howto on the |
197 | {webwiki-url}Install_Proxmox_VE_on_Debian_Jessie[wiki]. | |
078924cd | 198 | |
5c6cf7ac | 199 | include::pve-usbstick.adoc[] |
078924cd | 200 | |
5c6cf7ac | 201 | endif::wiki[] |
078924cd | 202 | |
078924cd DM |
203 | ifdef::wiki[] |
204 | ||
205 | Video Tutorials | |
6b5fc47b | 206 | --------------- |
078924cd DM |
207 | |
208 | * List of all official tutorials on our | |
209 | http://www.youtube.com/proxmoxve[Proxmox VE YouTube Channel] | |
210 | ||
211 | * Tutorials in Spanish language on | |
212 | http://www.youtube.com/playlist?list=PLUULBIhA5QDBdNf1pcTZ5UXhek63Fij8z[ITexperts.es | |
213 | YouTube Play List] | |
214 | ||
215 | ||
216 | See Also | |
6b5fc47b | 217 | -------- |
078924cd | 218 | |
bc1c71d4 DM |
219 | * link:/wiki/System_Requirements[System Requirements] |
220 | ||
078924cd DM |
221 | * link:/wiki/Package_Repositories[Package Repositories] |
222 | ||
223 | * link:/wiki/Host_System_Administration[Host System Administration] | |
224 | ||
225 | * link:/wiki/Network_Configuration[Network Configuration] | |
226 | ||
e723066c DM |
227 | * link:/wiki/Installation:_Tips_and_Tricks[Installation: Tips and Tricks] |
228 | ||
078924cd | 229 | endif::wiki[] |