File README.SUSE.html of Package trac
<!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 data base. 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 repositries. The default location on SUSE Linux is <code>/srv/svn/repos</code>. To create a repositry 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.
</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/traci/projects</code>. To create a new Trac project you must run
</p>
<p>
<code>trac-admin /srv/trac/projects/MyProject initenv</code>
</p>
<p>
Now you are asked for the project name, the database, teh subversion repositry path und a template path. For the database and the template directory the defaults are usually sufficient.
</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>insserv tracd</code>. The default port for the Trac daemon is 8080. This and the trac directory can be changed in <code>/etc/subversion/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>
