Changes between Version 279 and Version 280 of TracInstall

Timestamp:

May 29, 2009, 4:17:46 PM (15 years ago)

Author:

trac@…

Comment:

Added trac-admin deploy info

TracInstall

@@ -147 +147 @@
   chown -R apache.apache /path/to/myproject
 
-'''Warning: If the trac.cgi files are not installed where you expect, then the current documentation is insufficient; it might be necessary to use the 'deploy' command in trac-admin.  See tickets http://trac.edgewall.org/ticket/7312 and possibly http://trac.edgewall.org/ticket/6827'''
-
 == Running the Standalone Server ==
 
@@ -161 +159 @@
 }}}
 
-
 == Running Trac on a Web Server ==
 
@@ -169 +166 @@
 
 Trac also supports [trac:TracOnWindowsIisAjp AJP] which may be your choice if you want to connect to IIS.
+
+==== Generating the Trac cgi-bin directory ====
+
+In order for Trac to function properly with FastCGI or mod_python, you need to have a trac.cgi file. This is an executable which loads the appropriate Python code. It can be generated using the `deploy` option of [wiki:TracAdmin trac-admin].
+
+There is, however, a bit of a chicken-and-egg problem. The [wiki:TracAdmin trac-admin] command requires an existing environment to function, but complains if the deploy directory already exists. This is a problem, because environments are often stored in a subdirectory of the deploy. The solution is to do something like this:
+{{{
+mkdir -p /usr/share/trac/projects/my-project
+trac-admin /usr/share/trac/projects/my-project initenv
+trac-admin /usr/share/trac/projects/my-project deploy /tmp/deploy
+mv /tmp/deploy/* /usr/share/trac
+}}}
 
 ==== Setting up the Plugin Cache ====
@@ -228 +237 @@
 ----
 See also: [trac:TracInstallPlatforms TracInstallPlatforms], TracGuide, TracCgi, TracFastCgi, TracModPython, [wiki:TracModWSGI], TracUpgrade, TracPermissions
+