Development

TracModPython (diff)

You must first sign up to be able to contribute.

Changes between Version 1 and Version 2 of TracModPython

Show
Ignore:
Author:
trac (IP: 127.0.0.1)
Timestamp:
11/24/05 20:19:33 (12 years ago)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracModPython

    v1 v2  
    22 
    33Trac 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. 
    4  
    5 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]) 
    64 
    75== Simple configuration == 
    1614<Location /projects/myproject> 
    1715   SetHandler mod_python 
    18    PythonHandler trac.ModPythonHandler 
     16   PythonHandler trac.web.modpython_frontend  
    1917   PythonOption TracEnv /var/trac/myproject 
    2018   PythonOption TracUriRoot /projects/myproject 
    4341}}} 
    4442 
     43 
    4544== Setting up multiple projects == 
    4645 
    4948<Location /projects> 
    5049  SetHandler mod_python 
    51   PythonHandler trac.ModPythonHandler 
     50  PythonHandler trac.web.modpython_frontend  
    5251  PythonOption TracEnvParentDir /var/trac 
    5352  PythonOption TracUriRoot /projects 
    7473}}} 
    7574 
     75== Virtual Host Configuration == 
     76 
     77Below is the sample configuration required to set up your trac as a virtual server (i.e. when you access it at the URLs like 
     78!http://trac.mycompany.com): 
     79 
     80{{{ 
     81<VirtualHost * > 
     82    DocumentRoot /var/trac/myproject 
     83    ServerName trac.mycompany.com 
     84    <Directory /> 
     85        SetHandler mod_python 
     86        PythonHandler trac.web.modpython_frontend 
     87        PythonOption TracEnv /var/trac/myproject 
     88        PythonOption TracUriRoot / 
     89    </Directory> 
     90    <Location /login> 
     91        AuthType Basic 
     92        AuthName "MyCompany Trac Server" 
     93        AuthUserFile /var/trac/myproject/.htusers 
     94        Require valid-user 
     95    </Location> 
     96</VirtualHost> 
     97}}} 
     98 
    7699== Troubleshooting == 
    77100 
    88111=== Win32 Issues === 
    89112 
    90 If you run trac with mod_python on Windows, attachments will not work. 
     113If you run trac with mod_python (3.1.3 or 3.1.4) on Windows,  
     114uploading attachments will '''not''' work. 
     115This is a known problem which we can't solve cleanly at the Trac level. 
    91116 
    92 There is a (simple) workaround for this which is to apply the patch attached to  
    93 ticket [http://projects.edgewall.com/trac/ticket/554 #554]. 
     117However, there is a workaround for this at the mod_python level,  
     118which is to apply the following patch [http://projects.edgewall.com/trac/attachment/ticket/554/util_py.patch attachment:ticket:554:util_py.patch]  
     119to the (Lib/site-packages)/modpython/util.py file. 
     120 
     121If 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''  
     122present in 3.1.4). 
    94123 
    95124=== OS X issues ===