[[fhc:server|zurück zur Übersicht]]

====== Troubleshooting ======

===== Datenübernahme von MSSQL =====
Beim Zugriff auf einen MSSQL Server zur Datenübernahme kann es zu folgendem Fehler kommen:
<code>
Unicode data in a Unicode-only collation or ntext data cannot be sent to clients using DB-Library (such as ISQL) or ODBC version 3.7 or earlier.
</code>

Um das Prolem zu beheben muss in der Datei /etc/freetds/freetds.conf folgender Eintrag hinzugefügt werden:
<code>
...
[global]
tds version = 8.0
client charset = UTF-8 
...
</code>
===== FAS - Studiengangsbaum wird nicht geladen =====
Problem:
Nach der Installation wird der Baum mit den Studiengängen nicht angezeigt.
Beim Aufruf des RDF wird folgende Meldung angezeigt:
<code>
Wenn keine Authentifizierung stattfindet, muss eine studiengang_kz uebergeben werden
</code>

Lösung:
Im RDF Ordner muss eine .htaccess Datei vorhanden sein. Diese muss vom Webserver auch interpretiert werden.
[[admin:einrichten|=> siehe RDF Verzeichnis einrichten]]

===== Dokumentenerstellung schlägt fehl =====
==== Dokumentenkonvertierung ist derzeit nicht möglich ====
Die Dokumentenerstellung bricht mit einer Fehlermeldung ab / das erstellte Dokument ist leer.

<code>
Dokumentenkonvertierung ist derzeit nicht möglich. Bitte informieren Sie den Administrator
</code>
Dies kann daran liegen, dass der unoconv Listener nicht läuft. Sollte der Prozess manuell gestartet worden sein, muss dieser wie in der [[admin:installation#dokumentenerstellung_einrichten|Dokumentenerstellung]] erläutert, neu gestartet werden.

==== SSL operation failed ====
<code>
Warning: DOMDocument::load(): SSL operation failed with code 1. OpenSSL Error messages: error:1416F086:SSL routines:tls_process_server_certificate:certificate verify failed in /var/www/html/content/pdfExport.php on line 366
</code>
Das SSL Zertifikat des Apache Webservers ist in diesem Fall nicht vertrauenswürdig. Dies kann folgende Ursachen haben:
  * Es wird ein Self Signed Zertifikat verwendet anstatt eines offiziellen Zertifikats
  * Das SSL Zertifikat ist abgelaufen und muss erneuert werden
  * Die Uhrzeit des Servers ist nicht korrekt 

==== type detection failed ====
Das PDF hat eine Größe von 0kb. Im Error Log wird folgende Fehlermeldung angezeigt:
<code>
unoconv: RuntimeException during import phase:
Office probably died. Unsupported URL <file:///tmp/593a6c8e1c1d0/out.odt>: "type detection failed"
</code>

In diesem Fall wir die Datei nicht gefunden. Wenn Apache mit Systemd läuft, wird per Default ein eigenes privates /tmp Verzeichnis erstellt. Daher wird die Datei von LibreOffice nicht gefunden. 
Die Dateien liegen dann\\


anstatt unter\\
/tmp/593a6c8e1c1d0/out.odt\\


im Ordner\\ 
/tmp/systemd-private-XXXXX-apache2.service-XXXX/tmp/593a6c8e1c1d0/out.odt\\


Damit die Dokumentenerstellung funktioniert muss das Private Temp deaktiviert werden.\\
Dazu muss der Eintrag //PrivateTmp=true//auf //false// geändert werden.
<code>
cd /etc/systemd/system/
mkdir apache2.service.d
cd apache2.service.d
vim nopt.conf
</code>

Die Datei hat folgenden Inhalt:\\
<code /etc/systemd/system/apache2.service.d/nopt.conf>
[Service]
PrivateTmp=false
</code>

Damit die Änderungen übernommen werden müssen der Daemon und Apache neu gestartet werden.
<code>
systemctl daemon-reload
systemctl restart apache2
</code>

===== Sonstige Tipps zur Fehlersuche =====

Auf folgender Seite kann die aktuelle Serverkonfiguration geprüft werden.
Eventuell fehlende Tools oder Konfigurationen werden hier angezeigt.
<code>
https://fhcomplete.example.com/system/environment.php
</code>

Werden Fehlermeldungen im Apache Logfile angezeigt?
Per Default wird das Log in folgende Datei geschrieben:
<code>
tail /var/log/apache2/error.log
</code>

Das Loglevel des Apache Servers kann erhöht werden um zusätzliche Nachrichten im Logfile anzuzeigen.
<code /etc/apache2/apache2.conf>
LogLevel debug
</code>

Das Loglevel von PHP kann erhöht werden um zusätzliche Fehlermeldungen anzuzeigen.

<code /etc/php/php7/apache2/php.ini>
display_errors = On
error_reporting = E_ALL
</code>

Wird der Request von Apache verarbeitet?
In der Datei access.log werden alle Zugriffe geloggt. Eventuell erreicht der Request nicht den Webserver wenn dieser durch eine Firewall etc blockiert wird. In solchen Fällen sollte das Logfile geprüft werden ob der Request verarbeitet wird.
<code>
tail /var/log/apache2/access.log
</code>