Changes between Version 2 and Version 3 of TracModPython


Ignore:
Timestamp:
Nov 26, 2022, 2:16:52 PM (2 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TracModPython

    v2 v3  
    66Trac supports [http://www.modpython.org/ mod_python], which speeds up Trac's response times considerably, especially compared to [TracCgi CGI], and permits use of many Apache features not possible with [wiki:TracStandalone tracd]/mod_proxy.
    77
    8 These instructions are for Apache 2. If you are using Apache 1.3, you may have some luck with [trac:wiki:TracModPython2.7 TracModPython2.7], but that is a deprecated setup.
    9 
    108[[PageOutline(2-3,Overview,inline)]]
    119
    12 == Simple configuration: single project == #Simpleconfiguration
     10== Simple configuration: single project #Simpleconfiguration
    1311
    1412If you just installed mod_python, you may have to add a line to load the module in the Apache configuration:
    … …  
    3735{{{#!apache
    3836<Location /mpinfo>
    39    SetHandler mod_python
    40    PythonInterpreter main_interpreter
    41    PythonHandler mod_python.testhandler
    42    Order allow,deny
    43    Allow from all
     37  SetHandler mod_python
     38  PythonInterpreter main_interpreter
     39  PythonHandler mod_python.testhandler
     40  # For Apache 2.2
     41  <IfModule !mod_authz_core.c>
     42    Order allow,deny
     43    Allow from all
     44  </IfModule>
     45  # For Apache 2.4
     46  <IfModule mod_authz_core.c>
     47    Require all granted
     48  </IfModule>
    4449</Location>
    4550}}}
    … …  
    4853{{{#!apache
    4954<Location /projects/myproject>
    50    SetHandler mod_python
    51    PythonInterpreter main_interpreter
    52    PythonHandler trac.web.modpython_frontend
    53    PythonOption TracEnv /var/trac/myproject
    54    PythonOption TracUriRoot /projects/myproject
    55    Order allow,deny
    56    Allow from all
     55  SetHandler mod_python
     56  PythonInterpreter main_interpreter
     57  PythonHandler trac.web.modpython_frontend
     58  PythonOption TracEnv /var/trac/myproject
     59  PythonOption TracUriRoot /projects/myproject
     60  # For Apache 2.2
     61  <IfModule !mod_authz_core.c>
     62    Order allow,deny
     63    Allow from all
     64  </IfModule>
     65  # For Apache 2.4
     66  <IfModule mod_authz_core.c>
     67    Require all granted
     68  </IfModule>
    5769</Location>
    5870}}}
    … …  
    7789PythonOption TracLocale en_GB.UTF8
    7890
    79 # See description above       
     91# See description above
    8092PythonOption TracUriRoot /projects/myproject
    8193}}}
    … …  
    98110=== Setting the Python Egg Cache
    99111
    100 If the Egg Cache isn't writeable by your Web server, you'll either have to change the permissions, or point Python to a location where Apache can write. This can manifest itself as a `500 internal server error` and/or a complaint in the syslog. 
     112If the Egg Cache isn't writeable by your Web server, you'll either have to change the permissions, or point Python to a location where Apache can write. This can manifest itself as a `500 internal server error` and/or a complaint in the syslog.
    101113
    102114{{{#!apache
    103115<Location /projects/myproject>
    104116  ...
    105   PythonOption PYTHON_EGG_CACHE /tmp 
     117  PythonOption PYTHON_EGG_CACHE /tmp
    106118  ...
    107119</Location>
    … …  
    128140  SetHandler mod_python
    129141  PythonInterpreter main_interpreter
    130   PythonHandler trac.web.modpython_frontend 
     142  PythonHandler trac.web.modpython_frontend
    131143  PythonOption TracEnvParentDir /var/trac
    132144  PythonOption TracUriRoot /projects
    … …  
    135147
    136148When you request the `/projects` URL, you will get a listing of all subdirectories of the directory you set as `TracEnvParentDir` that look like Trac environment directories. Selecting any project in the list will bring you to the corresponding Trac environment.
     149
     150Directories residing in `TracEnvParentDir` that are not environment directories will display an error message on the [TracInterfaceCustomization#ProjectList project index page]. The directories can be excluded by listing them in a `.tracignore` file residing in `TracEnvParentDir`. Unix [https://docs.python.org/2/library/fnmatch.html shell-style wildcard patterns] can be used in the newline separated list of directories.
    137151
    138152If you don't want to have the subdirectory listing as your projects home page you can use a
    … …  
    220234
    221235   #remove these if you don't want to force SSL
    222    RewriteEngine On 
     236   RewriteEngine On
    223237   RewriteCond %{HTTPS} off
    224238   RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI}
    … …  
    265279SetHandler mod_python
    266280PythonInterpreter main_interpreter
    267 PythonHandler trac.web.modpython_frontend 
     281PythonHandler trac.web.modpython_frontend
    268282PythonOption TracEnv /system/path/to/this/directory
    269283PythonOption TracUriRoot /path/on/apache
    … …  
    304318}}}
    305319
    306 See also [http://subversion.apache.org/faq.html#reposperms How do I set repository permissions correctly?]
     320See also [https://subversion.apache.org/faq.html#reposperms How do I set repository permissions correctly?]
    307321
    308322==== FreeBSD issues
    … …  
    347361
    348362'''Note''': For the above configuration to have any effect it must be put after the configuration of your project root location, ie {{{<Location /myproject />}}}.
    349 
    350 Also, setting `PythonOptimize On` seems to mess up the page headers and footers, in addition to hiding the documentation for macros and plugins (see #Trac8956). Considering how little effect the option has, leave it `Off`.
    351363
    352364=== HTTPS issues
    … …  
    364376=== Segmentation fault with php5-mhash or other php5 modules
    365377
    366 You may encounter segfaults (reported on Debian etch) if php5-mhash module is installed. Try to remove it to see if this solves the problem. See [http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411487 Debian bug report].
    367 
    368 Some people also have troubles when using PHP5 compiled with its own third party libraries instead of system libraries. Check [http://www.djangoproject.com/documentation/modpython/#if-you-get-a-segmentation-fault Django segmentation fault].
     378You may encounter segfaults (reported on Debian etch) if php5-mhash module is installed. Try to remove it to see if this solves the problem. See [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411487 Debian bug report].
     379
     380Some people also have troubles when using PHP5 compiled with its own third party libraries instead of system libraries. Check [https://www.djangoproject.com/documentation/modpython/#if-you-get-a-segmentation-fault Django segmentation fault].
    369381
    370382----