4 .. highlight:: shell-example
9 Most dependencies from :doc:`install-quick`, including ``qemu-img``
10 (marked there as optional) plus (for Python):
12 - `GNU make <http://www.gnu.org/software/make/>`_
13 - `GNU tar <http://www.gnu.org/software/tar/>`_
14 - `Gzip <http://www.gnu.org/software/gzip/>`_
15 - `pandoc <http://johnmacfarlane.net/pandoc/>`_
16 - `python-epydoc <http://epydoc.sourceforge.net/>`_
17 - `python-sphinx <http://sphinx.pocoo.org/>`_
18 (tested with version 1.1.3)
19 - `graphviz <http://www.graphviz.org/>`_
20 - the `en_US.UTF-8` locale must be enabled on the system
21 - `pylint <http://www.logilab.org/857>`_ and its associated
23 - `pep8 <https://github.com/jcrocholl/pep8/>`_
25 For older developement (Ganeti < 2.4) ``docbook`` was used instead
28 Note that for pylint, at the current moment the following versions
33 astng 0.20.1, common 0.50.3
35 The same with pep8, other versions may give you errors::
40 To generate unittest coverage reports (``make coverage``), `coverage
41 <http://pypi.python.org/pypi/coverage>`_ needs to be installed.
43 Installation of all dependencies listed here::
45 $ apt-get install python-setuptools
46 $ apt-get install pandoc python-epydoc graphviz
47 $ cd / && sudo easy_install \
49 logilab-astng==0.20.1 \
50 logilab-common==0.50.3 \
55 For Haskell development, again all things from the quick install
58 - `haddock <http://www.haskell.org/haddock/>`_, documentation
59 generator (equivalent to epydoc for Python)
60 - `HsColour <http://hackage.haskell.org/package/hscolour>`_, again
61 used for documentation (it's source-code pretty-printing)
62 - `hlint <http://community.haskell.org/~ndm/hlint/>`_, a source code
63 linter (equivalent to pylint for Python), recommended version 1.8 or
64 above (tested with 1.8.15)
65 - the `QuickCheck <http://hackage.haskell.org/package/QuickCheck>`_
67 - the `HUnit <http://hunit.sourceforge.net/>`_ library (tested with
70 <http://batterseapower.github.com/test-framework/>`_ libraries,
71 tested versions: ``test-framework``: 0.6, ``test-framework-hunit``:
72 0.2.7, ``test-framework-quickcheck2``: 0.2.12
73 - ``hpc``, which comes with the compiler, so you should already have
75 - `shelltestrunner <http://joyful.com/shelltestrunner>`_, used for
76 running shell-based unit-tests
78 Under Debian Wheezy or later, these can be installed (on top of the
79 required ones from the quick install document) via::
81 $ apt-get install libghc-quickcheck2-dev libghc-hunit-dev \
82 libghc-test-framework-dev \
83 libghc-test-framework-quickcheck2-dev \
84 libghc-test-framework-hunit-dev \
87 Or alternatively via ``cabal``::
89 $ cabal install QuickCheck HUnit \
90 test-framework test-framework-quickcheck2 test-framework-hunit \
91 hscolour hlint shelltestrunner
94 Configuring for development
95 ---------------------------
97 Run the following command (only use ``PYTHON=...`` if you need to use a
98 different python version)::
101 ./configure --prefix=/usr/local --sysconfdir=/etc --localstatedir=/var
103 Haskell development notes
104 -------------------------
106 There are a few things which can help writing or debugging the Haskell
109 You can run the Haskell linter :command:`hlint` via::
113 This is not enabled by default (as the htools component is
114 optional). The above command will generate both output on the terminal
115 and, if any warnings are found, also an HTML report at
116 ``doc/hs-lint.html``.
118 When writing or debugging TemplateHaskell code, it's useful to see
119 what the splices are converted to. This can be done via::
121 $ make HEXTRA="-ddump-splices"
123 Due to the way TemplateHaskell works, it's not straightforward to
124 build profiling code. The recommended way is to run ``make hs-prof``,
125 or alternatively the manual sequence is::
128 $ make htools/htools HEXTRA="-osuf .o"
130 $ make htools/htools HEXTRA="-osuf .prof_o -prof -auto-all"
132 This will build the binary twice, per the TemplateHaskell
133 documentation, the second one with profiling enabled.
139 Ganeti is mostly developed and tested on `Debian
140 <http://www.debian.org/>`_-based distributions, while still keeping
141 adaptability to other Linux distributions in mind.
143 The ``doc/examples/`` directory contains a number of potentially useful
144 scripts and configuration files. Some of them might need adjustment
150 This script, in the source code as ``daemons/daemon-util.in``, is used
151 to start/stop Ganeti and do a few other things related to system
152 daemons. It is recommended to use ``daemon-util`` also from the system's
153 init scripts. That way the code starting and stopping daemons is shared
154 and future changes have to be made in only one place.
156 ``daemon-util`` reads extra arguments from variables (``*_ARGS``) in
157 ``/etc/default/ganeti``. When modifying ``daemon-util``, keep in mind to
158 not remove support for the ``EXTRA_*_ARGS`` variables for starting
159 daemons. Some parts of Ganeti use them to pass additional arguments when
162 The ``reload_ssh_keys`` function can be adjusted to use another command
163 for reloading the OpenSSH daemon's host keys.
165 .. vim: set textwidth=72 :