Documents5 Installations-Ordner

Vor den Anpassungen am Ordner müssen die Dienste für den TableService, für Documents und für den Tomcat gestoppt werden. Für das Update bietet es sich in der Regel an alles zu übernehmen und im Anschluss die Anpassungen wieder zurück zu schreiben. 

Es wird empfohlen den kompletten "Documents5"-Ordner aus dem Update-Paket zu übernehmen! Die Konfigurations-Dateien können später über die WEB-Administration neu konfiguriert werden.

 

DEXPRO

Es wird empfohlen den DEXPRO-Ordner aus dem Update-Paket über die aktuelle Installation zu kopieren. Am DEXPRO-Ordner wurden in der Regel nur die Konfigurationsdateien "dbConn.json", ggf. die "navConn.json" bei einer Anbindung an Navision sowie die Konfigurationsdateien für den Table-Service angepasst. Die ursprünglichen Dateien aus der Sicherung dürfen nicht einfach zurückgetauscht werden, denn ggf. wurden die Dateien erweitert!

 

DEXPRO\Table-Service

Sollte der TableService außerhalb der Documents-Installation liegen, müssen die Dateien in diesen externen Installations-Ordner kopiert werden. Die Konfigurations-Dateien müssen bei einer externen Installation manuell angepasst werden. Alternativ kann die externe Installation auf den Standard umgestellt werden, indem der aktuelle Dienst deinstalliert wird und der TableService-Dienst im Standard-Pfad über die WEB-Administration wieder installiert wird.

Projektspezifische Anpassungen am TableService müssen in jedem Fall wieder zurückgespielt werden! Der TableService muss später über die WEB-Administration neu konfiguriert werden. Deinstallierte Dienste müssen wieder wieder installiert werden.

 

DEXPRO_ClientExits

Die hier befindlichen Dateien dürfen explizit projektspezifisch angepasst werden. Die Anpassungen sind durch das Update vorerst verloren gegangen und müssen manuell wieder zurück übertragen werden! Die aktuellen Dateien können neue Funktionen enthalten oder es können bestehende Funktionen optimiert worden sein. Aus diesem Grund sollten die projektspezifisch angepassten Dateien nicht einfach zurück kopiert werden!

Projektspezifische Anpassungen sollten immer gut identifizierbar mit Kommentaren versehen werden! Bei vielen projektspezifischen Anpassungen kann die Übertragung entsprechend aufwändig sein!

 

server\locale

In das "server"-Verzeichnis werden die aktuellen "properties"-Dateien kopiert. Die als "projektspezifischen Anpassung" gekennzeichneten Übersetzungen stehen in der Datenbank und werden später beim Hochladen der properties in die Datenbank nicht überschrieben. Wenn die properties wieder aus den Daten aus der Datenbank geschrieben wird, dann enthalten die neuen properties alle Neuerungen plus die projektspezifischen Anpassungen.

 

SQUEEZE

Durch das Überschreiben der Konfigurationsdateien geht die Verbindung zum Squeeze-System verloren. Die Verbindung muss später über die WEB-Administration neu konfiguriert werden und es sollte ein neuer API-Key generiert werden.

Um zu vermeiden, dass die neuen Administrations-Oberflächen in Documents noch nicht vorhandene API-Funktionen aus Squeeze aufrufen, sollte auch Squeeze auf eine aktuelle Version aktualisiert werden.

 

tomcat8\conf\Documents\localhost

Hier empfiehlt es sich die "documents.xml" aus der Sicherung zu verwenden. Erweiterungen aus der aktuellen Datei-Version müssen zunächst in die alte Datei-Version übernommen werden! Im Anschluss kann die alte Datei verwendet werden.

 

Zusammenfassung

• Dienste stoppen (Documents/Tomcat/TableService)
• Ordner "Documents5" aus dem Update-Paket über die Installation kopieren.
• Projektspezifische Anpassungen wieder herstellen (DEXPRO_ClientExits)
• "documents.xml" aus Sicherung zurück auf Erweiterungen überprüfen und zurück kopieren