Changes between Version 1 and Version 2 of TracModPython

Timestamp:

Jan 30, 2006, 11:09:16 PM (18 years ago)

Author:

trac

Comment:

--

TracModPython

@@ -2 +2 @@
 
 Trac supports [http://www.modpython.org/ mod_python], which speeds up Trac's response times considerably and permits use of many Apache features not possible with [wiki:TracStandalone tracd]/mod_proxy.
-
-Be sure to grab mod_python 3.1.3 and later for ''SetHandler'' ''mod_python'' directive to work.  Also, older versions may generate an internal error (see [http://projects.edgewall.com/trac/ticket/1090 #1090])
 
 == Simple configuration ==
@@ -16 +14 @@
 <Location /projects/myproject>
    SetHandler mod_python
-   PythonHandler trac.ModPythonHandler
+   PythonHandler trac.web.modpython_frontend 
    PythonOption TracEnv /var/trac/myproject
    PythonOption TracUriRoot /projects/myproject
@@ -43 +41 @@
 }}}
 
+
 == Setting up multiple projects ==
 
@@ -49 +48 @@
 <Location /projects>
   SetHandler mod_python
-  PythonHandler trac.ModPythonHandler
+  PythonHandler trac.web.modpython_frontend 
   PythonOption TracEnvParentDir /var/trac
   PythonOption TracUriRoot /projects
@@ -74 +73 @@
 }}}
 
+== Virtual Host Configuration ==
+
+Below is the sample configuration required to set up your trac as a virtual server (i.e. when you access it at the URLs like
+!http://trac.mycompany.com):
+
+{{{
+<VirtualHost * >
+    DocumentRoot /var/trac/myproject
+    ServerName trac.mycompany.com
+    <Directory />
+        SetHandler mod_python
+        PythonHandler trac.web.modpython_frontend
+        PythonOption TracEnv /var/trac/myproject
+        PythonOption TracUriRoot /
+    </Directory>
+    <Location /login>
+        AuthType Basic
+        AuthName "MyCompany Trac Server"
+        AuthUserFile /var/trac/myproject/.htusers
+        Require valid-user
+    </Location>
+</VirtualHost>
+}}}
+
 == Troubleshooting ==
 
@@ -88 +111 @@
 === Win32 Issues ===
 
-If you run trac with mod_python on Windows, attachments will not work.
+If you run trac with mod_python (3.1.3 or 3.1.4) on Windows, 
+uploading attachments will '''not''' work.
+This is a known problem which we can't solve cleanly at the Trac level.
 
-There is a (simple) workaround for this which is to apply the patch attached to 
-ticket [http://projects.edgewall.com/trac/ticket/554 #554].
+However, there is a workaround for this at the mod_python level, 
+which is to apply the following patch [http://projects.edgewall.com/trac/attachment/ticket/554/util_py.patch attachment:ticket:554:util_py.patch] 
+to the (Lib/site-packages)/modpython/util.py file.
+
+If you don't have the `patch` command, that file can be replaced with the [http://svn.apache.org/viewcvs.cgi/httpd/mod_python/trunk/lib/python/mod_python/util.py?rev=103562&view=markup  fixed util.py] (fix which, although done prior to the 3.1.4 release, is ''not'' 
+present in 3.1.4).
 
 === OS X issues ===