File README.SUSE.html of Package trac12
x
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2
<html>
3
<head>
4
<title>Trac for SUSE README</title>
5
</head>
6
<body>
7
<h1>Trac on SUSE</h1>
8
<h2>Prequisites</h2>
9
<p>
10
For Trac you need a <a href='http://subversion.tigris.org'>subversion</a> installation and
11
<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.
12
</p>
13
<h2>Create Subversion Repositries</h2>
14
<p>
15
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:
16
</p>
17
<p>
18
<code>snvadmin create /srv/svn/repos/MyProject</code>
19
</p>
20
<p>
21
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).
22
</p>
23
<h2>Create Trac Project Sites</h2>
24
<p>
25
Now you may create a corresponding for each subversion project the default directory
26
for Trac projects is <code>/srv/trac/</code>. To create a new Trac project you must run
27
</p>
28
<p>
29
<code>trac-admin /srv/trac/MyProject initenv</code>
30
</p>
31
<p>
32
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.
33
</p>
34
<p>
35
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:
36
</p>
37
<p>
38
<code>chown -R wwwrun /srv/trac/MyProject</code>
39
</p>
40
<h2>Activate the Web Site</h2>
41
<h3>Activate the Trac Daemon</h3>
42
<p>
43
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.
44
</p>
45
<h3>Activate Trac via Apache+CGI</h3>
46
<p>
47
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>.
48
</p>
49
<h3>Activate Trac via Apache+MOD_PYTHON</h3>
50
<p>Access to Trac via mod_python is configured in a similar way. You must add <code>python</code> to
51
<code>APACHE_MODULES</code> and <code>TRAC_MODPYTHON</code> to <code>APACHE_SERVER_FLAGS</code>.
52
</p>
53
</body>
54
</html>
55