Commit fc6075dd authored by Agata Murawska's avatar Agata Murawska
Browse files

Installation instructions update

This patch aims at improving documentation for installing ganeti - both for users and developers.
Signed-off-by: default avatarAgata Murawska <>
Reviewed-by: default avatarIustin Pop <>
parent b647b6d7
......@@ -46,7 +46,7 @@ Before installing, please verify that you have the following programs:
- `affinity Python module <>`_,
optional python package for supporting CPU pinning under KVM
- `ElementTree Python module <>`_,
if running python 2.4 (optional, used by the ``ovfconverter`` tool)
if running on python 2.4 (optional, used by the ``ovfconverter`` tool)
- `qemu-img <>`_, if you want to use ``ovfconverter``
- `fping <>`_
......@@ -59,15 +59,30 @@ packages, except for RBD, DRBD and Xen::
$ apt-get install lvm2 ssh bridge-utils iproute iputils-arping \
ndisc6 python python-pyopenssl openssl \
python-pyparsing python-simplejson \
python-pyinotify python-pycurl socat \
python-elementtree qemu
python-pyinotify python-pycurl socat fping
Note that this does not install optional packages::
$ apt-get install python-paramiko python-affinity qemu-img
If some of the python packages are not available in your system,
you can try installing them using ``easy_install`` command.
For example::
$ apt-get install python-setuptools
$ cd / && sudo easy_install \
On Fedora to install all required packages except RBD, DRBD and Xen::
$ yum install openssh openssh-clients bridge-utils iproute ndisc6 \
pyOpenSSL pyparsing python-simplejson python-inotify \
python-lxml python-paramiko socat qemu-img
python-lxm socat fping
For optional packages use the command::
$ yum install python-paramiko python-affinity qemu-img
If you want to build from source, please see doc/devnotes.rst for more
......@@ -136,8 +151,12 @@ were renamed::
$ apt-get install ghc libghc-json-dev libghc-network-dev \
libghc-parallel-dev libghc-curl-dev
If using a distribution which does not provide them, the first install
the Haskell platform and then install the additional libraries via
If using a distribution which does not provide them, first install
the Haskell platform. You can also install ``cabal`` manualy::
$ apt-get install cabal-install
Then install the additional libraries via
$ cabal install json network parallel curl
......@@ -171,6 +190,14 @@ or ``cabal``::
to install them.
.. _cabal-note:
.. note::
If one of the cabal packages fails to install due to unfulfilled
dependencies, you can try enabling symlinks in ``~/.cabal/config``.
Make sure that your ``~/.cabal/bin`` directory (or whatever else
is defined as ``bindir``) is in your ``PATH``.
Installation of the software
......@@ -6,20 +6,25 @@ Developer notes
Build dependencies
Most dependencies from :doc:`install-quick`, plus (for Python):
Most dependencies from :doc:`install-quick`, including ``qemu-img``
(marked there as optional) plus (for Python):
- `GNU make <>`_
- `GNU tar <>`_
- `Gzip <>`_
- `pandoc <>`_
- `python-epydoc <>`_
- `python-sphinx <>`_
(tested with version 0.6.1)
(tested with version 1.1.3)
- `graphviz <>`_
- the `en_US.UTF-8` locale must be enabled on the system
- `pylint <>`_ and its associated
- `pep8 <>`_
For older developement (Ganeti < 2.4) ``docbook`` was used instead
Note that for pylint, at the current moment the following versions
must be used::
......@@ -27,9 +32,26 @@ must be used::
pylint 0.21.1,
astng 0.20.1, common 0.50.3
The same with pep8, other versions may give you errors::
$ pep8 --version
To generate unittest coverage reports (``make coverage``), `coverage
<>`_ needs to be installed.
Installation of all dependencies listed here::
$ apt-get install python-setuptools
$ apt-get install pandoc python-epydoc graphviz
$ cd / && sudo easy_install \
sphinx \
logilab-astng==0.20.1 \
logilab-common==0.50.3 \
pylint==0.21.1 \
pep8==0.6.1 \
For Haskell development, again all things from the quick install
document, plus:
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment