]>
Commit | Line | Data |
---|---|---|
419ef454 DM |
1 | Host System Administration |
2 | ========================== | |
3 | ||
4 | {pve} is based on the famous https://www.debian.org/[Debian] Linux | |
5 | distribution. That means that you have access to the whole world of | |
6 | Debian packages, and the base system is well documented. The | |
7 | https://debian-handbook.info/download/stable/debian-handbook.pdf[Debian | |
8 | Administrator\'s Handbook] is available online, and provide a | |
9 | comprehensive introduction to the Debian operating system (see | |
10 | xref:Hertzog13[]). | |
11 | ||
12 | A standard {pve} installation uses the default repositories from | |
13 | Debian, so you get bug fixes and security updates through that | |
14 | channel. In addition, we provide our own package repository to roll | |
15 | out all {pve} related packages. This includes updates to some | |
16 | Debian packages when necessary. | |
17 | ||
18 | We also deliver a specially optimized Linux kernel, where we enable all | |
19 | required virtualization and container features. That kernel includes | |
20 | drivers for http://zfsonlinux.org/[ZFS], and several hardware drivers. | |
21 | For example, we ship Intel network card drivers to support their | |
22 | newest hardware. | |
23 | ||
24 | The following sections will concentrate on virtualization related | |
25 | topics. They either explains things which are different on {pve}, or | |
26 | tasks which are commonly used on {pve}. For other topics, please refer | |
27 | to the standard Debian documentation. | |
28 | ||
29 | System requirements | |
30 | ------------------- | |
31 | ||
32 | For production servers, high quality server equipment is needed. Keep | |
33 | in mind, if you run 10 Virtual Servers on one machine and you then | |
34 | experience a hardware failure, 10 services are lost. {pve} | |
35 | supports clustering, this means that multiple {pve} installations | |
36 | can be centrally managed thanks to the included cluster functionality. | |
37 | ||
38 | {pve} can use local storage (DAS), SAN, NAS and also distributed | |
39 | storage (Ceph RBD). For details see xref:chapter-storage[chapter storage]. | |
40 | ||
41 | Minimum requirements, for evaluation | |
42 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
43 | ||
44 | * CPU: 64bit (Intel EMT64 or AMD64) | |
45 | ||
46 | * RAM: 1 GB RAM | |
47 | ||
48 | * Hard drive | |
49 | ||
50 | * One NIC | |
51 | ||
52 | Recommended system requirements | |
53 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
54 | ||
55 | * CPU: 64bit (Intel EMT64 or AMD64), Multi core CPU recommended | |
56 | ||
57 | * RAM: 8 GB is good, more is better | |
58 | ||
59 | * Hardware RAID with batteries protected write cache (BBU) or flash | |
60 | based protection | |
61 | ||
62 | * Fast hard drives, best results with 15k rpm SAS, Raid10 | |
63 | ||
64 | * At least two NICĀ“s, depending on the used storage technology you need more | |
65 | ||
66 | ||
67 | Getting Help | |
68 | ------------ | |
69 | ||
70 | There are basically two different support channels. {pve} itself if | |
71 | fully open source, so we always encourage our users to discuss and | |
72 | share their knowledge using the http://forum.proxmox.com/[Community | |
73 | Support Forum]. The forum is fully moderated by the Proxmox support | |
74 | team. Up to now, the forum has about 25.000 members, and more than | |
75 | 120.000 messages. Needless to say that such a large forum is a great | |
76 | place to get information. | |
77 | ||
78 | The second channel is the commercial support provided by | |
79 | {proxmoxGmbh}. {pve} server subscriptions can be ordered online, see | |
80 | http://shop.maurer-it.com[{pve} Shop]. For all details see | |
81 | http://www.proxmox.com/proxmox-ve/pricing[{pve} Subscription Service | |
82 | Plans]. | |
83 | ||
84 | Please contact the mailto:office@proxmox.com[Proxmox sales team] for | |
85 | commercial support requests or volume discounts. | |
86 | ||
87 | Package Repositories | |
88 | -------------------- | |
89 | ||
90 | All Debian based systems use | |
91 | http://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as package | |
92 | management tool. The list of repositories is defined in | |
93 | '/etc/apt/sources.list' and '.list' files found inside | |
94 | '/etc/apt/sources.d/'. Updates can be installed directly using | |
95 | 'apt-get', or via the GUI. | |
96 | ||
97 | Apt 'sources.list' files lists one package repository per line, with | |
98 | the most preferred source listed first. Empty lines are ignored, and a | |
99 | '#' character anywhere on a line marks the remainder of that line as a | |
100 | comment. The information available from the configured sources is | |
101 | acquired by 'apt-get update'. | |
102 | ||
103 | .File '/etc/apt/sources.list' | |
104 | ---- | |
105 | deb http://ftp.debian.org/debian jessie main contrib | |
106 | ||
107 | # security updates | |
108 | deb http://security.debian.org jessie/updates main contrib | |
109 | ---- | |
110 | ||
111 | In addition, {pve} provides three different package repositories. | |
112 | ||
113 | {pve} Enterprise Repository | |
114 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
115 | ||
116 | This is the default, stable and recommended repository, available for | |
117 | all {pve} subscription users. It contains the most stable packages, | |
118 | and is suitable for production use. You need a valid subscription key | |
119 | to access this repository. The `pve-enterprise` repository is enabled | |
120 | by default: | |
121 | ||
122 | .File '/etc/apt/sources.list.d/pve-enterprise.list' | |
123 | ---- | |
124 | deb https://enterprise.proxmox.com/debian jessie pve-enterprise | |
125 | ---- | |
126 | ||
127 | NOTE: You can disable this repository by commenting out the above line | |
128 | using a '#' (at the start of the line). This prevents error messages | |
129 | if you do not have a subscription key. Please configure the | |
130 | `pve-no-subscription` repository in that case. | |
131 | ||
132 | As soon as updates are available, the `root@pam` user is notified via | |
133 | email about the available new packages. On the GUI, the change-log of | |
134 | each package can be viewed (if available), showing all details of the | |
135 | update. So you will never miss important security fixes. | |
136 | ||
137 | {pve} No-Subscription Repository | |
138 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
139 | ||
140 | As the name suggests, you do not need a subscription key to access | |
141 | this repository. It can be used for testing and non-production | |
142 | use. Its not recommended to run on production servers, as these | |
143 | packages are not always heavily tested and validated. | |
144 | ||
145 | We recommend to configure this repository in '/etc/apt/sources.list'. | |
146 | ||
147 | .File '/etc/apt/sources.list' | |
148 | ---- | |
149 | deb http://ftp.debian.org/debian jessie main contrib | |
150 | ||
151 | # PVE pve-no-subscription repository provided by proxmox.com, | |
152 | # NOT recommended for production use | |
153 | deb http://download.proxmox.com/debian jessie pve-no-subscription | |
154 | ||
155 | # security updates | |
156 | deb http://security.debian.org jessie/updates main contrib | |
157 | ---- | |
158 | ||
159 | ||
160 | {pve} Test Repository | |
161 | ~~~~~~~~~~~~~~~~~~~~~~ | |
162 | ||
163 | Finally, there is a repository called `pvetest`. This one contains the | |
164 | latest packages and is heavily used by developers to test new | |
165 | features. As usual, you can configure this using | |
166 | '/etc/apt/sources.list' by adding the following line: | |
167 | ||
168 | .sources.list entry for `pvetest` | |
169 | ---- | |
170 | deb http://download.proxmox.com/debian jessie pvetest | |
171 | ---- | |
172 | ||
173 | ||
174 | Installing {pve} | |
175 | ---------------- | |
176 | ||
177 | {pve} ships as a set of Debian packages, so you can simply install it | |
178 | on top of a normal Debian installation. After configuring the | |
179 | repositories, you need to run: | |
180 | ||
181 | [source,bash] | |
182 | ---- | |
183 | apt-get update | |
184 | apt-get install proxmox-ve | |
185 | ---- | |
186 | ||
187 | While this looks easy, it presumes that you have correctly installed | |
188 | the base system, and you know how you want to configure and use the | |
189 | local storage. Network configuration is also completely up to you. | |
190 | ||
191 | In general, this is not trivial, especially when you use LVM or | |
661c797a | 192 | ZFS. This is why we provide an installation CD-ROM for {pve}. That |
419ef454 DM |
193 | installer just ask you a few questions, then partitions the local |
194 | disk(s), installs all required packages, and configures the system | |
195 | including a basic network setup. You can get a fully functional system | |
196 | within a few minutes, including the following: | |
197 | ||
198 | * Complete operating system (Debian Linux, 64-bit) | |
199 | * Partition the hard drive with ext4 (alternative ext3 or xfs) or ZFS | |
200 | * {pve} Kernel with LXC and KVM support | |
201 | * Complete toolset | |
202 | * Web based management interface | |
203 | ||
204 | NOTE: By default, the complete server is used and all existing data is | |
205 | removed. | |
206 | ||
661c797a DM |
207 | Using the {pve} Installation CD-ROM |
208 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
c2ce70b6 DM |
209 | |
210 | Please insert the installation CD-ROM, then boot from that | |
211 | drive. Immediately afterwards you can choose the following menu | |
212 | options: | |
213 | ||
214 | Install Proxmox VE:: | |
215 | ||
216 | Start normal installation. | |
217 | ||
218 | Install Proxmox VE (Debug mode):: | |
219 | ||
220 | Start installation in debug mode. It opens a shell console at several | |
221 | installation steps, so that you can debug things if something goes | |
222 | wrong. Please press `CTRL-D` to exit those debug consoles and continue | |
223 | installation. This option is mostly for developers and not meant for | |
224 | general use. | |
225 | ||
226 | Test Memory:: | |
227 | ||
228 | Runs 'memtest86+'. This is useful to check if your memory if | |
229 | functional and error free. | |
230 | ||
231 | You normally select *Install Proxmox VE* to start the installation. | |
232 | ||
233 | After that you get prompted to select the target hard disk(s). The | |
661c797a | 234 | `Options` button aside lets you select the target file system, and |
c2ce70b6 DM |
235 | defaults to `ext4`. |
236 | ||
237 | If you have more than one disk, you can also select ZFS here. ZFS | |
238 | supports several software RAID levels, so this is specially useful if | |
239 | you do not have a hardware RAID controller. | |
240 | ||
f6257905 DM |
241 | TIP: ZFS uses a lot of memory, so it is best to add additional 8-16GB RAM |
242 | if you want to use ZFS. | |
243 | ||
c2ce70b6 DM |
244 | The next pages just asks for basic configuration options like time |
245 | zone and keyboard layout. You also need to specify your email address | |
246 | and select a superuser password. | |
247 | ||
248 | The last step is the network configuration. Please note that you can | |
249 | use either IPv4 or IPv6 here, but not both. If you want to configure a | |
250 | dual stack node, you can easily do that after installation. | |
251 | ||
252 | If you press `Next` now, installation starts to format disks, and | |
253 | copies packages to the target. Please wait until that is finished, | |
254 | then reboot the server. | |
255 | ||
419ef454 DM |
256 | Further configuration is done via the Proxmox web interface. Just |
257 | point your browser to the IP address given during installation | |
c2ce70b6 | 258 | (https://youripaddress:8006). {pve} is tested for IE9, Firefox 10 |
419ef454 DM |
259 | and higher, Google Chrome (latest). |
260 | ||
261 | ||
262 | Network Configuration | |
263 | --------------------- | |
264 | ||
265 | Basic network setup. | |
266 | ||
267 | image::images/cluster-nwdiag.svg[{pve} Cluster Network] | |
268 | ||
269 | image::images/node-nwdiag.svg[{pve} Default Network Setup] | |
270 | ||
271 | ||
272 | Local Storage | |
273 | ------------- | |
274 | ||
275 | Logical Volume Manager (LVM) | |
276 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
277 | ||
650c5cc1 | 278 | TODO: info about LVM. |
419ef454 DM |
279 | |
280 | ||
281 | ZFS on Linux | |
282 | ~~~~~~~~~~~~ | |
283 | ||
650c5cc1 | 284 | TODO: info about ZFS. |
419ef454 DM |
285 | |
286 | ||
287 | Working with 'systemd' | |
288 | ---------------------- | |
289 | ||
290 | Journal and syslog | |
291 | ~~~~~~~~~~~~~~~~~~ | |
292 | ||
293 | TODO: explain persistent journal... | |
294 | ||
295 | ||
296 | ||
297 | ||
298 | ||
299 | ||
300 |