Logoj0ke.net Open Build Service > Projects > devel:python > trac12 > README.SUSE.html
Sign Up | Log In

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