Mercurial > p > roundup > code
comparison doc/installation.txt @ 7700:939e2edeab40
doc: use 'TEST-NET' IPv4 or IPv6 IP address ranges from RFC 6890
Replace ip examples with test doc ip addresses for any address not in
127.0.0.1 or 0.0.0.0.
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Tue, 14 Nov 2023 16:52:09 -0500 |
| parents | 4e37a7833708 |
| children | 36c3acb4b49b |
comparison
equal
deleted
inserted
replaced
| 7699:e10d0b262abd | 7700:939e2edeab40 |
|---|---|
| 848 - roundup is running in the system python instance (e.g. no virtual | 848 - roundup is running in the system python instance (e.g. no virtual |
| 849 environment) | 849 environment) |
| 850 - the tracker ``mytracker`` is installed in the ``trackers`` folder of | 850 - the tracker ``mytracker`` is installed in the ``trackers`` folder of |
| 851 home directory of a user called ``admin``. Thus, the absolute path to | 851 home directory of a user called ``admin``. Thus, the absolute path to |
| 852 the tracker home directory is ``/home/admin/trackers/mytracker``. | 852 the tracker home directory is ``/home/admin/trackers/mytracker``. |
| 853 - the server has a static public IP address of 11.11.11.101 | 853 - the server has a static public IP address of 198.51.100.25 |
| 854 | 854 |
| 855 Install mod-wsgi | 855 Install mod-wsgi |
| 856 ~~~~~~~~~~~~~~~~ | 856 ~~~~~~~~~~~~~~~~ |
| 857 | 857 |
| 858 You can install/build it using the python package manager pip, or | 858 You can install/build it using the python package manager pip, or |
| 896 rule. | 896 rule. |
| 897 5. Test with ``mod_wsgi-express start-server``. This should serve | 897 5. Test with ``mod_wsgi-express start-server``. This should serve |
| 898 up content on localhost port 8000. You can then direct a browser on | 898 up content on localhost port 8000. You can then direct a browser on |
| 899 the server itself to ``http://localhost:8000/`` or on another machine at | 899 the server itself to ``http://localhost:8000/`` or on another machine at |
| 900 the server's domain name or ip address followed by colon then 8000 | 900 the server's domain name or ip address followed by colon then 8000 |
| 901 (e.g. ``http://11.11.11.101:8000/``). If successful, you should see a | 901 (e.g. ``http://198.51.100.25:8000/``). If successful, you should see a |
| 902 Malt Whiskey image. | 902 Malt Whiskey image. |
| 903 | 903 |
| 904 Package manager install of mod_wsgi | 904 Package manager install of mod_wsgi |
| 905 ''''''''''''''''''''''''''''''''''' | 905 ''''''''''''''''''''''''''''''''''' |
| 906 | 906 |
| 933 | 933 |
| 934 To run the tracker on Port 8000 as a foreground process | 934 To run the tracker on Port 8000 as a foreground process |
| 935 ''''''''''''''''''''''''''''''''''''''''''''''''''''''' | 935 ''''''''''''''''''''''''''''''''''''''''''''''''''''''' |
| 936 | 936 |
| 937 1. Change the ``tracker.web`` url in ``config.ini`` to port 8000 at the | 937 1. Change the ``tracker.web`` url in ``config.ini`` to port 8000 at the |
| 938 server domain name or ip address (e.g. ``http://11.11.11.101:8000/``). | 938 server domain name or ip address (e.g. ``http://198.51.100.25:8000/``). |
| 939 2. Open port 8000 for TCP on the server if you didn't already do so. | 939 2. Open port 8000 for TCP on the server if you didn't already do so. |
| 940 3. ``cd`` to your tracker home directory, then run | 940 3. ``cd`` to your tracker home directory, then run |
| 941 ``mod_wsgi-express start-server wsgi.py``. | 941 ``mod_wsgi-express start-server wsgi.py``. |
| 942 4. Test by directing a browser on another machine to the url you set | 942 4. Test by directing a browser on another machine to the url you set |
| 943 ``tracker.web`` to in ``config.ini``. | 943 ``tracker.web`` to in ``config.ini``. |
| 964 | 964 |
| 965 To run mod_wsgi on PORT 80 | 965 To run mod_wsgi on PORT 80 |
| 966 '''''''''''''''''''''''''' | 966 '''''''''''''''''''''''''' |
| 967 | 967 |
| 968 1. Change the ``tracker.web`` url in ``config.ini`` to the server url | 968 1. Change the ``tracker.web`` url in ``config.ini`` to the server url |
| 969 with no port designator. E.g. ``http://11.11.11.101``. | 969 with no port designator. E.g. ``http://198.51.100.25``. |
| 970 2. Open port 80 on the server for TCP traffic if it isn't open already. | 970 2. Open port 80 on the server for TCP traffic if it isn't open already. |
| 971 3. Stop the system instance of Apache to make sure it isn't holding on | 971 3. Stop the system instance of Apache to make sure it isn't holding on |
| 972 to port 80 run: ``sudo service apache2 stop``. | 972 to port 80 run: ``sudo service apache2 stop``. |
| 973 | 973 |
| 974 To run as a foreground process | 974 To run as a foreground process |