Version 3 (modified by 9 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 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