Statistics
| Branch: | Tag: | Revision:

root / INSTALL @ a40b1fc4

History | View | Annotate | Download (3.2 kB)

1 c27ba1cc Michael Hanselmann
Ganeti quick installation guide
2 c27ba1cc Michael Hanselmann
===============================
3 4096472d Iustin Pop
4 c27ba1cc Michael Hanselmann
Please note that a more detailed installation procedure is described in
5 c27ba1cc Michael Hanselmann
the :doc:`install`. A glossary of terms can be found in the
6 c27ba1cc Michael Hanselmann
:doc:`glossary`.
7 4096472d Iustin Pop
8 4096472d Iustin Pop
9 bd785ecd Michael Hanselmann
Software Requirements
10 c27ba1cc Michael Hanselmann
---------------------
11 a8083063 Iustin Pop
12 a8083063 Iustin Pop
Before installing, please verify that you have the following programs:
13 c27ba1cc Michael Hanselmann
14 c4b2b2e2 Guido Trotter
- `Xen Hypervisor <http://www.xen.org/>`_, version 3.0 or above, if
15 c4b2b2e2 Guido Trotter
  running on Xen
16 c4b2b2e2 Guido Trotter
- `KVM Hypervisor <http://www.linux-kvm.org>`_, version 72 or above, if
17 c4b2b2e2 Guido Trotter
  running on KVM. In order to use advanced features, such as live
18 c4b2b2e2 Guido Trotter
  migration, virtio, etc, an even newer version is recommended (qemu-kvm
19 c4b2b2e2 Guido Trotter
  versions 0.11.X or above have shown good behavior).
20 c27ba1cc Michael Hanselmann
- `DRBD <http://www.drbd.org/>`_, kernel module and userspace utils,
21 c27ba1cc Michael Hanselmann
  version 8.0.7 or above
22 c27ba1cc Michael Hanselmann
- `LVM2 <http://sourceware.org/lvm2/>`_
23 c27ba1cc Michael Hanselmann
- `OpenSSH <http://www.openssh.com/portable.html>`_
24 c27ba1cc Michael Hanselmann
- `bridge utilities <http://www.linuxfoundation.org/en/Net:Bridge>`_
25 c27ba1cc Michael Hanselmann
- `iproute2 <http://www.linuxfoundation.org/en/Net:Iproute2>`_
26 c27ba1cc Michael Hanselmann
- `arping <http://www.skbuff.net/iputils/>`_ (part of iputils)
27 c27ba1cc Michael Hanselmann
- `Python <http://www.python.org/>`_, version 2.4 or above, not 3.0
28 c27ba1cc Michael Hanselmann
- `Python OpenSSL bindings <http://pyopenssl.sourceforge.net/>`_
29 c27ba1cc Michael Hanselmann
- `simplejson Python module <http://code.google.com/p/simplejson/>`_
30 c27ba1cc Michael Hanselmann
- `pyparsing Python module <http://pyparsing.wikispaces.com/>`_
31 c27ba1cc Michael Hanselmann
- `pyinotify Python module <http://trac.dbzteam.org/pyinotify/>`_
32 2a7c3583 Michael Hanselmann
- `PycURL Python module <http://pycurl.sourceforge.net/>`_
33 b447ab51 Luca Bigliardi
- `ctypes Python module
34 b447ab51 Luca Bigliardi
  <http://starship.python.net/crew/theller/ctypes/>`_, if running on
35 b447ab51 Luca Bigliardi
  python 2.4 (optional, used for node daemon memory locking)
36 c27ba1cc Michael Hanselmann
- `socat <http://www.dest-unreach.org/socat/>`_
37 a40b1fc4 René Nussbaumer
- `Paramiko <http://www.lag.net/paramiko/>`_, if you want automated SSH
38 a40b1fc4 René Nussbaumer
  setup; optional otherwise but manual setup of the nodes required
39 c27ba1cc Michael Hanselmann
40 c27ba1cc Michael Hanselmann
These programs are supplied as part of most Linux distributions, so
41 c27ba1cc Michael Hanselmann
usually they can be installed via the standard package manager. Also
42 c27ba1cc Michael Hanselmann
many of them will already be installed on a standard machine. On
43 c27ba1cc Michael Hanselmann
Debian/Ubuntu, you can use this command line to install all required
44 c27ba1cc Michael Hanselmann
packages, except for DRBD and Xen::
45 c27ba1cc Michael Hanselmann
46 c27ba1cc Michael Hanselmann
  $ apt-get install lvm2 ssh bridge-utils iproute iputils-arping \
47 c27ba1cc Michael Hanselmann
                    python python-pyopenssl openssl python-pyparsing \
48 2a7c3583 Michael Hanselmann
                    python-simplejson python-pyinotify python-pycurl \
49 2a7c3583 Michael Hanselmann
                    socat
50 c27ba1cc Michael Hanselmann
51 c27ba1cc Michael Hanselmann
If you want to build from source, please see doc/devnotes.rst for more
52 c27ba1cc Michael Hanselmann
dependencies.
53 5cd0d9c0 Iustin Pop
54 bd785ecd Michael Hanselmann
55 bd785ecd Michael Hanselmann
Installation of the software
56 c27ba1cc Michael Hanselmann
----------------------------
57 c27ba1cc Michael Hanselmann
58 c27ba1cc Michael Hanselmann
To install, simply run the following command::
59 a8083063 Iustin Pop
60 c27ba1cc Michael Hanselmann
  ./configure --localstatedir=/var --sysconfdir=/etc && \
61 c27ba1cc Michael Hanselmann
  make && \
62 c27ba1cc Michael Hanselmann
  make install
63 a8083063 Iustin Pop
64 c27ba1cc Michael Hanselmann
This will install the software under ``/usr/local``. You then need to
65 c27ba1cc Michael Hanselmann
copy ``doc/examples/ganeti.initd`` to ``/etc/init.d/ganeti`` and
66 c27ba1cc Michael Hanselmann
integrate it into your boot sequence (``chkconfig``, ``update-rc.d``,
67 c27ba1cc Michael Hanselmann
etc.).
68 a8083063 Iustin Pop
69 bd785ecd Michael Hanselmann
70 a8083063 Iustin Pop
Cluster initialisation
71 c27ba1cc Michael Hanselmann
----------------------
72 a8083063 Iustin Pop
73 c27ba1cc Michael Hanselmann
Before initialising the cluster, on each node you need to create the
74 c27ba1cc Michael Hanselmann
following directories:
75 a8083063 Iustin Pop
76 c27ba1cc Michael Hanselmann
- ``/etc/ganeti``
77 c27ba1cc Michael Hanselmann
- ``/var/lib/ganeti``
78 c27ba1cc Michael Hanselmann
- ``/var/log/ganeti``
79 c27ba1cc Michael Hanselmann
- ``/srv/ganeti``
80 c27ba1cc Michael Hanselmann
- ``/srv/ganeti/os``
81 c27ba1cc Michael Hanselmann
- ``/srv/ganeti/export``
82 a8083063 Iustin Pop
83 a8083063 Iustin Pop
After this, use ``gnt-cluster init``.
84 c27ba1cc Michael Hanselmann
85 c27ba1cc Michael Hanselmann
.. vim: set textwidth=72 syntax=rst :
86 c27ba1cc Michael Hanselmann
.. Local Variables:
87 c27ba1cc Michael Hanselmann
.. mode: rst
88 c27ba1cc Michael Hanselmann
.. fill-column: 72
89 c27ba1cc Michael Hanselmann
.. End: