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