Changes between Version 5 and Version 6 of TracFastCgi

Timestamp:

Feb 24, 2024, 4:07:16 PM (22 months ago)

Author:

trac

Comment:

--

TracFastCgi

@@ -4 +4 @@
 [[PageOutline(2-5, Contents, floated)]]
 
-[http://www.fastcgi.com/ FastCGI] interface allows Trac to remain resident much like with [wiki:TracModPython mod_python] or [wiki:TracModWSGI mod_wsgi]. It is faster than external CGI interfaces which must start a new process for each request. Additionally, it is supported by a much wider variety of web servers.
-
-Note that unlike mod_python, FastCGI supports [http://httpd.apache.org/docs/suexec.html Apache SuEXEC], ie run with different permissions than the web server runs with. `mod_wsgi` supports the `WSGIDaemonProcess` with user / group parameters to achieve the same effect.
+[https://fastcgi-archives.github.io FastCGI] interface allows Trac to remain resident much like with [wiki:TracModPython mod_python] or [wiki:TracModWSGI mod_wsgi]. It is faster than external CGI interfaces which must start a new process for each request. Additionally, it is supported by a much wider variety of web servers.
+
+Note that unlike mod_python, FastCGI supports [https://httpd.apache.org/docs/suexec.html Apache SuEXEC], ie run with different permissions than the web server runs with. `mod_wsgi` supports the `WSGIDaemonProcess` with user / group parameters to achieve the same effect.
 
 '''Note for Windows:''' Trac's FastCGI does not run under Windows, as Windows does not implement `Socket.fromfd`, which is used by `_fcgi.py`. If you want to connect to IIS, you may want to try [trac:TracOnWindowsIisAjp AJP]/[trac:TracOnWindowsIisAjp ISAPI].
@@ -27 +27 @@
 <IfModule mod_fastcgi.c>
    AddHandler fastcgi-script .fcgi
-   FastCgiIpcDir /var/lib/apache2/fastcgi 
+   FastCgiIpcDir /var/lib/apache2/fastcgi
 </IfModule>
 LoadModule fastcgi_module /usr/lib/apache2/modules/mod_fastcgi.so
@@ -46 +46 @@
 }}}
 
+You can also specify the `PYTHON_EGG_CACHE` environment variable using a second `-initial-env` directive:
+{{{#!apache
+FastCgiConfig -initial-env TRAC_ENV=/var/lib/trac \
+    -initial-env PYTHON_EGG_CACHE=/var/lib/trac/plugin-cache
+}}}
+
 === Set up with `mod_fcgid`
 
@@ -62 +68 @@
 === Alternative environment setup
 
-A better method to specify the path to the Trac environment is to embed the path into `trac.fcgi` script itself. That doesn't require configuration of the server environment variables, works for both [trac:FastCgi] modules as well as for [http://www.lighttpd.net/ lighttpd] and CGI:
+A better method to specify the path to the Trac environment is to embed the path into `trac.fcgi` script itself. That doesn't require configuration of the server environment variables, works for both [trac:FastCgi] modules as well as for [https://www.lighttpd.net/ lighttpd] and CGI:
 {{{#!python
 import os
@@ -100 +106 @@
 The second rule will be there to serve the few static files needed to correctly display the Trac interface. Create it as ''Directory rule'' for ''/common'' and just set it to the ''Static files'' handler and with a ''Document root'' that points to the appropriate files: ''$TRAC_LOCAL/htdocs/'' (where $TRAC_LOCAL is a directory defined by the user or the system administrator to place local Trac resources).
 
-'''Note:''' If the tracd process fails to start up, and Cherokee displays a 503 error page, you might be missing the [http://trac.saddi.com/flup python-flup] package ([trac:#9903]). Python-flup is a dependency which provides Trac with SCGI capability. You can install it on Debian based systems with:
+'''Note:''' If the tracd process fails to start up, and Cherokee displays a 503 error page, you might be missing the [https://www.saddi.com/software/flup/ python-flup] package ([trac:#9903]). Python-flup is a dependency which provides Trac with SCGI capability. You can install it on Debian based systems with:
 {{{#!sh
 sudo apt-get install python-flup
@@ -107 +113 @@
 == Lighttpd Configuration
 
-The FastCGI front-end was developed primarily for use with alternative webservers, such as [http://www.lighttpd.net/ Lighttpd].
+The FastCGI front-end was developed primarily for use with alternative webservers, such as [https://www.lighttpd.net/ Lighttpd].
 
 Lighttpd is a secure, fast, compliant and very flexible web-server that has been optimized for high-performance environments. It has a very low memory footprint compared to other web servers and takes care of CPU load.
@@ -116 +122 @@
 var.fcgi_binary="/path/to/cgi-bin/trac.fcgi" # 0.10 name of prior fcgi executable
 fastcgi.server = ("/trac" =>
-   
+
                    ("trac" =>
                      ("socket" => "/tmp/trac-fastcgi.sock",
@@ -174 +180 @@
 # Separated password files for each project
 # See "Conditional Configuration" in
-# http://trac.lighttpd.net/trac/file/branches/lighttpd-merge-1.4.x/doc/configuration.txt
+# https://redmine.lighttpd.net/projects/lighttpd/repository/entry/doc/configuration.txt?rev=lighttpd-1.4.28
 
 $HTTP["url"] =~ "^/first/" {
@@ -184 +190 @@
 
 # Enable auth on trac URLs, see
-# http://trac.lighttpd.net/trac/file/branches/lighttpd-merge-1.4.x/doc/authentication.txt
+# https://redmine.lighttpd.net/projects/lighttpd/repository/entry/doc/authentication.txt?rev=lighttpd-1.4.28
 
 auth.require = ("/first/login" =>
@@ -286 +292 @@
 == !LiteSpeed Configuration
 
-The FastCGI front-end was developed primarily for use with alternative webservers, such as [http://www.litespeedtech.com/ LiteSpeed].
+The FastCGI front-end was developed primarily for use with alternative webservers, such as [https://www.litespeedtech.com/ LiteSpeed].
 
 !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.
@@ -326 +332 @@
  1. Modify `/fullpathto/mytracproject/conf/trac.ini`:
  {{{
-#find/set base_rul, url, and link variables
+#find/set base_url, url, and link variables
 base_url = http://yourdomain.com/trac/ <--- base url to generate correct links to
 url = http://yourdomain.com/trac/      <--- link of project
@@ -335 +341 @@
 == Nginx Configuration
 
-[http://nginx.org/en/ Nginx] is able to communicate with FastCGI processes, but can not spawn them. So you need to start FastCGI server for Trac separately.
+[https://nginx.org/en/ Nginx] is able to communicate with FastCGI processes, but can not spawn them. So you need to start FastCGI server for Trac separately.
 
  1. Nginx configuration with basic authentication handled by Nginx - confirmed to work on 0.6.32
@@ -411 +417 @@
      import trac.web._fcgi
 
-     fcgiserv = trac.web._fcgi.WSGIServer(dispatch_request, 
+     fcgiserv = trac.web._fcgi.WSGIServer(dispatch_request,
           bindAddress = sockaddr, umask = 7)
      fcgiserv.run()
@@ -432 +438 @@
 
 }}}
- 1. Reload nginx and launch trac.fcgi: 
+ 1. Reload nginx and launch trac.fcgi:
  {{{#!sh
-trac@trac.example ~ $ ./trac-standalone-fcgi.py 
+trac@trac.example ~ $ ./trac-standalone-fcgi.py
 }}}
 
@@ -445 +451 @@
   * and patch from [trac:#7239] is applied, or you'll have to fix the socket file permissions every time
 
-Unfortunately Nginx does not support variable expansion in fastcgi_pass directive. 
-Thus it is not possible to serve multiple Trac instances from one server block. 
-
-If you worry enough about security, run Trac instances under separate users. 
+Unfortunately Nginx does not support variable expansion in fastcgi_pass directive.
+Thus it is not possible to serve multiple Trac instances from one server block.
+
+If you worry enough about security, run Trac instances under separate users.
 
 Another way to run Trac as a FCGI external application is offered in [trac:#6224].