diff doc/installation.txt @ 5891:6e341009593b

Deprecate mod_python issue2551005 Planning deprecation of mod_python. Intent it to replace with mod_wsgi, but we have no good docs for it.
author John Rouillard <rouilj@ieee.org>
date Wed, 02 Oct 2019 18:13:25 -0400
parents 1b57d8f3eb97
children c7ab00dd6502
line wrap: on
line diff
--- a/doc/installation.txt	Wed Oct 02 18:04:13 2019 -0400
+++ b/doc/installation.txt	Wed Oct 02 18:13:25 2019 -0400
@@ -376,8 +376,8 @@
 2. `cgi-bin for limited-access hosting`_
 3. `stand-alone web server`_
 4. `Zope product - ZRoundup`_
-5. `Apache HTTP Server with mod_python`_
-6. `WSGI handler`_
+5. `WSGI handler`_  (to be written `Apache HTTP Server with mod_wsgi`_)
+6. `Apache HTTP Server with mod_python`_  (deprecated)
 
 You may need to give the web server user permission to access the tracker home
 - see the `UNIX environment steps`_ for information. You may also need to
@@ -505,9 +505,23 @@
 When you next (re)start up Zope, you will be able to add a ZRoundup object
 that interfaces to your new tracker.
 
+Apache HTTP Server with mod_wsgi
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This needs to be developed by somebody. See:
+https://issues.roundup-tracker.org/issue2550566 to see if there has
+been something developed.
+
+See the main web site for `mod_wsgi`_.
+
 Apache HTTP Server with mod_python
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+As of roundup 2.0, mod_python support is deprecated. The apache.py
+file is still available, but may be limited to working for Python 2
+only. Using mod_wsgi with Apache is the recommended way to deploy
+roundup under apache.
+
 `Mod_python`_ is an `Apache`_ module that embeds the Python interpreter
 within the server.  Running Roundup this way is much faster than all
 above options and, like `web server cgi-bin`_, allows you to use HTTPS
@@ -1119,6 +1133,7 @@
 .. _apache: http://httpd.apache.org/
 .. _flup: https://pypi.org/project/flup/
 .. _mod_python: http://modpython.org/
+.. _mod_wsgi: https://pypi.org/project/mod-wsgi/
 .. _MySQLdb: https://pypi.org/project/mysqlclient/
 .. _Psycopg: http://initd.org/psycopg/
 .. _pysqlite: https://pysqlite.org/

Roundup Issue Tracker: http://roundup-tracker.org/