Changes between Version 1 and Version 2 of TracModPython


Ignore:
Timestamp:
Jan 30, 2006, 11:09:16 PM (17 years ago)
Author:
trac
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 ===