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