Changes between Version 2 and Version 3 of TracFastCgi


Ignore:
Timestamp:
2006-10-08T09:36:47+02:00 (9 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracFastCgi

    v2 v3  
    2222LoadModule fastcgi_module /usr/lib/apache2/modules/mod_fastcgi.so
    2323}}}
    24 Setting `FastCgiIpcDir` is optional if the default is suitable.
     24Setting `FastCgiIpcDir` is optional if the default is suitable. Note that the `LoadModule` line must be after the `IfModule` group.
    2525
    2626Configure `ScriptAlias` or similar options as described in TracCgi, but
     
    173173# /trac/chrome/common, and use FastCGI for those
    174174$HTTP["url"] =~ "^/trac(?!/chrome/common)" {
    175 # If you have previous fastcgi.server declarations for applications other than Trac, use += here
    176 # instead of = so you won't overwrite them
     175# Even if you have other fastcgi.server declarations for applications other than Trac, do NOT use += here
    177176fastcgi.server = ("/trac" =>
    178177                   ("trac" =>
     
    244243  If nothing else helps and trac.fcgi doesn't start with lighttpd settings __server.username = "www-data"__, __server.groupname = "www-data"__, then in the `bin-environment` section set `PYTHON_EGG_CACHE` to the home directory of `www-data` or some other directory accessible to this account for writing.
    245244
     245
     246== Simple LiteSpeed Configuration ==
     247
     248The FastCGI front-end was developed primarily for use with alternative webservers, such as [http://www.litespeedtech.com/ LiteSpeed].
     249
     250LiteSpeed web server is an event-driven asynchronous Apache replacement designed from the ground-up to be secure, scalable, and operate with minimal resources. LiteSpeed can operate directly from an Apache config file and is targeted for business-critical environments.
     251
     252Setup
     253
     2541) Please make sure you have first have a working install of a Trac project. Test install with “tracd” first.
     255
     2562) Create a Virtual Host for this setup. From now on we will refer to this vhost as TracVhost. For this tutorial we will be assuming that your trac project will be accessible via:
     257
     258{{{
     259http://yourdomain.com/trac/
     260}}}
     261
     2623) Go “TracVhost → External Apps” tab and create a new “External Application”.
     263
     264{{{
     265Name: MyTracFCGI       
     266Address: uds://tmp/lshttpd/mytracfcgi.sock
     267Max Connections: 10
     268Environment: TRAC_ENV=/fullpathto/mytracproject/ <--- path to root folder of trac project
     269Initial Request Timeout (secs): 30
     270Retry Timeout (secs): 0
     271Persistent Connection   Yes
     272Connection Keepalive Timeout: 30
     273Response Bufferring: No
     274Auto Start: Yes
     275Command: /usr/share/trac/cgi-bin/trac.fcgi  <--- path to trac.fcgi
     276Back Log: 50
     277Instances: 10
     278}}}
     279
     2804) Optional. If you need to use htpasswd based authentication. Go to “TracVhost → Security” tab and create a new security “Realm”.
     281
     282{{{
     283DB Type: Password File
     284Realm Name: MyTracUserDB               <--- any name you wish and referenced later
     285User DB Location: /fullpathto/htpasswd <--- path to your htpasswd file
     286}}}
     287
     288If you don’t have a htpasswd file or don’t know how to create the entries within one, go to http://sherylcanter.com/encrypt.php, to generate the user:password combos.
     289
     2905) Go to “PythonVhost → Contexts” and create a new “FCGI Context”.
     291
     292{{{
     293URI: /trac/                              <--- URI path to bind to python fcgi app we created   
     294Fast CGI App: [VHost Level] MyTractFCGI  <--- select the trac fcgi extapp we just created
     295Realm: TracUserDB                        <--- only if (4) is set. select ream created in (4)
     296}}}
     297
     2986) Modify /fullpathto/mytracproject/conf/trac.ini
     299
     300{{{
     301#find/set base_rul, url, and link variables
     302base_url = http://yourdomain.com/trac/ <--- base url to generate correct links to
     303url = http://yourdomain.com/trac/      <--- link of project
     304link = http://yourdomain.com/trac/     <--- link of graphic logo
     305}}}
     306
     3077) Restart LiteSpeed, “lswsctrl restart”, and access your new Trac project at:
     308
     309{{{
     310http://yourdomain.com/trac/
     311}}}
     312
    246313----
    247314See also TracCgi, TracModPython, TracInstall, TracGuide