| @@ -0,0 +1,54 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+ <head>
+ <title>Trac for SUSE README</title>
+ </head>
+ <body>
+ <h1>Trac on SUSE</h1>
+ <h2>Prequisites</h2>
+ <p>
+ For Trac you need a <a href='http://subversion.tigris.org'>subversion</a> installation and
+ <a href='http://www.sqlite.org'>sqlite</a> or <a href='http://www.postgresql.org'>postgres</a> as a database. For web access the apache web server can be used.
+ </p>
+ <h2>Create Subversion Repositries</h2>
+ <p>
+ First you need to create one or more subversion repositories. The default location on SUSE Linux is <code>/srv/svn/repos</code>. To create a repository named MyProject you must run:
+ </p>
+ <p>
+ <code>snvadmin create /srv/svn/repos/MyProject</code>
+ </p>
+ <p>
+ To make the repositry accessible via the netowrk you must either run the <code>svnserve</code> daemon or enter a corresponding section in <code>/etc/apache2/conf.d/subversion.conf</code> and run the apache2 daemon (see <code>/usr/share/doc/packages/subversion/README.SuSE</code> for details).
+ </p>
+ <h2>Create Trac Project Sites</h2>
+ <p>
+ Now you may create a corresponding for each subversion project the default directory
+ for Trac projects is <code>/srv/trac/</code>. To create a new Trac project you must run
+ </p>
+ <p>
+ <code>trac-admin /srv/trac/MyProject initenv</code>
+ </p>
+ <p>
+ Now you are asked for the project name, the database, the subversion repository path and a template path. For the database and the template directory the defaults are usually sufficient.
+ </p>
+ <p>
+ The command above will create the <code>/srv/trac/MyProject</code> directory and fill it with content. Note that it must be readable and writable by the user the <code>trac</code> daemon will be running as (see below). With the default options (running as <code>wwwrun</code>), you must also do the following after the <code>trac-admin</code> command above:
+ </p>
+ <p>
+ <code>chown -R wwwrun /srv/trac/MyProject</code>
+ </p>
+ <h2>Activate the Web Site</h2>
+ <h3>Activate the Trac Daemon</h3>
+ <p>
+ The Trac daemon can be started with <code>rctracd start</code>. To activate it permanently you must run <code>chkconfig --add tracd</code>. The default port for the Trac daemon is 8080. This and the trac directory can be changed in <code>/etc/sysconfig/tracd</code>. To use ports below 1000 the <code>TRAC_UID</code> must be changed to root.
+ </p>
+ <h3>Activate Trac via Apache+CGI</h3>
+ <p>
+ To use Trac using Apache and CGI it is neccessary to add the <code>env</code> module to the <code>APACHE_MODULES</code> variable in <code>/etc/sysconfig/apache2</code>. Then you must activate CGI access to trac by adding <code>TRAC_CGI</code> to <code>APACHE_SERVER_FLAGS</code>.
+ </p>
+ <h3>Activate Trac via Apache+MOD_PYTHON</h3>
+ <p>Access to Trac via mod_python is configured in a similar way. You must add <code>python</code> to
+ <code>APACHE_MODULES</code> and <code>TRAC_MODPYTHON</code> to <code>APACHE_SERVER_FLAGS</code>.
+ </p>
+</body>
+</html>
|
