Wer sich entscheidet einen eigenen Bugzilla auf einem Server einzurichten, sollte sich etwas Zeit nehmen. Ich möchte möchte auf mit diesem Eintrag auf einige wichtige Punkte bei der Installation eingehen. Bugzilla ist für ein Linux-System entworfen, dennoch ist grundsätzlich auch eine Einrichtung unter Windows möglich. Ich möchte hier einige Erfahrungen aus meiner Linux-Installation vorstellen.

Grundsätzlich sollte zuerst die Beschreibung von Bugzilla zur Installation gelesen werden unter http://www.bugzilla.org/docs/3.2/en/html/installation.html

1. Vorraussetzungen

- Eine Apache Webserver sollte funktionstüchtig installiert sein 

- Eine Datenbank MySQL,& PostgreSQL, Oracle

- Perl - Installation

2. Download von Bugzilla

Hierbei gilt zu beachten, dass das Archiv mittels dem Befehl wget direkt von der Bugzilla-Downloadseite geladen werden sollte. Tut man das nicht und lädt sie über Windows herunter und entpacke das Archiv, so kann schon eine Fehlerquelle entstehen. Unter Windows sind die Zeilenabschlußkodierung anders und kann unter Linux zu Fehlern bei der Ausführung kommen. Es kann dann zum Beispiel im Apache-Log der Fehler "Premature end of script headers: index.cgi" auftauchen. Das heißt es wird gar keine Html-Seite an den Browser ausgeliefert. In diesem Fall antwortet der Apache mit dem Fehlerdokument 500.

3. Starten der Installation

Hat man das Archiv mit tar an eine entsprechende Stelle entpackt, muss man das Perl-Skript checksetup.pl ausgeführt werden. Dazu ist es möglich, dass es zuerst mit chmod die Ausführungsrechte bekommen muss. Das Skript überprüft, ob alle erforderlichen Perl-Module installiert sind und in der benötigten Version vorliegen. Wenn Module fehlen, bietet checksetup die entsprechenden Befehle zur Nachinstallation an.

Sind alle erforderlichen Perl-Module installiert, kann checksetup erneut ausgeführt werden. Jetzt wird das Konfigurationsfile localconfig angelegt, wenn alle Perl-Module gefunden werden. Jetzt muss die Datei localconfig mit einem Editor bearbeitet werden. Es müssen die Datenbankverbindung, sowie ein DB-Nutzer und DB-Schema eingetragen werden. Ist dies getan, so kann checksetup erneut ausgeführt werden.

In der localconfig muss noch eine webservergroup angegeben werden. Dies muss die Gruppe sein unter der Apache ausgeführt wird. Das könnt ihr ermitteln, wenn der Apache gestartet ist mit dem Kommando top.

Sind die DB-Einstellungen korrekt so werden alle Tabellen im Schema erzeugt sowie die Bugzilla-Konfiguration abgeschlossen. 

4. Einrichtung das Apache-Webservers

Wenn mehrere Domains gehostet werden und Bugzilla unter einer Subdomain eingerichtet wird, so sollte man eine neue Subdomain mittels VirtualHost definieren. Hier gilt zu beachten das oft mit suexec gearbeitet wird (z.B. Plesk). Bugzilla arbeitet in der aktuellen Version 3.2.2 nicht ohne manuelle Anpassungen (hab ich leider nicht zustande bekommen) mit suexec (siehe http://www.bugzilla.org/docs/3.2/en/html/nonroot.html#suexec) 

So könnte eine Konfiguration aussehen:

<VirtualHost xxx:80>

    ServerName   bugzilla.xxx.de:80

    Alias / /pfad/zu/bugzilla/

     <Directory  /pfad/zu/bugzilla>
        Options All
        AddHandler cgi-script .cgi .pl
        AllowOverride all
        Allow from all
        DirectoryIndex index.cgi
    </Directory>

</VirtualHost>

Bugzilla wird jetzt unter http://bugzilla.xxx.de/ erreichbar sein. Vorher den die Konfigurationim Apache neuladen, dass die Einstellungen gültig werden mit /etc/init.d/apache2 reload

5. Mögliche Fehlerquellen

1. Ausführung mit suexec: Kann manuell konfiguriert werden, allerdings ohne weiteres nicht möglich
2. Installation unter cgi-bin also Pfad für cgis die unter ScriptAlias definiert sind ist mit Bugzilla nicht standardmäßig möglich weil alle Dateien in diesem Pfad ausgeführt werden z.B auch Bilder
3. Transfer der Dateien über Windows: Fehlerquelle Zeilenabschlusskodierung