Diese Seite beschreibt wie Trac-Projekte auf ''systemausfall.org'' angelegt und verwaltet werden.

<<TableOfContents>>

= Neues Projekt anlegen =
Bisher läuft es nur manuell, dafür ist es aber schön trivial. Zuvor brauchst du ein existierendes svn Repository: {{{
/data/scripts/erzeuge_svn_repos.sh NAME
trac-admin /data/trac/NAME initenv}}}
 * bei der trac Initialisierung gibt's du ''/data/repos/NAME'' als svn Pfad an.

Die neu angelegte Verzeichnisstruktur muss nun noch den Besitzer wechseln:{{{
chown -R www-data. /data/trac/NAME}}} 

Folgende Anpassung von ''/data/trac/NAME/conf/trac.ini'' müssen vorgenommen werden: {{{
[trac]
htdocs_location = /trac-shared/

[notification]
smtp_enabled = true
smtp_replyto = trac-NAME[at]lists.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 kann, falls es kein Repository zum Projekt gibt, ''/var/lib/svn-dummy-repos/'' angeben.

Nach Änderungen der Konfigurationsdatei musst du wegen ''mod_python'' den ''apache'' neustarten: {{{
apache2ctl restart }}}

= Eine Mailingliste einrichten =
Zum Anlegen einer Mailingliste für das ''trac''-Projekt sind zwei Schritte erforderlich:
 * auf dem ldap-Server: `ldap-admin.sh service_add trac NAME "eine fluffige Beschreibung"`
 * sende eine Mail an ''trac-NAME-create[at]lists.systemausfall.org''

= Die Admin-Konsole einrichten =
Um Trac per Weboberfläche zu verwalten, steht die Admin-Konsole zur Verfügung. Die Einrichtung wird unter [[FaxeTrac/Anpassungen]] beschrieben.

= Admin-Rechte vergeben =
Um einem Nutzer alle Rechte zu geben, genügt folgende Zeile in der ''trac''-Admin-Konsole: {{{
permission add $NUTZER TICKET_ADMIN REPORT_CREATE REPORT_MODIFY REPORT_DELETE REPORT_ADMIN WIKI_DELETE WIKI_ADMIN MILESTONE_CREATE MILESTONE_MODIFY MILESTONE_DELETE ROADMAP_ADMIN CONFIG_VIEW TRAC_ADMIN }}}

= Spam löschen =
Nicht selten passiert es, dass Trac-Tickets von Spam betroffen sind. Dabei lassen sich zwei Fälle betrachten:
 * Ein komplett neues Ticket wird angelegt und enthält Spam
 * Einem bestehenden Ticket wird ein Kommentar mit Spam hinzugefügt
Natürlich ist es wünschenswert, wenn der Spam schnell verschwindet, also aus der Datenbank gelöscht wird. Melde dich dazu im jeweiligen Trac an und wähle das entsprechende Ticket aus. Du wirst in der Ticketbeschreibung oder im Ticketkommentar nun ein Button mit der Bezeichnung ''delete'' finden. Damit kannst du das ganze Ticket bzw. nur den Kommentar löschen.<<BR>>
Sie dir bewusst, dass nach dem Löschen eines Tickets es unwiederrufbar verloren ist.