12.7. Installation eines neuen Releases

Die Installation eines neuen Releases von PDFUnit-Java verläuft genauso, wie die Erstinstallation, weil Releases immer vollständig zur Verfügung gestellt werden, nie als Differenz zum vorhergehenden Release.

Beschaffung des neuen Releases

Wenn Sie PDFUnit ohne Lizenzdatei einsetzen, laden Sie sich die neue ZIP-Datei aus dem Internet: http://www.pdfunit.com/de/download/index.html.

Wenn Sie PDFUnit mit Lizenzdatei einsetzen, erhalten Sie das neue Release per Mail mit der ZIP-Datei als Anhang sowie einer separaten Datei mit den Lizenzdaten.

Vorbereitende Schritte für alle Umgebungen

Bevor Sie mit dem Releasewechsel beginnen, führen Sie alle vorhandenen Unittests mit dem alten Release durch. Diese sollten grün sein.

Sichern Sie Ihr Projekt.

Durchführung des Updates

Entpacken Sie das neue Release, jedoch nicht in das bestehende Projekt. Nachfolgend wird der Ordner mit dem neuen Release PDFUNITJAVA_HOME_NEW genannt. Der Ordner Ihres bestehenden Projektes mit dem alten Release wird nachfolgend PROJECT_HOME genannt.

Löschen Sie das Verzeichnis PROJECT_HOME/lib/pdfunit-OLD-VERSION.

Kopieren Sie das Verzeichnis PDFUNITJAVA_HOME_NEW an die Stelle des alten Releases, beispielsweise nach PROJECT_HOME/lib/pdfunit-NEW-VERSION.

Sollten Sie im alten Release die Datei pdfunit.config in einem anderem Verzeichnis, als dem Installationsverzeichnis verwendet haben, so kopieren Sie die neue Datei jetzt aus dem Verzeichnis PROJECT_HOME/lib/pdfunit-NEW-VERSION an Ihren gewünschten Ort.

Sollten Sie im alten Release Änderungen an der pdfunit.config vorgenommen haben, so übertragen Sie die Änderungen in die pdfunit.config des neuen Releases.

Wenn Sie ein lizensiertes PDFUnit-Java einsetzen, kopieren Sie die neue Lizenzdatei license-key_pdfunit-java.lic an den Ort, an dem sie beim alten Release lag.

Weitere Schritte für ANT

Für ANT sind keine weiteren Schritte notwendig, wenn Sie den Classpath so konfiguriert haben, wie weiter oben beschrieben.

Weitere Schritte für Maven

Das neue Release muss in Ihr lokales oder unternehmensweites Repository eingetragen werden. Öffnen Sie dazu eine Konsole, wechseln in das Verzeichnis PROJECT_HOME/lib/pdfunit-NEW-VERSION und führen dort diesen Befehl aus:

mvn install:install-file -Dfile=pdfunit-java-VERSION.jar -DpomFile=pom.xml

Weitere Schritte für Eclipse

Nehmen Sie die neuen JAR-Dateien in den Build-Path auf. Entfernen Sie die alten JAR-Dateien aus dem Build-Path, damit Eclipse keinen Build-Fehler mehr anzeigt.

Verknüpfen Sie die Javadoc-Dokumentation in Eclipse erneut so, wie in Kapitel : „Eclipse konfigurieren“ beschrieben.

Letzter Schritt

Führen Sie Ihre bestehenden Tests mit dem neuen Release durch. Sofern es keine dokumentierten Inkompatibilitäten zwischen dem alten und neuen PDFUnit-Release gibt, sollten Ihre Tests erfolgreich durchlaufen. Andernfalls lesen Sie die Release-Informationen.