Zurück |  | Weiter

## 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.

Zurück | Nach oben | Weiter
12.6. Überprüfung der Konfiguration | Zum Anfang | 12.8. Deinstallation