Allgemeines

Da Trac auch auf [http://subversion.tigris.org Subversion]-Repositories zugreifen kann, ist es sinnvoll, die Trac-Projekte auf dem FaxeSubVersion-User-Mode-Server zu installieren:

screen -r svn

Alle Trac-Projekte liegen unterhalb von /data/trac/.

Installation

{{{apt-get install trac }}}

Die Einrichtung mehrerer Projekte auf demselben Server lässt sich auf verschiedenen Wegen erreichen. Diese sind in der [http://projects.edgewall.com/trac/wiki/TracMultipleProjects Trac-Doku] beschrieben.

Details zu unserer gewählten Methode findest du in der auf einer anderen Seite der [http://projects.edgewall.com/trac/wiki/TracModPython Doku].

Das mod-python-Modul installieren:

apt-get install libapache2-mod-python
a2enmod mod_python

Nun gehört in die /etc/apache2/conf.d/trac.conf nur noch folgendes:

<Location /trac>
  SetHandler mod_python
  PythonHandler trac.ModPythonHandler
  PythonOption TracUriRoot /trac
  PythonOption TracEnvParentDir "/data/trac"
</Location>

Die vollständige [attachment:trac.conf /etc/apache2/conf.d/trac.conf] enthält zusätzlich lediglich die Einstellungen zur Authentifizierung der Nutzer.

Die Trac-Admin-Konsole Einrichten

Dieses [https://systemausfall.org/trac/sao/ticket/9 Ticket] beschreibt den Problemverlauf. Folgende Schritte sind notwendig:

Die Datei /etc/apach2/conf.d/trac.conf bearbeiten:

ScriptAlias     /tracadmin      /data/scripts/tracadmin-console.sh

<Location /tracadmin>
        AuthName                systemausfall.org
        AuthType                Basic
        AuthLDAPUrl ldap://ldap.sao/o=neofaxe,dc=systemausfall,dc=org?cn?sub?(objectClass=webAccount)
        AuthLDAPGroupAttribute  adminOfService
        AuthLDAPGroupAttributeIsDN      On
        require         group cn=trac-sao,sc=trac,ou=Services,o=neofaxe,dc=systemausfall,dc=org
</Location>

Achtung: Die Trac-Admin-Konsole funktioniert nur, wenn das Trac-Projekt den selben Namen wie das Zugrunde liegende svn-Repository hat. Dies ist eine Beschraenkung des Scriptes.

Um einen Link zur Konsole einzurichten, sollte folgendes in templates/site_header.cs eines Trac-Projekts stehen:

<div style="position:absolute; top:10x; right:10px">
<a href="/tracadmin" title="die selbstgemachte Konsolen-Oberfl&auml;che">TracAdmin-Konsole</a>
</div>

Verwaltung

Neues Projekt anlegen

Bisher läuft es nur manuell, dafür ist es aber schön trivial:

trac-admin /data/trac/NAME initenv

Folgende Anpassung von /data/trac/NAME/conf/trac.ini muessen vorgenommen werden:

[trac]
htdocs_location = /trac-shared/

[notification]
smtp_enabled = true
smtp_replyto = trac[at]admin.systemausfall.org
smtp_always_cc = trac-NAME[at]lists.systemausfall.org
smtp_server = mail.sao
smtp_from = trac-NAME[at]lists.systemausfall.org
always_notify_reporter = false

Jedes Auftreten von [at] ist natürlich durch ein @-Zeichen zu ersetzen (zum Schutz vor Mailadressen-Bots).

Ein Template gibt es derzeit noch nicht.

Hinweis: Die Möglichkeit, eine Trac-Instanz ohne subversion Repository zu installieren, gibts noch nicht. Mensch muss also, wenn es kein Repository gibt, irgendwo eines mit svnadmin create /data/repos/dummy erstellen.

Nach Änderungen der Konfigurationsdatei musst du wegen mod_python den apache neustarten:

apache2ctl restart