Revision 16450d30 docs/install.sgml
| b/docs/install.sgml | ||
|---|---|---|
| 88 | 88 |
It is advised to start with a clean, minimal install of the |
| 89 | 89 |
operating system. The only requirement you need to be aware of |
| 90 | 90 |
at this stage is to partition leaving enough space for a big |
| 91 |
LVM volume group which will then host your instance |
|
| 92 |
filesystems. The volume group name Ganeti 1.2 uses is |
|
| 91 |
(<emphasis role="strong">minimum |
|
| 92 |
<constant>20GiB</constant></emphasis>) LVM volume group which |
|
| 93 |
will then host your instance filesystems. The volume group |
|
| 94 |
name Ganeti 1.2 uses (by default) is |
|
| 93 | 95 |
<emphasis>xenvg</emphasis>. |
| 94 | 96 |
</para> |
| 95 | 97 |
|
| ... | ... | |
| 101 | 103 |
</note> |
| 102 | 104 |
|
| 103 | 105 |
<para> |
| 104 |
While you can use an exiting system, please note that the |
|
| 106 |
While you can use an existing system, please note that the
|
|
| 105 | 107 |
Ganeti installation is intrusive in terms of changes to the |
| 106 | 108 |
system configuration, and it's best to use a newly-installed |
| 107 | 109 |
system without important data on it. |
| ... | ... | |
| 149 | 151 |
<formalpara><title>Debian</title> |
| 150 | 152 |
<para> |
| 151 | 153 |
Under Debian Etch or Sarge+backports you can install the |
| 152 |
relevant xen-linux-system package, which will pull in both the
|
|
| 153 |
hypervisor and the relevant kernel. |
|
| 154 |
relevant <literal>xen-linux-system</literal> package, which
|
|
| 155 |
will pull in both the hypervisor and the relevant kernel.
|
|
| 154 | 156 |
</para> |
| 155 | 157 |
</formalpara> |
| 156 | 158 |
|
| 159 |
<sect3> |
|
| 160 |
<title>Selecting the instance kernel</title> |
|
| 161 |
|
|
| 162 |
<para> |
|
| 163 |
After you have installed xen, you need to tell Ganeti |
|
| 164 |
exactly what kernel to use for the instances it will |
|
| 165 |
create. This is done by creating a |
|
| 166 |
<emphasis>symlink</emphasis> from your actual kernel to |
|
| 167 |
<filename>/boot/vmlinuz-2.6-xenU</filename>, and one from |
|
| 168 |
your initrd to |
|
| 169 |
<filename>/boot/initrd-2.6-xenU</filename>. Note that if you |
|
| 170 |
don't use an initrd for the <literal>domU</literal> kernel, |
|
| 171 |
you don't need to create the initrd symlink. |
|
| 172 |
</para> |
|
| 173 |
|
|
| 174 |
<formalpara> |
|
| 175 |
<title>Debian</title> |
|
| 176 |
<para> |
|
| 177 |
After installation of the |
|
| 178 |
<literal>xen-linux-system</literal> package, you need to |
|
| 179 |
run (replace the exact version number with the one you |
|
| 180 |
have): |
|
| 181 |
<screen> |
|
| 182 |
cd /boot |
|
| 183 |
ln -s vmlinuz-2.6.18-5-xen-686 vmlinuz-2.6-xenU |
|
| 184 |
ln -s initrd.img-2.6.18-5-xen-686 initrd-2.6-xenU |
|
| 185 |
</screen> |
|
| 186 |
</para> |
|
| 187 |
</formalpara> |
|
| 188 |
</sect3> |
|
| 189 |
|
|
| 157 | 190 |
</sect2> |
| 158 | 191 |
|
| 159 | 192 |
<sect2> |
| ... | ... | |
| 366 | 399 |
|
| 367 | 400 |
<para><emphasis role="strong">Mandatory</emphasis> on all nodes.</para> |
| 368 | 401 |
|
| 402 |
<note> |
|
| 403 |
<simpara>The volume group is required to be at least |
|
| 404 |
<constant>20GiB</constant>.</simpara> |
|
| 405 |
</note> |
|
| 369 | 406 |
<para> |
| 370 | 407 |
If you haven't configured your LVM volume group at install |
| 371 | 408 |
time you need to do it before trying to initialize the Ganeti |
| ... | ... | |
| 449 | 486 |
</screen> |
| 450 | 487 |
|
| 451 | 488 |
<para> |
| 489 |
In order to use this OS definition, you need to have internet |
|
| 490 |
access from your nodes and have <citerefentry> |
|
| 491 |
<refentrytitle>debootstrap</refentrytitle> |
|
| 492 |
<manvolnum>8</manvolnum> </citerefentry> installed on all the |
|
| 493 |
nodes. |
|
| 494 |
</para> |
|
| 495 |
<formalpara> |
|
| 496 |
<title>Debian</title> |
|
| 497 |
<para> |
|
| 498 |
Use this command on all nodes to install |
|
| 499 |
<computeroutput>debootstrap</computeroutput>: |
|
| 500 |
|
|
| 501 |
<screen>apt-get install debootstrap</screen> |
|
| 502 |
</para> |
|
| 503 |
</formalpara> |
|
| 504 |
|
|
| 505 |
<para> |
|
| 452 | 506 |
Alternatively, you can create your own OS definitions. See the |
| 453 | 507 |
manpage |
| 454 | 508 |
<citerefentry> |
Also available in: Unified diff