root / snf-app / docs / src / snf-asterias-app.rst @ 252bb277
History | View | Annotate | Download (2 kB)
1 |
.. _snf-asterias-app: |
---|---|
2 |
|
3 |
Component snf-asterias-app |
4 |
========================== |
5 |
|
6 |
synnefo component :ref:`snf-asterias-app <snf-asterias-app>` defines the main |
7 |
web application for asterias, as a set of Django applications. |
8 |
|
9 |
Package installation |
10 |
-------------------- |
11 |
|
12 |
.. todo:: kpap: verify instructions for installation from source. |
13 |
|
14 |
Use ``pip`` to install the latest version of the package from source, |
15 |
or request a specific version as ``snf-asterias-app==x.y.z``. |
16 |
|
17 |
.. code-block:: console |
18 |
|
19 |
$ pip install snf-asterias-app -f https://code.grnet.gr/projects/synnefo/files |
20 |
|
21 |
On Debian Squeeze, install the ``snf-asterias-app`` Debian package. |
22 |
|
23 |
Package configuration |
24 |
--------------------- |
25 |
|
26 |
.. todo:: The Debian package does the following configuration steps |
27 |
automatically, see ``/etc/default/snf-ganeti-eventd``. |
28 |
|
29 |
Event daemon |
30 |
************ |
31 |
|
32 |
Make sure the event daemon starts automatically on system boot. |
33 |
Initscript ``conf/init.d/snf-ganeti-eventd`` is provided for your convenience. |
34 |
|
35 |
Hook |
36 |
**** |
37 |
The hook needs to be enabled for phases ``post-{add,modify,reboot,start,stop}`` |
38 |
by *symlinking* in |
39 |
``/etc/ganeti/hooks/instance-{add,modify,reboot,start,stop}-post.d`` |
40 |
on :ref:`GANETI-MASTER <GANETI_MASTER>`, e.g.: |
41 |
|
42 |
.. code-block:: console |
43 |
|
44 |
root@ganeti-master:/etc/ganeti/hooks/instance-start-post.d# ls -l |
45 |
lrwxrwxrwx 1 root root 45 May 3 13:45 00-snf-ganeti-hook -> /home/devel/synnefo/snf-ganeti-hook/snf-ganeti-hook.py |
46 |
|
47 |
.. todo:: fix the actual location of the link target above. |
48 |
|
49 |
.. note:: |
50 |
The link name may only contain "upper and lower case, digits, |
51 |
underscores and hyphens. In other words, the regexp ^[a-zA-Z0-9\_-]+$." |
52 |
|
53 |
.. seealso:: |
54 |
`Ganeti customisation using hooks <http://docs.ganeti.org/ganeti/master/html/hooks.html?highlight=hooks#naming>`_ |
55 |
|
56 |
Package settings |
57 |
---------------- |
58 |
|
59 |
Component :ref:`snf-asterias-app <snf-asterias-app>` requires the following |
60 |
settings, as managed by :ref:`snf-common <snf-common>`: |
61 |
|
62 |
.. literalinclude:: ../../../snf-app/synnefo/app_settings/default/*.py |
63 |
|
64 |
.. todo:: make sure the settings are included properly above this point. |