Statistics
| Branch: | Tag: | Revision:

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.