%
%  trac.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel trac %%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Trac - Wiki, Bug und Issue Tracker}
\index{trac}

\section{Die Einleitung}

    Trac ist ein erweitertes Wiki und Issue-Tracking-System f"ur
    Softwareentwicklungsprojekte. Trac verwendet einen minimalistischen
    Ansatz f"ur das webbasierte Softwareprojektmanagement. Die Idee ist es,
    Entwicklern dabei zu helfen, gro"sartige Software zu schreiben, ohne
    dabei im Weg zu stehen. Trac sollte den etablierten Entwicklungsprozess
    und die Richtlinien eines Teams so wenig wie m"oglich beeinflussen.

    Trac bietet eine Schnittstelle zu Subversion und Git (oder anderen
    Versionskontrollsystemen), ein integriertes Wiki und praktische
    Berichtsfunktionen.

    Trac erm"oglicht Wiki-Markups in Problembeschreibungen und Commit-
    Nachrichten und erstellt Links und nahtlose Verweise zwischen Bugs,
    Tasks, Changesets, Dateien und Wiki-Seiten. Eine Zeitleiste zeigt alle
    aktuellen und vergangenen Projektereignisse der Reihe nach an, sodass
    Sie einen "Uberblick über das Projekt erhalten und den Fortschritt sehr
    einfach verfolgen k"onnen. Die Roadmap zeigt den weiteren Verlauf und
    listet die bevorstehenden Meilensteine auf.

    Die Webseite vom Projekt \link{https://trac.edgewall.org}{Trac} und
    den Plugins \link{https://trac-hacks.org}{Trac-Hacks}

    Trac ben"otigt Python3, Trac kann mit SQLite, MariaDB oder PostgreSQL
    als Datenbank betrieben werden.

    Apache2 \pfeil  Python3 unterst"utzung gibt es "uber die Module

    \begin{itemize}
        \item apache2-mod\_wsgi
        \item apache2-mod\_python
    \end{itemize}

    Es k"onnen die Module apache2-mod\_wsgi und apache2-mod\_python nicht
    zusammen  aktiv sein.



\section{Der Webzugriff}

    Das \eisfair trac Paket l"asst sich auf verschiedene Arten zur
    Benutzung konfigurieren.


    Der Zugriff kann "uber eine Subdomain \

    \texttt{http\{s\}://trac.meine.de}  \


    oder in eine bestehende Domain \

    \texttt{http\{s\}://www.meine.de/projects/trac} \


    erfolgen. Es ist auch beides gleichzeitig m"oglich, also "uber die
    Subdomain und in der bestehenden Domain.

    \hinweis{Bei der Subdomain gibt es allerdings eine Einschr"ankung,
             wenn die Seite allgemein freigeschaltet ist, d.h. ohne
             Anmeldung erreicht werden kann, kann auf dieser Seite keine
             nachtr"agliche Anmeldung "uber den \glqq{}Login\grqq{} Button
             erfolgen, um \glqq{}Trac\grqq{} zu Administrieren. In diesem
             Fall ist z.B. eine weitere Seite in einer Domain erforderlich
             die dieses nachtr"agliche Anmelden erm"oglicht.}

    Der https Zugriff f"ur die Subdomain wird "uber die \eisfair trac
    Konfiguration eingestellt, f"ur den https Zugriff in der bestehenden
    Domain muss das SSL Zertifikat von der Domain bereitgestellt werden.

    In der Konfiguration des Apache WebServers m"ussen keine Parameter
    Einstellungen vorgenommen werden.


\section{Das Men"u im Setup-Programm}


    Das Men"u im Setup-Programm ist wie folgt aufgebaut:

    \mbox{}

    \begin{tabular}{lll}
    & x. & Service administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{1cm}lll}
    & x. & Apache2 Webserver \\
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}lll}
    & x. & Configuration \\
    \end{tabular}
\eline
    \begin{tabular}{p{3cm}lll}
    & x. & Modules configuration \\
    \end{tabular}
\eline
    \begin{tabular}{p{4cm}lll}
    & x. & Trac, Wiki and SVN Browser \\
    \end{tabular}
\eline
    \begin{tabular}{p{5cm}lll}
    & 1. & View documentation \\
    & 2. & Edit configuration \\
    & 3. & User handling for web access \\
    & 4. & Remove existing project \\
    & 5. & Resync repository \\
    & 7. & Plugin handling \\
    & 8. & Advanced configuration file handling \\
    \end{tabular}


    \mbox{}


\section{"Anderung der Konfiguration}

    Die Konfiguration wird "uber den Men"upunkt \glqq{}Edit
    configuration\grqq{} ge"andert.

\section{Die Konfigurationsdatei}


    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind
    folgende Parameter vorhanden; wer sie von Hand editieren will findet
    sie unter \\
    \texttt{/etc/config.d/trac}


\section{Die Parameter}


\begin{description}

\config{START\_TRAC}
{START\_TRAC}
{STARTTRAC}
{
    F"ur die Aktivierung des 'trac' muss diese Variable lediglich
    auf den Wert 'yes' gestellt werden. Die Einstellung 'no'
    schaltet 'trac' ab.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{START\_TRAC='no'}
}


\config{TRAC\_PYTHON\_MODUL}
{TRAC\_PYTHON\_MODUL}
{TRACPYTHONMODUL}
{
    "Uber diesen Parameter wird das Python Modul ausgew"ahlt.

    G"ultige Werte: mod\_wsgi, mod\_python

    Standardeinstellung: \texttt{TRAC\_PYTHON\_MODUL='mod\_wsgi'}
}

\end{description}


\subsection{Einstellungen f"ur eine Gruppe}


    Es k"onnen mehrere Projekte in eine Gruppe gebunden werden.
    Diese Projekte sind dann "uber die Seite der Gruppe ausw"ahlbar.

    \hinweis{Diese Projekte k"onnen dann nicht mehr einzeln aufgerufen werden.}


\begin{description}

\config{TRAC\_PROJ\_GRP\_N}
{TRAC\_PROJ\_GRP\_N}
{TRACPROJGRPN}
{
    "Uber diesen Parameter wird die Anzahl der trac Gruppen angegeben.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_N='1'}
}


\config{TRAC\_PROJ\_GRP\_x\_NAME}
{TRAC\_PROJ\_GRP\_x\_NAME}
{TRACPROJGRPNAME}
{
    An dieser Stelle wird der Name angeben "uber den die Gruppe sp"ater
    im Browser angesprochen werden soll.

    G"ultige Werte: alles

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_x\_NAME='trac-group'}
}


\config{TRAC\_PROJ\_GRP\_x\_ACTIVE}
{TRAC\_PROJ\_GRP\_x\_ACTIVE}
{TRACPROJGRPxACTIVE}
{
    "Uber diesen Parameter wird eingestellt, ob der Datensatz
    aktiv sein soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_x\_ACTIVE='no'}
}

\end{description}


\subsubsection{Einstellungen f"ur einen Host bei einer Gruppe}


\begin{description}

\config{TRAC\_PROJ\_GRP\_x\_HOST}
{TRAC\_PROJ\_GRP\_x\_HOST}
{TRACPROJGRPxHOST}
{
    Hier wird angegeben, ob das Project in einem Host ausgef"uhrt
    werden soll. \\
    (www.meine.de/projects/trac)

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_x\_HOST='yes'}
}


\config{TRAC\_PROJ\_GRP\_x\_HOST\_NAME}
{TRAC\_PROJ\_GRP\_x\_HOST\_NAME}
{TRACPROJGRPHOSTNAME}
{
    Hier wird der Host(Servername) angegeben, in dem das Project
    ausgef"uhrt werden soll. Im Normalfall ist dies der
    \texttt{APACHE2\_SERVER\_NAME}.

    G"ultige Werte: Servername

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_x\_HOST\_NAME='APACHE2\_SERVER\_NAME'}
}


\config{TRAC\_PROJ\_GRP\_x\_HOST\_ALIAS}
{TRAC\_PROJ\_GRP\_x\_HOST\_ALIAS}
{TRACPROJGRPHOSTALIAS}
{
    Hier wird der Alias angegeben, "uber den das Project angesprochen
    werden soll.

    Beispiel: \pfeil  \{http\{s\}://\}www.meine.de/projects/trac

    G"ultige Werte: jeder g"ultige Name

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_x\_HOST\_ALIAS='trac'}
}


\config{TRAC\_PROJ\_GRP\_x\_HOST\_FORCE\_SSL}
{TRAC\_PROJ\_GRP\_x\_HOST\_FORCE\_SSL}
{TRACPROJGRPHOSTFORCESSL}
{
    Soll der Zugriff immer mit https erfolgen.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_x\_HOST\_FORCE\_SSL='no'}
}

\end{description}


\subsubsection{Einstellungen f"ur die Anmeldung bei einer Gruppe}


\begin{description}

\config{TRAC\_PROJ\_GRP\_x\_ACCESS\_ALL}
{TRAC\_PROJ\_GRP\_x\_ACCESS\_ALL}
{TRACPROJGRPACCESSALL}
{
    Hier ist der Zugriff f"ur alle erlaubt, Weltweit.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_x\_ACCESS\_ALL='no'}
}


\config{TRAC\_PROJ\_GRP\_x\_ACCESS\_AUTH}
{TRAC\_PROJ\_GRP\_x\_ACCESS\_AUTH}
{TRACPROJGRPACCESSAUTH}
{
    Hier ist der Zugriff mit Benutzername und Passwort erlaubt.
    Benutzer m"ussen daf"ur "uber den Men"upunkt
    \glqq{}User handling for web access\grqq{}
    in der trac administration ein Passwort erhalten.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_x\_ACCESS\_AUTH='no'}
}


\config{TRAC\_PROJ\_GRP\_x\_ACCESS\_AUTH\_SEND\_MAIL\_FROM}
{TRAC\_PROJ\_GRP\_x\_ACCESS\_AUTH\_SEND\_MAIL\_FROM}
{TRACPROJGRPACCESSAUTHSENDMAILFROM}
{
    Bei der Einstellung \texttt{TRAC\_PROJ\_GRP\_x\_ACCESS\_AUTH} muss
    hier eine Mail Adresse angeben werden, die als Absender benutzt
    werden soll. Es werden damit die Zugangsdaten versandt. \\
    Bleibt dieser Parameter leer, wird keine Mail versandt.

    G"ultige Werte: leer, Mail Adresse

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_x\_ACCESS\_AUTH\_SEND\_MAIL\_FROM='{}'}
}


\config{TRAC\_PROJ\_GRP\_x\_ACCESS\_HOST}
{TRAC\_PROJ\_GRP\_x\_ACCESS\_HOST}
{TRACPROJGRPACCESSHOST}
{
    Hier ist der Zugriff von Hostname erlaubt.
    Es d"urfen mehrere durch ein Leerzeichen getrennt angegeben
    werden.

    G"ultige Werte: Hostname, Domain

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_x\_ACCESS\_HOST='{}'}
}


\config{TRAC\_PROJ\_GRP\_x\_ACCESS\_IP}
{TRAC\_PROJ\_GRP\_x\_ACCESS\_IP}
{TRACPROJGRPACCESSIP}
{
    Hier ist der Zugriff von der IP Adresse erlaubt.
    Es d"urfen mehrere durch ein Leerzeichen getrennt angegeben
    werden.

    Beispiel: 10 192.168.6 192.168.6.1 192.168.6.0/24

    G"ultige Werte: IP Adresse

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_x\_ACCESS\_IP='{}'}
}


\config{TRAC\_PROJ\_GRP\_x\_ACCESS\_LOCAL}
{TRAC\_PROJ\_GRP\_x\_ACCESS\_LOCAL}
{TRACPROJGRPACCESSLOCAL}
{
    Hier ist der Zugriff local erlaubt.

    \hinweis{Diese Einstellung l"asst sich nicht mit anderen Methoden kombinieren.}

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_GRP\_x\_ACCESS\_LOCAL='yes'}
}

\end{description}


\subsection{Einstellungen f"ur ein Projekt}


\begin{description}


\config{TRAC\_PROJ\_N}
{TRAC\_PROJ\_N}
{TRACPROJN}
{
    "Uber diesen Parameter wird die Anzahl der trac Projekte angegeben.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{TRAC\_PROJ\_N='1'}
}


\config{TRAC\_PROJ\_x\_NAME}
{TRAC\_PROJ\_x\_NAME}
{TRACPROJNAME}
{
    An dieser Stelle wird der Name angeben "uber den das Projekt sp"ater
    im Browser angesprochen werden soll

    G"ultige Werte: alles

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_NAME='trac'}
}


\config{TRAC\_PROJ\_x\_ACTIVE}
{TRAC\_PROJ\_x\_ACTIVE}
{TRACPROJACTIVE}
{
    "Uber diesen Parameter wird eingestellt, ob der Datensatz
    aktiv sein soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_NAME\_ACTIVE='yes'}
}


\config{TRAC\_PROJ\_x\_GRP\_MEMBER}
{TRAC\_PROJ\_x\_GRP\_MEMBER}
{TRACPROJGRPMEMBER}
{
    "Uber diesen Parameter wird eingestellt, ob dieses Projekt in einer
    Gruppe im Web sichtbar sein soll.

    G"ultige Werte: no oder Gruppenname

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_GRP\_MEMBER='no'}
}


\end{description}


\subsubsection{Einstellungen f"ur ein Projekt bei einer Subdomain}


\begin{description}


\config{TRAC\_PROJ\_x\_SUBDOMAIN}
{TRAC\_PROJ\_x\_SUBDOMAIN}
{TRACPROJSUBDOMAIN}
{
    Hier wird angegeben, ob das Project in einer Subdomain
    ausgef"uhrt werden soll. (trac.meine.de)

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SUBDOMAIN='no'}
}


\config{TRAC\_PROJ\_x\_SUBDOMAIN\_NAME}
{TRAC\_PROJ\_x\_SUBDOMAIN\_NAME}
{TRACPROJSUBDOMAINNAME}
{
    Hier wird der Komplette Name der Domain eingegeben

    Beispiel: \pfeil  \{http\{s\}://\}trac.meine.de

    G"ultige Werte: Qualifizierter Domain Name

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SUBDOMAIN\_NAME='{}'}
}


\config{TRAC\_PROJ\_x\_SUBDOMAIN\_PORT}
{TRAC\_PROJ\_x\_SUBDOMAIN\_PORT}
{TRACPROJSUBDOMAINPORT}
{
    Hier wird der Port f"ur die HTTP Verbindung eingegeben.

    G"ultige Werte: Port

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SUBDOMAIN\_PORT='80'}
}


\config{TRAC\_PROJ\_x\_SUBDOMAIN\_ADMIN}
{TRAC\_PROJ\_x\_SUBDOMAIN\_ADMIN}
{TRACPROJSUBDOMAINADMIN}
{
    Hier wir die Mail Adresse des Server Admin angegeben

    G"ultige Werte: Mail Adresse

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SUBDOMAIN\_ADMIN='{}'}
}


\config{TRAC\_PROJ\_x\_SUBDOMAIN\_FORCE\_SSL}
{TRAC\_PROJ\_x\_SUBDOMAIN\_FORCE\_SSL}
{TRACPROJSUBDOMAINFORCESSL}
{
    Soll der Zugriff immer mit https erfolgen.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SUBDOMAIN\_FORCE\_SSL='no'}
}


\config{TRAC\_PROJ\_x\_SUBDOMAIN\_SSL\_PORT}
{TRAC\_PROJ\_x\_SUBDOMAIN\_SSL\_PORT}
{TRACPROJSUBDOMAINSSLPORT}
{
    Hier wird der Port f"ur die HTTPS Verbindung eingegeben.

    G"ultige Werte: Port

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SUBDOMAIN\_SSL\_PORT='443'}
}


\config{TRAC\_PROJ\_x\_SUBDOMAIN\_SSL\_CERT}
{TRAC\_PROJ\_x\_SUBDOMAIN\_SSL\_CERT}
{TRACPROJSUBDOMAINSSLCERT}
{
    Hier wird das Server Zertifikat f"ur die SSL Verbindung angegeben.

    In der Konfiguration des Certs und Certs\_dehydrated Pakets m"ussen
    keine Parameter Einstellungen vorgenommen werden.

    G"ultige Werte: Zertifikat

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SUBDOMAIN\_SSL\_CERT='{}'}
}


\end{description}


\subsubsection{Einstellungen f"ur ein Projekt bei einem Host}


\begin{description}


\config{TRAC\_PROJ\_x\_HOST}
{TRAC\_PROJ\_x\_HOST}
{TRACPROJHOST}
{
    Hier wird angegeben, ob das Project in einem Host ausgef"uhrt
    werden soll.  \\
    (www.meine.de/projects/trac)

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_HOST='yes'}
}


\config{TRAC\_PROJ\_x\_HOST\_NAME}
{TRAC\_PROJ\_x\_HOST\_NAME}
{TRACPROJHOSTNAME}
{
    Hier wird der Host(Servername) angegeben, in dem das Project
    ausgef"uhrt werden soll. Im Normalfall ist dies der
    \texttt{APACHE2\_SERVER\_NAME}.

    G"ultige Werte: Servername

    Standardeinstellung:  \texttt{TRAC\_PROJ\_x\_HOST\_NAME='APACHE2\_SERVER\_NAME'}
}


\config{TRAC\_PROJ\_x\_HOST\_ALIAS}
{TRAC\_PROJ\_x\_HOST\_ALIAS}
{TRACPROJHOSTALIAS}
{
    Hier wird der Alias angegeben, "uber den das Project angesprochen
    werden soll.

    Beispiel: \pfeil  \{http\{s\}://\}www.meine.de/projects/trac

    G"ultige Werte: jeder g"ultige Name

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_HOST\_ALIAS='trac'}
}


\config{TRAC\_PROJ\_x\_HOST\_FORCE\_SSL}
{TRAC\_PROJ\_x\_HOST\_FORCE\_SSL}
{TRACPROJHOSTFORCESSL}
{
    Soll der Zugriff immer mit https erfolgen.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_HOST\_FORCE\_SSL='no'}
}


\end{description}


\subsubsection{Einstellungen f"ur die Anmeldung bei einem Projekt}


\begin{description}



\config{TRAC\_PROJ\_x\_ACCESS\_ALL}
{TRAC\_PROJ\_x\_ACCESS\_ALL}
{TRACPROJACCESSALL}
{
    Hier ist der Zugriff f"ur alle erlaubt, Weltweit.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_ACCESS\_ALL='no'}
}


\config{TRAC\_PROJ\_x\_ACCESS\_AUTH}
{TRAC\_PROJ\_x\_ACCESS\_AUTH}
{TRACPROJACCESSAUTH}
{
    Hier ist der Zugriff mit Benutzername und Passwort erlaubt.
    Benutzer m"ussen daf"ur "uber den Men"upunkt
    \glqq{}User handling for web access\grqq{} in der
    trac administration ein Passwort erhalten.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_ACCESS\_AUTH='no'}
}


\config{TRAC\_PROJ\_x\_ACCESS\_AUTH\_SEND\_MAIL\_FROM}
{TRAC\_PROJ\_x\_ACCESS\_AUTH\_SEND\_MAIL\_FROM}
{TRACPROJACCESSAUTHSENDMAILFROM}
{
    Bei der Einstellung \texttt{TRAC\_PROJ\_x\_ACCESS\_AUTH}
    muss hier eine Mail Adresse angeben werden, die als Absender
    benutzt werden soll. Es werden damit die Zugangsdaten versandt. \\
    Bleibt dieser Parameter leer, wird keine Mail versandt.

    G"ultige Werte: leer, Mail Adresse

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_ACCESS\_AUTH\_SEND\_MAIL\_FROM='{}'}
}


\config{TRAC\_PROJ\_x\_ACCESS\_HOST}
{TRAC\_PROJ\_x\_ACCESS\_HOST}
{TRACPROJACCESSHOST}
{
    Hier ist der Zugriff von Hostname erlaubt.
    Es d"urfen mehrere durch ein Leerzeichen getrennt angegeben
    werden.

    G"ultige Werte: Hostname, Domain

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_ACCESS\_HOST='{}'}
}


\config{TRAC\_PROJ\_x\_ACCESS\_IP}
{TRAC\_PROJ\_x\_ACCESS\_IP}
{TRACPROJACCESSIP}
{
    Hier ist der Zugriff von der IP Adresse erlaubt.
    Es d"urfen mehrere durch ein Leerzeichen getrennt angegeben
    werden.

    Beispiel: 10 192.168.6 192.168.6.1 192.168.6.0/24

    G"ultige Werte: IP Adresse

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_ACCESS\_IP='{}'}
}


\config{TRAC\_PROJ\_x\_ACCESS\_LOCAL}
{TRAC\_PROJ\_x\_ACCESS\_LOCAL}
{TRACPROJACCESSLOCAL}
{
    Hier ist der Zugriff local erlaubt.

    \hinweis{Diese Einstellung l"asst sich nicht mit anderen Methoden kombinieren.}

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_ACCESS\_LOCAL='yes'}
}


\end{description}


\subsection{Einstellungen Misc}


\begin{description}


\config{TRAC\_PROJ\_x\_ADMIN\_USER}
{TRAC\_PROJ\_x\_ADMIN\_USER}
{TRACPROJADMINUSER}
{
    Hier wird der Name des Users angegeben der TRAC\_ADMIN werden soll.
    Dies kann sp"ater jederzeit ge"andert werden. Auch wird dieser User
    der htpasswd Datei hinzugef"ugt.
    Das Passwort wird nach dem Speichern der Konfiguration abgefragt.
    Der User wird sofort gepr"uft (/etc/passwd).

    G"ultige Werte: existierender User Name

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_ADMIN\_USER='{}'}
}


\config{TRAC\_PROJ\_x\_REPO\_TYPE}
{TRAC\_PROJ\_x\_REPO\_TYPE}
{TRACPROJREPOTYPE}
{
    Hier wird der Repo Typ eingestellt. Im Moment ist nur 'svn' erlaubt.

    G"ultige Werte: svn

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_REPO\_TYPE='svn'}
}


\config{TRAC\_PROJ\_x\_REPO\_PATH}
{TRAC\_PROJ\_x\_REPO\_PATH}
{TRACPROJREPOPATH}
{
    Hier wird der Pfad eingetragen, an dem das Repo liegt,
    ohne '/' am Ende. Es werden nur angelegte Repos angenommen.
    Das heisst, der Pfad wird sofort gepr"uft.

    G"ultige Werte: Pfad/zum/repo

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_REPO\_PATH='{}'}
}


\config{TRAC\_PROJ\_x\_DATABASE}
{TRAC\_PROJ\_x\_DATABASE}
{TRACPROJDATABASE}
{
    Es kann die Datenbank ausgew"ahlt werden, in der Trac
    die Daten speichert.

    G"ultige Werte: pgsql, sqlite, mysql

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_DATABASE='sqlite'}
}


\config{TRAC\_PROJ\_x\_SPEC\_LOGO}
{TRAC\_PROJ\_x\_SPEC\_LOGO}
{TRACPROJSPECLOGO}
{
    "Uber diesen Parameter wird gesteuert, ob das Default Logo
    'eisfair' benutzt werden soll oder ein eigenes verwendet
    werden soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SPEC\_LOGO='no'}
}


\config{TRAC\_PROJ\_x\_SPEC\_LOGO\_ALT}
{TRAC\_PROJ\_x\_SPEC\_LOGO\_ALT}
{TRACPROJSPECLOGOALT}
{
    Hier wird ein alternativer Namen f"ur die Logo Position
    angegeben, der angezeigt wird, wenn das Logo, warum auch
    immer, nicht angezeigt wird. \\
    \texttt{(Nur bei TRAC\_PROJ\_x\_SPEC\_LOGO='yes')}

    G"ultige Werte: Name

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SPEC\_LOGO\_ALT='{}'}
}


\config{TRAC\_PROJ\_x\_SPEC\_LOGO\_HEIGHT}
{TRAC\_PROJ\_x\_SPEC\_LOGO\_HEIGHT}
{TRACPROJSPECLOGOHEIGHT}
{
    Hier wird die H"ohe f"ur das Logo angegeben. \\
    \texttt{(Nur bei TRAC\_PROJ\_x\_SPEC\_LOGO='yes')}

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SPEC\_LOGO\_HEIGHT='73'}
}


\config{TRAC\_PROJ\_x\_SPEC\_LOGO\_WIDTH}
{TRAC\_PROJ\_x\_SPEC\_LOGO\_WIDTH}
{TRACPROJSPECLOGOWIDTH}
{
    Hier wird die Breite f"ur das Logo angegeben. \\
    \texttt{(Nur bei TRAC\_PROJ\_x\_SPEC\_LOGO='yes')}

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SPEC\_LOGO\_WIDTH='236'}
}


\config{TRAC\_PROJ\_x\_SPEC\_LOGO\_LINK}
{TRAC\_PROJ\_x\_SPEC\_LOGO\_LINK}
{TRACPROJSPECLOGOLINK}
{
    Hier wird der Link eingetragen, der beim Klick auf das Logo
    erreicht werden soll. \\
    \texttt{(Nur bei TRAC\_PROJ\_x\_SPEC\_LOGO='yes')}

    G"ultige Werte: Url:

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SPEC\_LOGO\_LINK='{}'}
}


\config{TRAC\_PROJ\_x\_SPEC\_LOGO\_SRC}
{TRAC\_PROJ\_x\_SPEC\_LOGO\_SRC}
{TRACPROJSPECLOGOSRC}
{
    Hier wird der Name des Logo eingetragen (Ohne Pfad).
    Das Logo muss daf"ur im Pfad des Projects/htdocs/ abgelegt/gelinkt
    werden. \\
    \texttt{(Nur bei TRAC\_PROJ\_x\_SPEC\_LOGO='yes')}

    G"ultige Werte: Name des Logo

    Standardeinstellung: \texttt{TRAC\_PROJ\_x\_SPEC\_LOGO\_SRC='{}'}
}


\end{description}



\section{User handling for web access}


    "Uber diesen Menu Punkt werden die User hinzugef"ugt, entfernt und
    das Passwort ge"andert.

    F"ur das zusenden der Passw"orter ist ein 'smtp' Mailer erforderlich.

    Die Passw"orter k"onnen automatisch mit dem Tool 'pwgen' erzeugt
    werden, oder selbst eingegeben werden. Die Passw"orter werden mit
    dem Tool 'pwtest' gegen die libcrack gepr"uft. F"ur eine bessere
    Sicherheit der Passw"orter ist es empfohlen das Paket
    'crack-dict-full' zu installieren.

    Im Browser wird das angelegte Projekt, bei der Einstellung Host 
    \glqq{}yes\grqq{}, wie folgt aufgerufen.

    mein\_eisfair\_server/projects/\$project\_name




\section{Remove existing project}


    "Uber diesen Menu Punkt k"onnen bestehende Projekte wieder entfernt werden.



\section{Resync rerpository}


    "Uber diesen Menu Punkt kann bei bestehenden Projekten ein resync der 
    Repository Historie erfolgen, wenn \glqq{}trac\grqq{} es verlangt. \\
    \hinweis{Das kann bei gr"o"seren Repos l"anger dauern.}


\section{Plugin handling}

    Experimentel:

    "Uber diesen Menu Punkt werden die Plugins einem Projekt hinzugef"ugt
    und entfernt.

    User die selber Plugins hinterlegen wollen, k"onnen diese unter
    '/var/lib/trac/plugins' ablegen, dann k"onnen sie "uber das Menu
    mit verwaltet werden.


    Gerne darf daf"ur auch ein \eisfair Paket geschn"urt werden.
