Diese Seite beschreibt die Anpassung von Trac an die Bedürfnisse von systemausfall.org.

Falls du mit Plugins oder sonstwelchen Tracteilen Probleme hast, hilft das trac interne Logging (entweder in /etc/trac/trac.ini oder über die webadmin Oberfläche aktivieren).

Webadmin

• siehe http://trac.edgewall.org/wiki/WebAdmin

• Installation

  • svn sourcen holen:

    svn co http://svn.edgewall.com/repos/trac/sandbox/webadmin/

  • installieren

    python setup.py install

  • die folgende Zeile muss in der systemweit gültigen /etc/trac/trac.ini eingetragen sein:

    webadmin.* = enabled

Delete-Ticket-Comment

• siehe http://trac-hacks.org/wiki/TicketDeletePlugin

• Installation:
  • auspacken

  • installieren

    python setup.py install

  • die folgende Zeile muss in der systemweit gültigen /etc/trac/trac.ini eingetragen sein:

    ticketdelete.* = enabled

Spam-Filter

• siehe http://trac.edgewall.org/wiki/SpamFilter

• installieren:

  easy_install TracSpamFilter

• zum Aktivieren folgende Zeile in die systemweit gültige /etc/trac/trac.ini in der Sektion components einfügen:

  tracspamfilter.* = enabled

• Damit der Spamfilter optimal funktioniert ist python-dnspython nötig. Leider erkennt trac nicht das per apt-get installeirte Paket, so dass es wie folgt installiert werden sollte:

  easy_install dnspython

• spambayes für trac ist noch nicht lauffähig

TracRedirect Plugin

Das TracRedirect Plugin war früher ein Macro.

• Homepage: http://svn.ipd.uka.de/trac/javaparty/wiki/TracRedirect

• die aktuellste Version des TracRedirect Python eggs herunterladen und installieren:

  easy_install-2.4 Redirect-0.9.1-py2.4.egg

• in /etc/trac/trac.ini zum Bereich [components] hinzufügen:

  "redirect.* = enable "

• Webserver neu starten

TracTocMacro

Einige aktuelle Macros werden als Plugin installiert, so auch TOC

• http://trac-hacks.org/wiki/TocMacro

• Zip Datei herunterladen und entpacken. Diese enthält auch ältere Versionen.

• in das Unterverzeichnis v0.10 wechseln und folgendes aufrufen:

  python setup.py bdist_egg
  easy_install-2.4 dist/TracTocMacro-1.0-py2.4.egg

  • v0.11 enthält momentan einen Bug

• in /etc/trac/trac.ini zum Bereich [components] hinzufügen:

  "tractoc.* = enable "

• in Debian Etch wird noch python-genshi benötigt:

  apt-get install python-genshi

  • um das rauszufinden waren die trac Logdateien sinnvoll, die auf sao deaktiviert waren
• Webserver neu starten nicht vergessen

TracPollMacro

• http://trac-hacks.org/wiki/PollMacro

• Zip Datei entpacken

• im Unterverz. 0.9

  python setup.py install

• in /etc/trac/trac.ini reinschreiben:

  [components]
  tracpoll.* = enabled
  [poll]
  base_dir = /foobar

• Webserver neu starten nicht vergessen

• Damit die Umfrage auf einer Wikiseite erscheint, trägst du z.B. folgendes ein:

  [[Poll(Was gefällt dir am Besten?; Radfahren; Zitronen essen; im Sitzen pinkeln)]] 

Trac-Admin-Konsole

Status: nicht mehr nötig, da wir nun das webadmin-Plugin verwenden - ab v0.11 wird es builtin sein

Die Verwaltung der Milestones und der Zugangsrechte ist in der Version 0.8.1 von trac noch nicht per Web-Interface möglich. Also haben wir ein Skript geschrieben, mit dem das Konsolen-Administrationsprogramm per Web-Schnittstelle benutzt werden kann. Es ist äußerst einfach aufgebaut.

Die Zugriffsrechte können lediglich durch http-auth eingeschränkt werden. Jeder authorisierte Nutzer kann generell auf alle trac-Projekte des Systems zugreifen.

Dieses Ticket beschreibt den Problemverlauf. Folgende Schritte sind notwendig:

Die Datei /etc/[apache|apache-ssl|apache2]/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>

Das trac-Admin-Skript findest du hier [Stand: 10. Mai 02005].

Um einen Link zur Konsole einzurichten, sollte folgendes in der 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>

Benachrichtigungsmails

Status: nicht mehr hilfreich, da wir auch ein nicht-https trac anbieten (http://devel.cryptobox.org))

Die Trac Benachrichtigungsmails enthalten in der Fusszeile die URL des jeweiligen Tickets. Da wir einen ssl-Webserver nutzen, muss die URL in unserem Fall mit https:// statt http:// beginnen.

Unter /data/patches/trac liegt der entsprechende Patch¹. Um die Datei zu patchen ist folgendes durchzuführen:

cd /usr/lib/python2.3/site-packages/trac/

patch -p1 </data/patches/trac/notifier_mail-https-ticket-links.patch

Ticket-Kommentare in der Timeline

Kommentare zu den einzelnen Tickets werden in der Timeline nicht angezeigt. Siehe hierzu 890 des Trac-Projekts.

trac >= 0.9

Status: derzeit nötig

• Einstellung in trac.ini: [timeline] -> ticket_show_details auf 1 setzen (für jedes trac-Projekt)

patch -p1 < /data/patches/trac/timeline_ticket_details_v0.10.patch

trac < v0.9

Status: nicht mehr für uns relevant

Unter /data/patches/trac liegen die zwei (angepassten) Patches:

cd /usr/lib/python2.3/site-packages/trac/

patch -p1 < /data/patches/trac/timeline_ticket-change_part1.patch

cd /usr/share/trac/

patch -p1 < /data/patches/trac/timeline_ticket-change_part2.patch