<chapter id="troubleshooting">
<title>Fehlersuche</title>
<para>
Wir teilen diesen Abschnitt pro Distribution auf. Natürlich können Sie Ihr eigenes System mit Ihrem eigenen Linux aufsetzen, aber verstehen Sie bitte, dass wir keinen Support für derartiges bieten können. OTRS ist zu kompliziert und hat zu viele Verbindungen zu anderen Komponenten des System, dass wir schon froh sind, Zugang zu Mechanismen wie RPM zu haben. Wir versuchen, soviele Plattformen wie möglich zu unterstützen, aber Zeit ist eine wertvolle Resource.;-)
</para>
<sect1 id="problems-with-suse">
<title>Generelle Probleme mit OTRS auf SuSE Linux</title>
<para>
Der allererste Schritt sollte sein, <ulink url="http://www.suse.de/de/support/download/updates/"><citetitle>http://www.suse.de/de/support/download/updates/</citetitle></ulink> zu besuchen,
eine Seite, auf der sich Patches und Aktualisierungen zu Apache, MySQL, Perl für Ihr SuSE Linux finden. Bitte achten Sie besonders auf Aktualisierungen von Apache, MySQL, Perl und natürlich OTRS. Benutzern von YaST2 sollte es möglich sein den YaST Online Update Mechanismus zu nutzen. Anderenfalls laden Sie die -rpm-Dateien herunter und deinstallieren Sie das alte Paket mit "rpm --nodeps -e otrs" und installieren Sie es erneut mit "rpm -i foo.rpm"
</para>
<para>
Der zweite Schritt sollte ein besuch der <ulink url="http://www.otrs.org/"><citetitle>OTRS Homepage</citetitle></ulink> sein. Wir stellen dort die letzten Aktualisierungen und Anleitungen bereit.
</para>
<para>
Als Drittes mögen Sie eine e-Mail an das Entwicklerteam von OTRS schreiben. Wir werden Sie nach besten Kräften unterstützen.
</para>

<sect2>
<title>SuSE Linux 8.0</title>
<para>
Unglücklicherweise ist das RPM auf der SuSE 8.0 Distribution fehlerhaft (kein SuSE Fehler). Bitte laden Sie die neueste Version von unserer <ulink url="http://www.otrs.org/">Homepage</ulink> und installieren Sie es mit YaST oder manuell via
<screen>
# altes Paket deinstallieren
shell> rpm --nodeps -e otrs
# neues Paket installieren
shell> rpm -i new-otrs.rpm 
</screen>
</para>

</sect2>

<sect2>
<title>SuSE Linux und Postfix</title>
<para>
Postfix kommt leider nicht mit Procmail vorkonfiguriert, Sie müssen es in der /etc/postfix/main.cf aktivieren:
<screen>
[...]
mailbox_command = /usr/bin/procmail
[...]
</screen>
Starten Sie Postfix neu via 'rcpostfix restart'.
</para>

</sect2>

</sect1>

<sect1 id="problems-with-mandrake">
<title>Generelle Probleme mit OTRS auf Mandrake</title>
<para>
OTRS arbeitet wie erwartet auf einem Mandrake System, wenigstens auf einem 9.1 oder 9.2er. Da wir derzeit noch keine RPMs anbieten, müssen Sie den Schriiten zur manuellen Installation des Tarballs in der Dokumentation folgen.
</para>
<sect2>
<title>Aktualisieren Ihres Systems</title>
<para>
Bevor Sie sich daran machen, OTRS auf einem Mandrake System zu installieren, fühlen Sie sich aufgefordert, via Mandrake's Softwarepakete-Management Ihr System auf den neuesten Stand zu bringen. Sie finden eine bequeme Oberfläche in Mandrake's Kontrollzentrum, oder führen Sie diese Kommandos als Superuser über die Kommandozeile aus:
<programlisting>
shell:~ # urpmi.update --update --auto --auto-select
shell:~ # urpmi --update --auto-select
</programlisting>
Dies erfordert eine funktionsfähige Aktualisierungsquelle. Wollen Sie den GWDG.de server nutzen, führen Sie etwas wie dies aus (tauschen Sie &lt;rel&gt; mit Ihrer Mandrake Version):
<programlisting>
shell:~ # urpmi.addmedia update_source ftp://ftp.gwdg.de/pub/linux/mandrake/updates/&lt;rel&gt;/RPMS 
</programlisting>
</para>
</sect2>
</sect1>

<sect1 id="problems-with-redhat">
<title>Generelle Probleme mit OTRS auf anderen Distributionen (z.B. Redhat)</title>
<para>
Ganz ehrlich, wir haben nicht wahrhaft versucht OTRS auf einem RedHat System laufen zu lassen. Es sollte kein Problem darstellen, aber es gibt noch kein fertiges RPM - wir arbeiten dran. Dasselbe gilt für andere, nicht erwähnte Distributionen.
</para>
</sect1>

<sect1 id="problems-with-apache">
<title>Probleme mit Apache</title>
<para>
Meist, wenn Probleme mit Apache auftreten, kompilieren die Leute sich ihren eigenen, oft sehr speziellen Apache. Bitte schön, tun Sie's, aber falls Sie bei Problemen anfragen, verweisen wir bestimmt auf die mit Ihrer Distribution ausgelieferten Version.
</para>

<sect2>
<title>Interner Server Fehler (Interneral Server Error)</title>
<para>
Überprüfen Sie die Syntax der Datei index.pl, um den Fehler zu finden:
<programlisting>
shell:~ # cd ~otrs
</programlisting>
Es ist wichtig, dass Sie sich im $HOME des 'otrs' Benutzers befinden.
<programlisting>
shell:/opt/otrs # perl -cw bin/cgi-bin/index.pl 
bin/cgi-bin/index.pl syntax OK
shell:/opt/otrs #
</programlisting>
Falls Fehler kommen, müssen Sie hochwahrscheinlich fehlende Perl Module von <ulink url="http://www.cpan.org/">CPAN</ulink>.nachinstallieren.
</para>
<para>
So installieren Sie die CPAN Module via der cpan shell:
<programlisting>
shell:~ # perl -MCPAN -e shell;
 -- (evtl. muessen Sie CPAN erst konfigurieren) --

cpan shell -- CPAN exploration and modules installation (v1.59_54)
ReadLine support enabled

cpan> install Digest::MD5
[installing Digest::MD5 module]
cpan> 
</programlisting>
Überprüfen Sie die Syntax nun noch einmal (perl -cw bin/cgi-bin/index.pl) und installieren Sie dann weitere, fehlende Module, falls nötig.
</para>
</sect2>

<sect2>
<title>Fehler: Kann nicht zur Datenbank verbinden!</title>
<para>Die englische Übersetzung der fehlermeldung lautet: 'Error: Can't connect to database!'</para>
<para>
Wenn Sie diese Meldung in Ihrem Browser erhalten, nachdem Sie die Datenbankeinstellungen verändert haben, starten Sie den Webserver neu. mod_perl liest die Konfigurationsdatei von OTRS nur beim Start ein.
</para>
<para>
Bleibt die Meldung bestehen, schauen Sie sich das Fehler-Log Ihres Webservers an. (z.B. /var/log/httpd/error_log).
</para>
</sect2>

<sect2>
<title>FreeBSD, PostgeSQL und Apache (install_driver(Pg) failed)</title>
<para>
Alles funktioniert prima, nur bekomme ich bei jeder Benutzung der Web-Schnittstelle jedes Mal:
[...]
Software error:
install_driver(Pg) failed: [Thu Sep 19 16:52:18 2002] index.pl: [Thu Sep 19
16:52:18 2002] index.pl: Can't load
'/usr/local/lib/perl5/site_perl/5.005/i386-freebsd/auto/DBD/Pg/Pg.so' for
module DBD::Pg: Shared object "libpq.so.2" not found at
/usr/libdata/perl/5.00503/DynaLoader.pm line 169. [Thu Sep 19 16:52:18 2002]
index.pl: [Thu Sep 19 16:52:18 2002] index.pl: [Thu Sep 19 16:52:18 2002]
index.pl: [Thu Sep 19 16:52:18 2002] index.pl: at (eval 124) line 3 Perhaps
a required shared library or dll isn't installed where expected at   
/usr/local/otrs/bin/cgi-bin/../../Kernel/System/DB.pm line 67
[...]
</para>
<para>
Um dieses Problem zu lösen, setzen Sie in der httpd.conf Ihres Apache die Umgebungsvariable LD_LIBRARY_PATH= /usr/local/pgsql/lib. Setzen Sie die Zeile "SetEnv LD_LIBRARY_PATH usr/local/pgsql/lib" in Ihrer httpd.conf und starten Sie den Webserver neu (siehe <ulink url="http://lists.otrs.org/pipermail/otrs/2002-September/000248.html">http://lists.otrs.org/pipermail/otrs/2002-September/000248.html</ulink>).
</para>
</sect2>

</sect1>

<sect1 id="problems-with-mysql">
<title>Probleme mit MySQL</title>
<para>
Bitte überprüfen Sie Ihre Passwörter sehr genau, was die häufigste Fehlerursache ist. Bei Passwortfehlern hilft meist ein Zurücksetzen des Systems.
</para>

<sect2>
<title>Überprüfen Sie die Datenbankverbindung</title>
<para>
Um die Datenbankverbindung zu überprüfen, benutzen Sie den Befehl '~otrs/bin/CheckDB.pl'. Ist die Ausgabe ein "It looks Ok!", haben Sie keine Probleme mit der Verbindung zu Ihrer Datenbank. Anderenfalls achten Sie auf die Fehlerausgabe.
</para>
</sect2>

<sect2>
<title>Fehlermeldung: Access denied for user: 'otrs@localhost'</title>
<para>
Überprüfen Sie das Passwort des Datenbankbenutzers ín der Datei Kernel/Config.pm. Wenn Sie das Passwort nicht (mehr) kennen, setzen Sie es neu:
<programlisting>
shell> mysql -u root -p
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 37 to server version: 3.23.48-log

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> GRANT ALL PRIVILEGES ON otrs.* TO otrs@localhost IDENTIFIED BY "yourpw" WITH GRANT OPTION;
mysql> 
</programlisting>
Laden Sie die Benutzertabellen neu:
<programlisting>
$shell> mysqladmin -u root -p reload
</programlisting>
(oder starten Sie MySQL neu) und ändern Sie das neue Passwort in der Kernel/Config.pm.
</para>
<para>
Notiz: Wenn Sie mod_perl nutzen, starten Sie den Webserver neu, da mod_perl die Konfigurationsdateien nur beim Start einliest , also auch und vor allem Kernel/Config.pm.
</para>
</sect2>

<sect2 id="problems-lost-mysql-root-pw">
<title>root Passwort für MySQL unbekannt</title>
<para>
Siehe: <ulink url="http://www.mysql.com/documentation/mysql/bychapter/manual_Problems.html#Resetting_permissions">http://www.mysql.com/documentation/mysql/bychapter/manual_Problems.html#Resetting_permissions</ulink>
</para>
</sect2>

<sect2>
<title>http://localhost/otrs/installer.pl</title>
<para> 
Wenn Sie die Datenbank erneut aufsetzen wollen, können Sie den Web-Installer aufrufen, indem Sie zu <ulink url="http://localhost/otrs/installer.pl"><citetitle>http://localhost/otrs/installer.pl</citetitle></ulink> navigieren.
</para>
<para>
Notiz: Dies funktioniert im Moment nur für SuSE RPMs.
</para>
</sect2>

</sect1>

<sect1 id="problems-misc">
<title>Sonstige Probleme</title>

<sect2 id="problems-with-receiving-emails">
<title>Probleme beim Empfang von e-Mails</title>
<para>
Wenn alles ausser dem Mailempfang funktioniert, überprüfen Sie, ob das ~otrs/bin/PostMaster.pl Programm korrekt funktioniert. leiten Sie eine der beiden Beispiel-eMails durchm den PostMaster.pl-Prozess (~otrs/doc/test-email-*.box oder /usr/share/doc/packages/otrs/test-email-*.box).
</para>
<para>
Beispiel:
<programlisting>
shell:~ # cat /usr/share/doc/packages/otrs/test-email-1.box | /opt/otrs/bin/PostMaster.pl 
shell:~ #
</programlisting>
Falls Fehler kommen, müssen Sie diese beheben. Falls keine Fehler kommen, und Sie die eMail in der Postmaster Warteschlange sehen, ist Ihr MTA nicht für den Betrieb mit Procmail konfiguriert (Logfiles checken!), oder das $HOME des OTRS Benutzers ist verkehrt gesetzt (überprüfen Sie $HOME und $HOME/.procmailrc).
</para>
</sect2>

<sect2 id="problems-lost-otrs-root-pw">
<title>root Passwort für OTRS unbekannt</title>
<para>
Erhalten Sie die Meldung "Anmeldung fehlgeschlagen! Benutzername oder Passwort falsch.", so setzen Sie das root-Passwort für OTRS zurück:
<programlisting>
shell:~ # mysql -u root -p otrs
mysql> UPDATE system_user SET pw='roK20XGbWEsSM' where login='root@localhost';
mysql>
</programlisting>
Somit setzen Sie das root-Passwort auf 'root'. Der Eintrag ist per crypt() verschlüsselt, siehe 'man 3 crypt'.
</para>
</sect2>

</sect1>

</chapter>
