Version 3 (modified by 12 years ago) (diff) | ,
---|
Installing Trac as CGI
Please note that using Trac via CGI is the slowest deployment method available. It is slower than mod_python, FastCGI and even IIS/AJP on Windows.
CGI script is the entrypoint that web-server calls when a web-request to an application is made. To generate the trac.cgi
script run:
trac-admin /path/to/env deploy /path/to/www/trac
trac.cgi
will be in the cgi-bin
folder inside the given path. Make sure it is executable by your web server. This command also copies static resource
files to a htdocs
directory of a given destination.
Apache web-server configuration
In Apache there are two ways to run Trac as CGI:
- Use a
ScriptAlias
directive that maps an URL to thetrac.cgi
script (recommended) - Copy the
trac.cgi
file into the directory for CGI executables used by your web server (commonly namedcgi-bin
). You can also create a symbolic link, but in that case make sure that theFollowSymLinks
option is enabled for thecgi-bin
directory.
To make Trac available at http://yourhost.example.org/trac
add ScriptAlias
directive to Apache configuration file, changing trac.cgi
path to match your installation:
ScriptAlias /trac /path/to/www/trac/cgi-bin/trac.cgi
Note that this directive requires enabled
mod_alias
module.
If you're using Trac with a single project you need to set its location using the TRAC_ENV
environment variable:
<Location "/trac"> SetEnv TRAC_ENV "/path/to/projectenv" </Location>
Or to use multiple projects you can specify their common parent directory using the TRAC_ENV_PARENT_DIR
variable:
<Location "/trac"> SetEnv TRAC_ENV_PARENT_DIR "/path/to/project/parent/dir" </Location>
Note that the
SetEnv
directive requires enabledmod_env
module. It is also possible to set TRAC_ENV in trac.cgi. Just add the following code between "try:" and "from trac.web ...":
import os os.environ['TRAC_ENV'] = "/path/to/projectenv"
Or for TRAC_ENV_PARENT_DIR:
import os os.environ['TRAC_ENV_PARENT_DIR'] = "/path/to/project/parent/dir"
If you are using the Apache suEXEC feature please see http://trac.edgewall.org/wiki/ApacheSuexec.
On some systems, you may need to edit the shebang line in the trac.cgi
file to point to your real Python installation path. On a Windows system you may need to configure Windows to know how to execute a .cgi file (Explorer -> Tools -> Folder Options -> File Types -> CGI).
Using WSGI
You can run a WSGI handler under CGI. You can write your own application function, or use the deployed trac.wsgi's application.
Mapping Static Resources
See TracInstall#MappingStaticResources.
Adding Authentication
See TracInstall#ConfiguringAuthentication.
See also: TracGuide, TracInstall, TracModWSGI, TracFastCgi, TracModPython