Mercurial > p > roundup > code
comparison doc/installation.txt @ 5911:133efe1fbff7
doc/installation.txt: replace tabs, remove trailing spaces
| author | Thomas Arendsen Hein <thomas@intevation.de> |
|---|---|
| date | Wed, 09 Oct 2019 08:28:17 +0200 |
| parents | aec362e31fcd |
| children | 16eec1c41e0e |
comparison
equal
deleted
inserted
replaced
| 5910:aec362e31fcd | 5911:133efe1fbff7 |
|---|---|
| 113 to have the jinja2_ template engine installed. | 113 to have the jinja2_ template engine installed. |
| 114 | 114 |
| 115 pyjwt | 115 pyjwt |
| 116 To use jwt tokens for login (experimental), install pyjwt. If you | 116 To use jwt tokens for login (experimental), install pyjwt. If you |
| 117 don't have it installed, jwt tokens are not supported. | 117 don't have it installed, jwt tokens are not supported. |
| 118 | 118 |
| 119 Windows Service | 119 Windows Service |
| 120 You can run Roundup as a Windows service if pywin32_ is installed. | 120 You can run Roundup as a Windows service if pywin32_ is installed. |
| 121 Otherwise it must be started manually. | 121 Otherwise it must be started manually. |
| 122 | 122 |
| 123 .. _Xapian: https://xapian.org/ | 123 .. _Xapian: https://xapian.org/ |
| 556 1. The `mod_wsgi`_ PyPi page lists prerequisites for various types of | 556 1. The `mod_wsgi`_ PyPi page lists prerequisites for various types of |
| 557 systems. For Ubuntu, they are apache2 and apache2-dev. To see | 557 systems. For Ubuntu, they are apache2 and apache2-dev. To see |
| 558 installed apache packages, you can use ``dpkg -l | grep apache``. | 558 installed apache packages, you can use ``dpkg -l | grep apache``. |
| 559 If apache2 or apache2-dev are not installed, they install them | 559 If apache2 or apache2-dev are not installed, they install them |
| 560 with: | 560 with: |
| 561 | 561 |
| 562 - ``sudo apt update`` | 562 - ``sudo apt update`` |
| 563 - ``sudo apt install apache2 apache2-dev`` | 563 - ``sudo apt install apache2 apache2-dev`` |
| 564 | 564 |
| 565 2. If ``pip`` is not already installed, install it with | 565 2. If ``pip`` is not already installed, install it with |
| 566 ``sudo apt install python-pip`` | 566 ``sudo apt install python-pip`` |
| 567 | 567 |
| 568 If you are using python 3, use ``sudo apt-install python3-pip`` and | 568 If you are using python 3, use ``sudo apt-install python3-pip`` and |
| 569 change references to pip in the directions to pip3. | 569 change references to pip in the directions to pip3. |
| 631 1. To add a group named "mytrackergrp" run: ``sudo groupadd mytrackergrp``. | 631 1. To add a group named "mytrackergrp" run: ``sudo groupadd mytrackergrp``. |
| 632 2. Add the owner of the tracker home (admin in this example) run: | 632 2. Add the owner of the tracker home (admin in this example) run: |
| 633 ``sudo usermod -a -G mytrackergrp admin`` | 633 ``sudo usermod -a -G mytrackergrp admin`` |
| 634 3. Add user that runs Apache (the default on Ubuntu is www-data) run: | 634 3. Add user that runs Apache (the default on Ubuntu is www-data) run: |
| 635 ``sudo usermod -a -G mytrackergrp www-data`` | 635 ``sudo usermod -a -G mytrackergrp www-data`` |
| 636 4. Add user mail service runs as (e.g. daemon) run: | 636 4. Add user mail service runs as (e.g. daemon) run: |
| 637 ``sudo usermod -a -G mytrackergrp daemon`` | 637 ``sudo usermod -a -G mytrackergrp daemon`` |
| 638 5. Change group of the database in the tracker folder run: | 638 5. Change group of the database in the tracker folder run: |
| 639 ``sudo chgrp -R mytrackergrp ~/trackers/mytracker``. | 639 ``sudo chgrp -R mytrackergrp ~/trackers/mytracker``. |
| 640 6. Make sure group can write to the database, and any new files created | 640 6. Make sure group can write to the database, and any new files created |
| 641 in the database will be owned by the group run: | 641 in the database will be owned by the group run: |
| 830 DocumentRoot /var/www/ | 830 DocumentRoot /var/www/ |
| 831 | 831 |
| 832 <VirtualHost *:80> | 832 <VirtualHost *:80> |
| 833 CustomLog /var/log/apache2/access.log vhost_combined | 833 CustomLog /var/log/apache2/access.log vhost_combined |
| 834 | 834 |
| 835 # allow access to roundup docs | 835 # allow access to roundup docs |
| 836 Alias /doc/ /home/roundup/install/share/doc/roundup/html/ | 836 Alias /doc/ /home/roundup/install/share/doc/roundup/html/ |
| 837 | 837 |
| 838 # make apache serve static assets like css rather than | 838 # make apache serve static assets like css rather than |
| 839 # having roundup serve the files | 839 # having roundup serve the files |
| 840 Alias /foo/@@file/ /srv/roundup/foo/html/ | 840 Alias /foo/@@file/ /srv/roundup/foo/html/ |
| 841 | 841 |
| 842 # make /foo into /foo/ | 842 # make /foo into /foo/ |
| 843 RedirectMatch permanent ^/(foo)$ /$1/ | 843 RedirectMatch permanent ^/(foo)$ /$1/ |
| 844 | 844 |
| 845 # start a wsgi daemon process running as user roundup-foo | 845 # start a wsgi daemon process running as user roundup-foo |
| 846 # in group roundup-foo. This also changes directory to | 846 # in group roundup-foo. This also changes directory to |
| 847 # ~roundup-foo before it starts roundup.wsgi. | 847 # ~roundup-foo before it starts roundup.wsgi. |
| 848 WSGIDaemonProcess roundup-foo display-name=roundup-foo user=roundup-foo group=roundup-foo threads=25 | 848 WSGIDaemonProcess roundup-foo display-name=roundup-foo user=roundup-foo group=roundup-foo threads=25 |
| 849 | 849 |
| 850 # make tracker available at /foo and tie it into the | 850 # make tracker available at /foo and tie it into the |
| 851 # wsgi script below. | 851 # wsgi script below. |
| 852 WSGIScriptAlias /foo /srv/roundup/foo/roundup.wsgi | 852 WSGIScriptAlias /foo /srv/roundup/foo/roundup.wsgi |
| 853 <Location /foo> | 853 <Location /foo> |
| 854 WSGIProcessGroup roundup-foo | 854 WSGIProcessGroup roundup-foo |
| 855 </Location> | 855 </Location> |
| 856 </VirtualHost> | 856 </VirtualHost> |
| 872 | 872 |
| 873 enabled = True | 873 enabled = True |
| 874 | 874 |
| 875 if enabled: | 875 if enabled: |
| 876 # Add the directory with the roundup installation | 876 # Add the directory with the roundup installation |
| 877 # subdirectory to the python path. | 877 # subdirectory to the python path. |
| 878 sys.path.insert(0, '/home/roundup/install/lib/python') | 878 sys.path.insert(0, '/home/roundup/install/lib/python') |
| 879 | 879 |
| 880 # obtain the WSGI request dispatcher | 880 # obtain the WSGI request dispatcher |
| 881 from roundup.cgi.wsgi_handler import RequestDispatcher | 881 from roundup.cgi.wsgi_handler import RequestDispatcher |
| 882 | 882 |
| 883 tracker_home = os.path.join(os.getcwd(), 'instance') | 883 tracker_home = os.path.join(os.getcwd(), 'instance') |
| 884 application = RequestDispatcher(tracker_home) | 884 application = RequestDispatcher(tracker_home) |
| 885 else: | 885 else: |
| 886 def application(environ, start_response): | 886 def application(environ, start_response): |
| 887 status = '503 Service Unavailable' | 887 status = '503 Service Unavailable' |