Edgewall Software

Changes between Version 35 and Version 36 of TracFastCgi


Ignore:
Timestamp:
Sep 13, 2006, 8:27:21 AM (18 years ago)
Author:
Matthew Good
Comment:

I think lighttpd is a more common platform than LiteSpeed, so let's keep it first

Legend:

Unmodified
Added
Removed
Modified
  • TracFastCgi

    v35 v36  
    6161`.fcgi` scripts with different `ScriptAliases`, copying and appropriately
    6262renaming `trac.fcgi` and adding the above code to create each such script.
    63 
    64 == Simple LiteSpeed Configuration ==
    65 
    66 The FastCGI front-end was developed primarily for use with alternative webservers, such as [http://www.litespeedtech.com/ LiteSpeed].
    67 
    68 LiteSpeed 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.
    69 
    70 Setup
    71 
    72 1) Please make sure you have first have a working install of a Trac project. Test install with “tracd” first.
    73 
    74 2) 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:
    75 
    76 {{{
    77 http://yourdomain.com/trac/
    78 }}}
    79 
    80 3) Go “TracVhost → External Apps” tab and create a new “External Application”.
    81 
    82 {{{
    83 Name: MyTracFCGI       
    84 Address: uds://tmp/lshttpd/mytracfcgi.sock
    85 Max Connections: 10
    86 Environment: TRAC_ENV=/fullpathto/mytracproject/ <--- path to root folder of trac project
    87 Initial Request Timeout (secs): 30
    88 Retry Timeout (secs): 0
    89 Persistent Connection   Yes
    90 Connection Keepalive Timeout: 30
    91 Response Bufferring: No
    92 Auto Start: Yes
    93 Command: /usr/share/trac/cgi-bin/trac.fcgi  <--- path to trac.fcgi
    94 Back Log: 50
    95 Instances: 10
    96 }}}
    97 
    98 4) Optional. If you need to use htpasswd based authentication. Go to “TracVhost → Security” tab and create a new security “Realm”.
    99 
    100 {{{
    101 DB Type: Password File
    102 Realm Name: MyTracUserDB               <--- any name you wish and referenced later
    103 User DB Location: /fullpathto/htpasswd <--- path to your htpasswd file
    104 }}}
    105 
    106 If 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.
    107 
    108 5) Go to “PythonVhost → Contexts” and create a new “FCGI Context”.
    109 
    110 {{{
    111 URI: /trac/                              <--- URI path to bind to python fcgi app we created   
    112 Fast CGI App: [VHost Level] MyTractFCGI  <--- select the trac fcgi extapp we just created
    113 Realm: TracUserDB                        <--- only if (4) is set. select ream created in (4)
    114 }}}
    115 
    116 6) Modify /fullpathto/mytracproject/conf/trac.ini
    117 
    118 {{{
    119 #find/set base_rul, url, and link variables
    120 base_url = http://yourdomain.com/trac/ <--- base url to generate correct links to
    121 url = http://yourdomain.com/trac/      <--- link of project
    122 link = http://yourdomain.com/trac/     <--- link of graphic logo
    123 }}}
    124 
    125 7) Restart LiteSpeed, “lswsctrl restart”, and access your new Trac project at:
    126 
    127 {{{
    128 http://yourdomain.com/trac/
    129 }}}
    130 
    13163
    13264== Simple Lighttpd Configuration ==
     
    311243  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.
    312244
     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
    313313----
    314314See also TracCgi, TracModPython, TracInstall, TracGuide