aodh/doc/source/contributor/install/uwsgi.rst
Yuanbin.Chen 86117fd98c Fix doc title format error
Change-Id: Iafe03c967ca7b3e39d532f434b2f21fb43fa0d29
Signed-off-by: Yuanbin.Chen <cybing4@gmail.com>
2018-04-09 13:24:01 +08:00

63 lines
1.8 KiB
ReStructuredText

=============================
Installing the API with uwsgi
=============================
Aodh comes with a few example files for configuring the API
service to run behind Apache with ``mod_wsgi``.
app.wsgi
========
The file ``aodh/api/app.wsgi`` sets up the V2 API WSGI
application. The file is installed with the rest of the Aodh
application code, and should not need to be modified.
Example of uwsgi configuration file
===================================
Create aodh-uwsgi.ini file::
[uwsgi]
http = 0.0.0.0:8041
wsgi-file = <path_to_aodh>/aodh/api/app.wsgi
plugins = python
# This is running standalone
master = true
# Set die-on-term & exit-on-reload so that uwsgi shuts down
exit-on-reload = true
die-on-term = true
# uwsgi recommends this to prevent thundering herd on accept.
thunder-lock = true
# Override the default size for headers from the 4k default. (mainly for keystone token)
buffer-size = 65535
enable-threads = true
# Set the number of threads usually with the returns of command nproc
threads = 8
# Make sure the client doesn't try to re-use the connection.
add-header = Connection: close
# Set uid and gip to an appropriate user on your server. In many
# installations ``aodh`` will be correct.
uid = aodh
gid = aodh
Then start the uwsgi server::
uwsgi ./aodh-uwsgi.ini
Or start in background with::
uwsgi -d ./aodh-uwsgi.ini
Configuring with uwsgi-plugin-python on Debian/Ubuntu
=====================================================
Install the Python plugin for uwsgi:
apt-get install uwsgi-plugin-python
Run the server:
uwsgi_python --master --die-on-term --logto /var/log/aodh/aodh-api.log \
--http-socket :8042 --wsgi-file /usr/share/aodh-common/app.wsgi