Ganeti quick installation guide
===============================
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`.
Software Requirements
---------------------
Before installing, please verify that you have the following programs:
- `Xen Hypervisor `_, version 3.0.x or 3.1
- `DRBD `_, kernel module and userspace utils,
version 8.0.7 or above
- `LVM2 `_
- `OpenSSL `_
- `OpenSSH `_
- `bridge utilities `_
- `iproute2 `_
- `arping `_ (part of iputils)
- `Python `_, version 2.4 or above, not 3.0
- `Python OpenSSL bindings `_
- `simplejson Python module `_
- `pyparsing Python module `_
- `pyinotify Python module `_
- `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 \
python-simplejson python-pyinotify socat
If you want to build from source, please see doc/devnotes.rst for more
dependencies.
Installation of the software
----------------------------
To install, simply run the following command::
./configure --localstatedir=/var --sysconfdir=/etc && \
make && \
make install
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.).
Cluster initialisation
----------------------
Before initialising the cluster, on each node you need to create the
following directories:
- ``/etc/ganeti``
- ``/var/lib/ganeti``
- ``/var/log/ganeti``
- ``/srv/ganeti``
- ``/srv/ganeti/os``
- ``/srv/ganeti/export``
After this, use ``gnt-cluster init``.
.. vim: set textwidth=72 syntax=rst :
.. Local Variables:
.. mode: rst
.. fill-column: 72
.. End: