root / doc / devnotes.rst @ 94338f0a
History | View | Annotate | Download (1.9 kB)
1 |
Developer notes |
---|---|
2 |
=============== |
3 |
|
4 |
Build dependencies |
5 |
------------------ |
6 |
|
7 |
Most dependencies from :doc:`install-quick`, plus: |
8 |
|
9 |
- `GNU make <http://www.gnu.org/software/make/>`_ |
10 |
- `GNU tar <http://www.gnu.org/software/tar/>`_ |
11 |
- `Gzip <http://www.gnu.org/software/gzip/>`_ |
12 |
- `Docbook tools <http://sources.redhat.com/docbook-tools/>`_ |
13 |
(docbook2html and docbook2man) |
14 |
- `python-sphinx <http://sphinx.pocoo.org/>`_ |
15 |
(tested with version 0.6.1) |
16 |
- `graphviz <http://www.graphviz.org/>`_ |
17 |
|
18 |
|
19 |
Configuring for development |
20 |
--------------------------- |
21 |
|
22 |
.. highlight:: sh |
23 |
|
24 |
Run the following command (only use ``PYTHON=...`` if you need to use a |
25 |
different python version):: |
26 |
|
27 |
./autogen.sh && \ |
28 |
./configure PYTHON=python2.4 \ |
29 |
--prefix=/usr/local --sysconfdir=/etc --localstatedir=/var |
30 |
|
31 |
|
32 |
Packaging notes |
33 |
=============== |
34 |
|
35 |
Ganeti is mostly developped and tested on `Debian |
36 |
<http://www.debian.org/>`_-based distributions, while still keeping |
37 |
adoptability to other Linux distributions in mind. |
38 |
|
39 |
The ``doc/examples/`` directory contains a number of potentially useful |
40 |
scripts and configuration files. Some of them might need adjustment |
41 |
before use. |
42 |
|
43 |
``daemon-util`` |
44 |
--------------- |
45 |
|
46 |
This script, in the source code as ``daemons/daemon-util.in``, is used |
47 |
to start/stop Ganeti and do a few other things related to system |
48 |
daemons. Is is recommended to use ``daemon-util`` also from the system's |
49 |
init scripts. That way the code starting and stopping daemons is shared |
50 |
and future changes have to be made in only one place. |
51 |
|
52 |
``daemon-util`` reads extra arguments from variables (``*_ARGS``) in |
53 |
``/etc/default/ganeti``. When modifying ``daemon-util``, keep in mind to |
54 |
not remove support for the ``EXTRA_*_ARGS`` variables for starting |
55 |
daemons. Some parts of Ganeti use them to pass additional arguments when |
56 |
starting a daemon. |
57 |
|
58 |
The ``reload_ssh_keys`` function can be adjusted to use another command |
59 |
for reloading the OpenSSH daemon's host keys. |
60 |
|
61 |
.. vim: set textwidth=72 : |