better doc for uwsgi

backend/README.md

@@ -81,21 +81,33 @@ create wsgidav configuration file for webdav:
 
     cp wsgidav.conf.sample wsgidav.conf
 
-## Run Tracim_backend ##
+## Run Tracim_backend With Uwsgi : great for production ##
 
-### With Uwsgi ###
 
-Run all services with uwsgi
+#### Install Uwsgi
+
+You can either install uwsgi with pip or with you distrib package manager:
 
     # install uwsgi with pip ( unneeded if you already have uwsgi with python3 plugin enabled)
     sudo pip3 install uwsgi
+
+or on debian 9 :
+
+    # install uwsgi on debian 9
+    sudo apt install uwsgi uwsgi-plugin-python3
+
+### All in terminal way ###
+
+
+Run all services with uwsgi
+
     # set tracim_conf_file path
     export TRACIM_CONF_PATH="$(pwd)/development.ini"
     export TRACIM_WEBDAV_CONF_PATH="$(pwd)/wsgidav.conf"
     # pyramid webserver
-    uwsgi -d /tmp/tracim_web.log --http-socket :6543 --wsgi-file wsgi/web.py -H env --pidfile /tmp/tracim_web.pid
+    uwsgi -d /tmp/tracim_web.log --http-socket :6543 --plugin python3 --wsgi-file wsgi/web.py -H env --pidfile /tmp/tracim_web.pid
     # webdav wsgidav server
-    uwsgi -d /tmp/tracim_webdav.log --http-socket :3030 --wsgi-file wsgi/webdav.py -H env --pidfile /tmp/tracim_webdav.pid
+    uwsgi -d /tmp/tracim_webdav.log --http-socket :3030 --plugin python3 --wsgi-file wsgi/webdav.py -H env --pidfile /tmp/tracim_webdav.pid
 
 to stop them:
 
@@ -104,7 +116,36 @@ to stop them:
     # webdav wsgidav server
     uwsgi --stop /tmp/tracim_webdav.pid
 
-### With Waitress (legacy way, usefull for debug) ###
+## With Uwsgi ini script file ##
+
+You can also preset uwsgi config for tracim, this way, creating this kind of .ini file:
+
+    # You need to replace <PATH> with correct absolute path
+    [uwsgi]
+    plugins = python3
+    chdir = <PATH>/tracim_v2/backend/
+    module = wsgi.web:application
+    home = <PATH>/tracim_v2/backend/env/
+    env = TRACIM_CONF_PATH=<PATH>/tracim_v2/backend/development.ini
+
+and :
+
+    # You need to replace <PATH> with correct absolute path
+    [uwsgi]
+    plugins = python3
+    chdir = <PATH>/tracim_v2/backend/
+    module = wsgi.webdav:application
+    home = <PATH>/tracim_v2/backend/env/
+    env = TRACIM_CONF_PATH=<PATH>/tracim_v2/backend/development.ini
+
+You can then run the process this way :
+
+    # You need to replace <WSGI_CONF_WEB> with correct path
+    uwsgi --ini <WSGI_CONF_WEB>.ini --http-socket :6543
+    # You need to replace <WSGI_CONF_WEBDAV> with correct path
+    uwsgi --ini <WSGI_CONF_WEBDAV>.ini --http-socket :3030
+
+### Run Tracim_Backend with Waitress : legacy way, usefull for debug and dev ###
 
 run tracim_backend web api: