Revision 972820a2 docs/src/deployment.rst

b/docs/src/deployment.rst
74 74

  
75 75
WEBAPP
76 76
******
77
Synnefo WEBAPP node is the server that runs the web application contained within
78
the synnefo package. At the current state Synnefo provides two web frontends.
77
Synnefo WEBAPP node is the server that runs the web application bundled within
78
the synnefo package. The application provides 2 different interfaces.
79

  
80

  
81
Web admin
82
`````````
83
Synnefo web administration interface. Allows administrator users to manage the
84
synnefo application via web interface.
85

  
86
Web application
87
```````````````
88
Web interface which allows users to create/configure/manage their virtual
89
machines.
90

  
91
.. _dispatcher-deploy:
92

  
93
Dispatcher
94
----------
95

  
96
The logic dispatcher is part of the Synnefo Django project and must run
97
on :ref:`LOGIC <LOGIC_NODE>` nodes.
98

  
99
The dispatcher retrieves messages from the queue and calls the appropriate
100
handler function as defined in the queue configuration in `/etc/synnefo/*.conf`
101
files.
102

  
103
The default configuration should work directly without any modifications.
104

  
105
For the time being The dispatcher must be run by hand::
106

  
107
  $ synnefo-dispatcher
108

  
109
The dispatcher should run in at least 2 instances to ensure high
110
(actually, increased) availability.
79 111

  
80 112

  
81 113
.. _webapp-deploy:
......
83 115
Web application deployment
84 116
--------------------------
85 117

  
118

  
119
.. _static-files:
120

  
121
Static files
122
************
123

  
124
* Choose an appropriate path (e.g. /var/lib/synnefo/static/) from which your web 
125
  server will serve all static files (js/css) required by Synnefo web frontend to 
126
  run.
127
* Change ``MEDIA_ROOT`` value in your settings to point to that directory.
128
* Run the following command which will create symlinks of static files in
129
  that directory::
130
    
131
    $ synnefo-manage link_static
132

  
133

  
86 134
Using Apache
87 135
************
88 136

  
......
91 139
Using nginx
92 140
***********
93 141

  
94
.. todo:: document nginx configuration
142
**Sample nginx configuration using fcgi**
143

  
144
.. literalinclude:: ../_static/synnefo.nginx.conf
95 145

  
96
Serving static files
97
********************
146
`download <../_static/synnefo.nginx.conf>`_
98 147

  
99
.. todo:: document serving static files instructions
148
run the fcgi server::
100 149

  
150
    $ synnefo-manage runfcgi host=127.0.0.1 port=8015

Also available in: Unified diff