Changes between Initial Version and Version 1 of TracLitespeed

Timestamp:

Feb 12, 2006, 8:36:10 AM (18 years ago)

Author:

ucosty@…

Comment:

—

TracLitespeed

@@ +1 @@
+= Basic Multiproject under Litespeed =
+
+This document specifies how to modify an existing Trac setup to work with [http://litespeedtech.com/ Litespeed]. It assumes you have a working Trac install which can serve single Trac projects using the tracd server.
+
+This document assumes some default paths, such as
+ * /usr/share/trac/
+ * /usr/lib/python-[ver]/site-packages/trac/
+for the basic Trac installation.
+
+This document _also_ assumes you wish to setup Trac to use a dedicated subdomain. It should be trivial, however, to change this behaviour.
+
+== Allowing project-based URL's in Trac ==
+
+Edit the Trac main.py file. On Linux this file can be found in /usr/lib/python-[ver]/site-packages/trac/web/main.py where [ver] is replaced with your python version (such as 2.4).
+
+Replace the line
+{{{
+env.href = Href(req.cgi_location)
+}}}
+with
+{{{
+env.href = Href(req.base_url)
+}}}
+save and exit
+
+This modification allows Trac to generate URL's based on the __project path__ rather than the cgi path.
+
+You will also need to add the following line to each of your project's trac.ini files manually.
+
+Under [trac] add
+{{{
+base_url = /projects/[projectname]
+}}}
+
+The following example will make the 'test' project accessable at http://yourdomain.tld/projects/test
+{{{
+base_url = /projects/test
+}}}
+
+== Creating Litespeed Config ==
+
+Using the Litespeed configuration panel
+
+ * Create a Trac virtual host 
+   * Enable scripting and Symlink Following support
+ * Enable URL rewrite support
+ * Insert the following rewrite rules
+{{{
+RewriteRule ^/projects/([[:alnum:]]+)(/?.*)     /trac.cgi$2 [S=1,E=TRAC_ENV:/trac/$1,E=TRAC_URI_ROOT:/projects/$1]
+RewriteRule ^/projects/(.*)                     /index.html
+}}}
+ * Add a Static context with the following
+   * URI: /trac.cgi/chrome/common
+   * Location: /usr/share/trac/htdocs
+   * Accessible: Yes
+   * Enable Expires: No
+
+ * Create a CGI context with the following
+   * URI: /
+   * Path: /usr/share/trac/cgi-bin/
+
+ * Save and reload Litespeed
+
+This will make project accessable through the address
+{{{
+http://subdomain.domain.tld/projects/[projectname]
+}}}