Mercurial > p > roundup > code
comparison doc/installation.txt @ 5938:16eec1c41e0e
Add basic gunicorn configuration mechanism.
Works for me...
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Sun, 20 Oct 2019 21:13:29 -0400 |
| parents | 133efe1fbff7 |
| children | 459426a8c61e |
comparison
equal
deleted
inserted
replaced
| 5937:5d0873a4de4a | 5938:16eec1c41e0e |
|---|---|
| 798 serving with SSL. | 798 serving with SSL. |
| 799 | 799 |
| 800 WSGI Variations | 800 WSGI Variations |
| 801 ~~~~~~~~~~~~~~~ | 801 ~~~~~~~~~~~~~~~ |
| 802 | 802 |
| 803 Apache Alternate | |
| 804 ^^^^^^^^^^^^^^^^ | |
| 805 | |
| 803 This method from Thomas Arendsen Hein goes into a bit more detail and | 806 This method from Thomas Arendsen Hein goes into a bit more detail and |
| 804 is designed to allow you to run multiple roundup trackers each under | 807 is designed to allow you to run multiple roundup trackers each under |
| 805 their own user. | 808 their own user. |
| 806 | 809 |
| 807 The tracker instances are read-only to the tracker user and located | 810 The tracker instances are read-only to the tracker user and located |
| 896 roundup.wsgi file and reload it. | 899 roundup.wsgi file and reload it. |
| 897 | 900 |
| 898 One last change is needed. In the tracker's config.ini change the db | 901 One last change is needed. In the tracker's config.ini change the db |
| 899 parameter in the [main] section to be /home/roundup-foo/db. This will | 902 parameter in the [main] section to be /home/roundup-foo/db. This will |
| 900 put the files and messages in the db directory for the user. | 903 put the files and messages in the db directory for the user. |
| 904 | |
| 905 Gunicorn Installation | |
| 906 ^^^^^^^^^^^^^^^^^^^^^ | |
| 907 | |
| 908 To run with gunicorn use pip to install gunicorn. This configuration | |
| 909 uses a front end web server like nginx, hiawatha, apache configured as | |
| 910 a reverse proxy. See your web server's documentation on how to set it | |
| 911 up as a reverse proxy. | |
| 912 | |
| 913 The file wsgi.py should be in the current directory with the | |
| 914 contents:: | |
| 915 | |
| 916 # if roundup is not installed on the default PYTHONPATH | |
| 917 # set it here with: | |
| 918 import sys | |
| 919 sys.path.append('/path/to/roundup/install/directory') | |
| 920 | |
| 921 # obtain the WSGI request dispatcher | |
| 922 from roundup.cgi.wsgi_handler import RequestDispatcher | |
| 923 tracker_home = '/path/to/tracker/install/directory' | |
| 924 | |
| 925 app = RequestDispatcher(tracker_home) | |
| 926 | |
| 927 Assuming the proxy forwards /tracker, run gunicorn as:: | |
| 928 | |
| 929 SCRIPT_NAME=/tracker gunicorn --bind 127.0.0.1:8917 --timeout=10 wsgi:app | |
| 930 | |
| 931 this runs roundup at port 8917 on the loopback interface. You should | |
| 932 configure the reverse proxy to talk to 127.0.0.1 at port 8917. | |
| 901 | 933 |
| 902 Configure an Email Interface | 934 Configure an Email Interface |
| 903 ---------------------------- | 935 ---------------------------- |
| 904 | 936 |
| 905 If you don't want to use the email component of Roundup, then remove the | 937 If you don't want to use the email component of Roundup, then remove the |