Kapitel 8. Typische Fehler

Zur Laufzeit kann es system- und situationsbedingt Fehlermeldung geben. Um diese besser zu verstehen und deren Ursachen zu beseitigen, werden nachfolgend typische Situationen und ihre Meldungen vorgestellt.

Evaluation-Modus von PDFUnit-Monitor - Limit erreicht

Im Evaluierungs-Modus können mit dem PDFUnit-Monitor maximal 50 Testfälle durchgeführt werden. Wird diese Zahl überschritten, erscheint folgende Meldung:

Sie müssen dann die Anwendung neu starten. Selbstverständlich besteht die Möglichkeit, eine Testlizenz für ein ungestörtes Testen zu beantragen. Schreiben Sie dafür ein Mail an info[at]pdfunit.com.

Anwendung zweimal gestartet - Logging-Port belegt

Der interne Logging-Appender 'PDFUnitMonitorAppender' (siehe log4j2.xml) schickt seine Prüfergebnisse über Sockets an die Oberfläche. Dafür wird Port 4445 verwendet. Falls die Anwendung ein zweites Mal gestartet wird, ist dieser Port schon belegt und es erscheint folgende Fehlermeldung:

Wenn dieser Port schon verwendet wird, muss er für den Monitor in den Dateien pdfunit-monitor.config und log4j2.xml auf einen anderen Wert gesetzt werden.

Anzeige im Verzeichnisbaum unvollständig

Gelegentlich werden die Dateinamen in der Verzeichnisstruktur nicht vollständig dargestellt. In solchen oder ähnlichen Fällen kann der Button 'Reset All' gedrückt werden. Dann werden alle Verzeichnisse frisch eingelesen. Die bis dahin erhaltenen Prüfergebnisse werden dabei verworfen. Falls die Prüfergebnisse erhalten bleiben sollen, müssen sie zuvor exportiert werden.

Konfigurationsdatei pdfunit.config nicht im Classpath

Aus welchem Grund auch immer eine Datei aus dem Installationsverzeichnis verschwindet - der PDFUnit-Monitor reagiert auf das Fehlen mit einer entsprechenden Meldung:

Die beste Art, zu kontrollieren, ob alle benötigten Dateien auch gefunden werden können, ist, das Skript verifyInstallation.bat (oder *.sh) zu starten. Die anschließend erzeugte HTML-Datei verifyInstallation_result.html muss den Text 'Summary: No Errors' enthalten.

Konfigurationsdatei pdfunit-monitor.config nicht im Classpath

Auch die Konfigurationsdatei pdfunit-monitor.config könnte aus dem Classpath verschwinden. Dann erscheint beim Starten folgende Meldung: