INSTALL 3.03 KB
Newer Older
Michael Hanselmann's avatar
Michael Hanselmann committed
1
2
Ganeti quick installation guide
===============================
3

Michael Hanselmann's avatar
Michael Hanselmann committed
4
5
6
Please note that a more detailed installation procedure is described in
the :doc:`install`. A glossary of terms can be found in the
:doc:`glossary`.
7
8


9
Software Requirements
Michael Hanselmann's avatar
Michael Hanselmann committed
10
---------------------
Iustin Pop's avatar
Iustin Pop committed
11
12

Before installing, please verify that you have the following programs:
Michael Hanselmann's avatar
Michael Hanselmann committed
13

14
15
16
17
18
19
- `Xen Hypervisor <http://www.xen.org/>`_, version 3.0 or above, if
  running on Xen
- `KVM Hypervisor <http://www.linux-kvm.org>`_, version 72 or above, if
  running on KVM. In order to use advanced features, such as live
  migration, virtio, etc, an even newer version is recommended (qemu-kvm
  versions 0.11.X or above have shown good behavior).
Michael Hanselmann's avatar
Michael Hanselmann committed
20
21
22
23
24
25
26
27
28
29
30
31
- `DRBD <http://www.drbd.org/>`_, kernel module and userspace utils,
  version 8.0.7 or above
- `LVM2 <http://sourceware.org/lvm2/>`_
- `OpenSSH <http://www.openssh.com/portable.html>`_
- `bridge utilities <http://www.linuxfoundation.org/en/Net:Bridge>`_
- `iproute2 <http://www.linuxfoundation.org/en/Net:Iproute2>`_
- `arping <http://www.skbuff.net/iputils/>`_ (part of iputils)
- `Python <http://www.python.org/>`_, version 2.4 or above, not 3.0
- `Python OpenSSL bindings <http://pyopenssl.sourceforge.net/>`_
- `simplejson Python module <http://code.google.com/p/simplejson/>`_
- `pyparsing Python module <http://pyparsing.wikispaces.com/>`_
- `pyinotify Python module <http://trac.dbzteam.org/pyinotify/>`_
32
- `PycURL Python module <http://pycurl.sourceforge.net/>`_
33
34
35
- `ctypes Python module
  <http://starship.python.net/crew/theller/ctypes/>`_, if running on
  python 2.4 (optional, used for node daemon memory locking)
Michael Hanselmann's avatar
Michael Hanselmann committed
36
37
38
39
40
41
42
43
44
45
- `socat <http://www.dest-unreach.org/socat/>`_

These programs are supplied as part of most Linux distributions, so
usually they can be installed via the standard package manager. Also
many of them will already be installed on a standard machine. On
Debian/Ubuntu, you can use this command line to install all required
packages, except for DRBD and Xen::

  $ apt-get install lvm2 ssh bridge-utils iproute iputils-arping \
                    python python-pyopenssl openssl python-pyparsing \
46
47
                    python-simplejson python-pyinotify python-pycurl \
                    socat
Michael Hanselmann's avatar
Michael Hanselmann committed
48
49
50

If you want to build from source, please see doc/devnotes.rst for more
dependencies.
51

52
53

Installation of the software
Michael Hanselmann's avatar
Michael Hanselmann committed
54
55
56
----------------------------

To install, simply run the following command::
Iustin Pop's avatar
Iustin Pop committed
57

Michael Hanselmann's avatar
Michael Hanselmann committed
58
59
60
  ./configure --localstatedir=/var --sysconfdir=/etc && \
  make && \
  make install
Iustin Pop's avatar
Iustin Pop committed
61

Michael Hanselmann's avatar
Michael Hanselmann committed
62
63
64
65
This will install the software under ``/usr/local``. You then need to
copy ``doc/examples/ganeti.initd`` to ``/etc/init.d/ganeti`` and
integrate it into your boot sequence (``chkconfig``, ``update-rc.d``,
etc.).
Iustin Pop's avatar
Iustin Pop committed
66

67

Iustin Pop's avatar
Iustin Pop committed
68
Cluster initialisation
Michael Hanselmann's avatar
Michael Hanselmann committed
69
----------------------
Iustin Pop's avatar
Iustin Pop committed
70

Michael Hanselmann's avatar
Michael Hanselmann committed
71
72
Before initialising the cluster, on each node you need to create the
following directories:
Iustin Pop's avatar
Iustin Pop committed
73

Michael Hanselmann's avatar
Michael Hanselmann committed
74
75
76
77
78
79
- ``/etc/ganeti``
- ``/var/lib/ganeti``
- ``/var/log/ganeti``
- ``/srv/ganeti``
- ``/srv/ganeti/os``
- ``/srv/ganeti/export``
Iustin Pop's avatar
Iustin Pop committed
80
81

After this, use ``gnt-cluster init``.
Michael Hanselmann's avatar
Michael Hanselmann committed
82
83
84
85
86
87

.. vim: set textwidth=72 syntax=rst :
.. Local Variables:
.. mode: rst
.. fill-column: 72
.. End: