| 1 |
|
Documentation
|
| 2 |
|
=============
|
|
1 |
Ganeti quick installation guide
|
|
2 |
===============================
|
| 3 |
3 |
|
| 4 |
|
Please note that a more detailed installation procedure is described in the
|
| 5 |
|
doc/install.html file. A glossary of terms can be found in the doc/admin.html
|
| 6 |
|
file.
|
|
4 |
Please note that a more detailed installation procedure is described in
|
|
5 |
the :doc:`install`. A glossary of terms can be found in the
|
|
6 |
:doc:`glossary`.
|
| 7 |
7 |
|
| 8 |
8 |
|
| 9 |
9 |
Software Requirements
|
| 10 |
|
=====================
|
|
10 |
---------------------
|
| 11 |
11 |
|
| 12 |
12 |
Before installing, please verify that you have the following programs:
|
| 13 |
|
- Xen virtualization (version 3.0.x or 3.1)
|
| 14 |
|
http://xen.xensource.com/
|
| 15 |
|
- DRBD (kernel module and userspace utils), version 8.0.7+
|
| 16 |
|
http://www.drbd.org/
|
| 17 |
|
- LVM2
|
| 18 |
|
http://sourceware.org/lvm2/
|
| 19 |
|
- OpenSSL
|
| 20 |
|
http://www.openssl.org/
|
| 21 |
|
- OpenSSH
|
| 22 |
|
http://www.openssh.com/portable.html
|
| 23 |
|
- bridge utilities
|
| 24 |
|
http://bridge.sourceforge.net/
|
| 25 |
|
- iproute2
|
| 26 |
|
http://developer.osdl.org/dev/iproute2
|
| 27 |
|
- arping (part of iputils package)
|
| 28 |
|
ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz
|
| 29 |
|
- Python 2.4
|
| 30 |
|
http://www.python.org
|
| 31 |
|
- Python OpenSSL bindings
|
| 32 |
|
http://pyopenssl.sourceforge.net/
|
| 33 |
|
- simplejson Python module
|
| 34 |
|
http://www.undefined.org/python/#simplejson
|
| 35 |
|
- pyparsing Python module
|
| 36 |
|
http://pyparsing.wikispaces.com/
|
| 37 |
|
|
| 38 |
|
For building from source, you also need tar, gzip or bzip2 and make.
|
|
13 |
|
|
14 |
- `Xen Hypervisor <http://www.xen.org/>`_, version 3.0.x or 3.1
|
|
15 |
- `DRBD <http://www.drbd.org/>`_, kernel module and userspace utils,
|
|
16 |
version 8.0.7 or above
|
|
17 |
- `LVM2 <http://sourceware.org/lvm2/>`_
|
|
18 |
- `OpenSSL <http://www.openssl.org/>`_
|
|
19 |
- `OpenSSH <http://www.openssh.com/portable.html>`_
|
|
20 |
- `bridge utilities <http://www.linuxfoundation.org/en/Net:Bridge>`_
|
|
21 |
- `iproute2 <http://www.linuxfoundation.org/en/Net:Iproute2>`_
|
|
22 |
- `arping <http://www.skbuff.net/iputils/>`_ (part of iputils)
|
|
23 |
- `Python <http://www.python.org/>`_, version 2.4 or above, not 3.0
|
|
24 |
- `Python OpenSSL bindings <http://pyopenssl.sourceforge.net/>`_
|
|
25 |
- `simplejson Python module <http://code.google.com/p/simplejson/>`_
|
|
26 |
- `pyparsing Python module <http://pyparsing.wikispaces.com/>`_
|
|
27 |
- `pyinotify Python module <http://trac.dbzteam.org/pyinotify/>`_
|
|
28 |
- `socat <http://www.dest-unreach.org/socat/>`_
|
|
29 |
|
|
30 |
These programs are supplied as part of most Linux distributions, so
|
|
31 |
usually they can be installed via the standard package manager. Also
|
|
32 |
many of them will already be installed on a standard machine. On
|
|
33 |
Debian/Ubuntu, you can use this command line to install all required
|
|
34 |
packages, except for DRBD and Xen::
|
|
35 |
|
|
36 |
$ apt-get install lvm2 ssh bridge-utils iproute iputils-arping \
|
|
37 |
python python-pyopenssl openssl python-pyparsing \
|
|
38 |
python-simplejson python-pyinotify socat
|
|
39 |
|
|
40 |
If you want to build from source, please see doc/devnotes.rst for more
|
|
41 |
dependencies.
|
| 39 |
42 |
|
| 40 |
43 |
|
| 41 |
44 |
Installation of the software
|
| 42 |
|
============================
|
|
45 |
----------------------------
|
|
46 |
|
|
47 |
To install, simply run the following command::
|
| 43 |
48 |
|
| 44 |
|
To install, simply do ``./configure --localstatedir=/var --sysconfdir=/etc && \
|
| 45 |
|
make && make install``
|
|
49 |
./configure --localstatedir=/var --sysconfdir=/etc && \
|
|
50 |
make && \
|
|
51 |
make install
|
| 46 |
52 |
|
| 47 |
|
This will install the software under /usr/local. You then need to copy
|
| 48 |
|
ganeti.init to /etc/init.d/ganeti and integrate it into your boot sequence
|
| 49 |
|
(``chkconfig``, ``update-rc.d``, etc.).
|
|
53 |
This will install the software under ``/usr/local``. You then need to
|
|
54 |
copy ``doc/examples/ganeti.initd`` to ``/etc/init.d/ganeti`` and
|
|
55 |
integrate it into your boot sequence (``chkconfig``, ``update-rc.d``,
|
|
56 |
etc.).
|
| 50 |
57 |
|
| 51 |
58 |
|
| 52 |
59 |
Cluster initialisation
|
| 53 |
|
======================
|
|
60 |
----------------------
|
| 54 |
61 |
|
| 55 |
|
Before initialising the cluster, on each node you need to create the following
|
| 56 |
|
directories:
|
|
62 |
Before initialising the cluster, on each node you need to create the
|
|
63 |
following directories:
|
| 57 |
64 |
|
| 58 |
|
- /etc/ganeti
|
| 59 |
|
- /var/lib/ganeti, /var/log/ganeti
|
| 60 |
|
- /srv/ganeti, /srv/ganeti/os, /srv/ganeti/export
|
|
65 |
- ``/etc/ganeti``
|
|
66 |
- ``/var/lib/ganeti``
|
|
67 |
- ``/var/log/ganeti``
|
|
68 |
- ``/srv/ganeti``
|
|
69 |
- ``/srv/ganeti/os``
|
|
70 |
- ``/srv/ganeti/export``
|
| 61 |
71 |
|
| 62 |
72 |
After this, use ``gnt-cluster init``.
|
|
73 |
|
|
74 |
.. vim: set textwidth=72 syntax=rst :
|
|
75 |
.. Local Variables:
|
|
76 |
.. mode: rst
|
|
77 |
.. fill-column: 72
|
|
78 |
.. End:
|