Navigation:  Installation & Allgemeine Informationen > Upgrade auf die neueste Version > Upgrade-Schritte von WebOffice > Upgrade WebOffice 10.7 nach 10.8

Dieses Kapitel beschreibt eine Schritt-für-Schritt Anleitung sowie Empfehlungen von VertiGIS für ein Upgrade zur aktuellsten Version von WebOffice. Das neue Release-Paket steht im Downloadcenter zur Verfügung.

 

Hinweise: 

•Ist neben WebOffice ebenfalls VertiGIS GeoOffice installiert, so muss darauf geachtet werden, dass veraltete GeoOffice Module aktualisiert bzw. falls nicht mehr benötigt deinstalliert werden. Anderenfalls kann es zu Problemen im Betrieb mit WebOffice kommen.

•Beantragen Sie bitte im Vorfeld eine aktuelle Lizenz von WebOffice - siehe Kapitel Lizenzierung von WebOffice.

 

Vorsicht:

•Mit WebOffice 10.8 ändert sich das Arbeitsverzeichnis des WebOffice author standalone. Um bestehende Profile weiterhin verwenden zu können, müssen diese vor der Deinstallation exportiert und nach Neuinstallation wieder importiert werden. Falls ein Stagingmapping zur Produktivnahme von Projekten verspeichert ist, müssen die entsprechenden .json-Files von %APPDATA%\Roaming\SynerGIS\WebOfficeAuthorStandalone\UIData\GoLiveStaging nach %APPDATA%\Roaming\VertiGIS\WebOfficeAuthorStandalone\UIData\GoLiveStaging übernommen werden.

•Mit WebOffice 10.8 wird der WebOffice author standalone als 64-Bit-Anwendung ausgeliefert. Hierbei ist zu beachten, dass der ArcMap-Connector, welcher für die Verbindung zu MXDs zuständig ist, weiterhin als 32-Bit-Applikation ausgeliefert wird, da er auf dem 32-Bit-basierten ArcObjects basiert.

 

Beim Upgrade Ihrer bestehenden WebOffice Applikation von Version 10.7 nach 10.8 müssen Upgrades der einzelnen Softwarekomponenten durchgeführt werden. Dabei empfiehlt VertiGIS die Upgrade-Schritte in der folgenden Reihenfolge durchzuführen:

 

1.Sichern folgender Informationen

oSichern Sie Ihre WebOffice usermanagement Datenbank, indem Sie die User Management Datenbank: Exportieren.

oExportieren Sie Ihre WebOffice author standalone Anwendungsprofile aus den Einstellungen.

oWenn ein Update von Apache Tomcat durchgeführt werden soll, ist ein Backup des gesamten Apache Tomcat Ordners dringend zu empfehlen.

oSichern Sie die bestehenden WebOffice Anwendungen aus dem Verzeichnis C:\Tomcat\webapps\<WebOffice application> und kopieren diese an einen sicheren Ort.

oExportieren Sie WebOffice Konfigurationsdateien und kundenspezifisch angepasste Dateien mit Hilfe des Skripts im Verzeichnis WebOffice10.8-DVD/Software/Miscellaneous/Automatization/Export_WebOffice_Configurations_and_Customizing.bat.

Hinweis:

Mehr Details im Kapitel Kundenspezifische Dateien Exportieren.

 

2.Deinstallation WebOffice author standalone

Deinstallieren Sie WebOffice author standalone über Systemsteuerung\Programme\Programme und Features.

Hinweise: 

Mehr Details im Kapitel Upgrade WebOffice author standalone.

Mit WebOffice 10.8 ändert sich das Arbeitsverzeichnis des WebOffice author standalone. Um bestehende Profile weiterhin verwenden zu können, müssen diese vor der Deinstallation exportiert und nach Neuinstallation wieder importiert werden. Falls ein Stagingmapping zur Produktivnahme von Projekten verspeichert ist, müssen die entsprechenden .json-Files von %APPDATA%\Roaming\SynerGIS\WebOfficeAuthorStandalone\UIData\GoLiveStaging nach %APPDATA%\Roaming\VertiGIS\WebOfficeAuthorStandalone\UIData\GoLiveStaging übernommen werden.

 

3.Deinstallation WebOffice extensions

Deinstallieren Sie WebOffice extensions über Systemsteuerung\Programme\Programme und Features.        

Hinweise:

Mehr Details im Kapitel Upgrade WebOffice extensions.

WebOffice extensions können auch via Kommandozeile oder Bat-Datei deinstalliert werden. Siehe Kapitel WebOffice Extensions Silent Deinstallation.

Bei dieser Deinstallation müssen alle ArcGIS Desktop Anwendungen geschlossen sein.

 

4.Deinstallation WebOffice FTS-Index

Deinstallieren Sie WebOffice FTS-Index über Systemsteuerung\Programme\Programme und Features.

Hinweise:

Mehr Details im Kapitel Deinstallation von WebOffice FTS-Index.

Alle bisher berechneten FTS-Subindizes werden entfernt und müssen nach Installation der neuen WebOffice FTS-Index Version in der WebOffice Administrationsseite (Reiter Volltextsuche) neu berechnet werden.

 

5.Upgrade ArcGIS (optional)

VertiGIS empfiehlt ein Upgrade nach ArcGIS 10.8 oder die Installation der letztverfügbaren Patches für ArcGIS Desktop und ArcGIS Enterprise.

Hinweis:

Mehr Details im Kapitel Upgrade ArcGIS.

 

WebOffice 10.8 unterstützt folgende Versionen von Esri ArcGIS:

Unterstützte ArcGIS Versionen für WebOffice 10.8

 

Wird beim WebOffice-Upgrade auch ArcGIS von einer Version niedriger als 10.6 auf Version 10.6 oder höher aktualisiert, dann müssen bestehende benutzerdefinierte Esri-Print-Druckvorlagen von ArcMap-basierenden auf ArcGIS Pro-basierende Druckvorlagen (.pagx) geändert werden, d.h. das MXD in ArcGIS Pro öffnen, und Rechtsklick "Als Layoutfile speichern".

Hinweise:

Eine genaue Anleitung hierfür findet sich unter Migration von Layouttemplates nach ArcGIS Pro.

Details zur Verwendung von Esri Druck in WebOffice siehe Kapitel Esri Druck.

 

6.Installation WebOffice author standalone

Befolgen Sie die Schritte in Installation von WebOffice Author Standalone.

Hinweis:

Alternativ ist auch eine Quiet Installation der WebOffice author standalone möglich. Siehe Kapitel Quiet Installation.

 

VORSICHT:

Mit WebOffice 10.8 ändert sich das Arbeitsverzeichnis des WebOffice author standalone. Um bestehende Profile weiterhin verwenden zu können, müssen diese vor der Deinstallation exportiert und nach Neuinstallation wieder importiert werden. Falls ein Stagingmapping zur Produktivnahme von Projekten verspeichert ist, müssen die entsprechenden .json-Files von %APPDATA%\Roaming\SynerGIS\WebOfficeAuthorStandalone\UIData\GoLiveStaging nach %APPDATA%\Roaming\VertiGIS\WebOfficeAuthorStandalone\UIData\GoLiveStaging übernommen werden.

Mit WebOffice 10.8 wird der WebOffice author standalone als 64-Bit-Anwendung ausgeliefert. Hierbei ist zu beachten, dass der ArcMap-Connector, welcher für die Verbindung zu MXDs zuständig ist, weiterhin als 32-Bit-Applikation ausgeliefert wird, da er auf dem 32-Bit-basierten ArcObjects basiert. Bei Verwendung einer Oracle Datenbank wird dementsprechend auch ein 64bit Oracle Client Datenbanktreiber benötigt.

 

7.Installation WebOffice extensions

Befolgen Sie die Schritte im Kapitel Upgrade WebOffice extensions.

Hinweis:

Alternativ ist auch eine Quiet Installation der WebOffice extensions möglich. Siehe Kapitel WebOffice Extensions Silent Installation.

 

8.Installation VertiGIS Utilities Printing Tools (optional)

Befolgen Sie die Schritte im Kapitel VertiGIS Utilities Printing Tools (optional).

Hinweis: 

Seit WebOffice 10.7 gibt es zusätzlich zu den bereits bekannten WebOffice extensions Druckfunktionen eine BETA Version vom Geoprocessing (Python) basierten Drucken mit dem Namen VertiGIS Utilities.

 

9.Installation WebOffice FTS-Index (Volltextsuche)

WebOffice 10.8 verwendet WebOffice FTS-Index aktuell in der Version 8.5.

Befolgen Sie die Schritte im Kapitel Installation von WebOffice FTS-Index oder Installation von Solr Cloud in einem Loadbalancing-Szenario.

Hinweise:

Wenn WebOffice FTS-Index (standalone) bereits installiert war und Java auf eine aktuelle Version aktualisiert wurde, so muss vor der Installation von WebOffice FTS-Index die Systemvariable JAVA_HOME entsprechend angepasst werden (der Pfad zum Installationsverzeichnis von Java muss auf den Pfad der aktuellen Version geändert werden). Siehe dazu Abschnitt "Systemvariable JAVA_HOME setzen" im Kapitel Installation von WebOffice FTS-Index.

Nach der erfolgreichen Installation müssen alle FTS-Subindizes der Suchlayer in der WebOffice Administrationsseite (Reiter Volltextsuche) neu erstellt werden.

 

10. Installation WebOffice usermanagement Admin Web

Befolgen Sie die Schritte im Kapitel Upgrade UserManagement Admin Web.

Vorsicht:

Danach ist eine Aktualisierung der Usermanagement-Datenbank notwendig, um das Datenmodell auf die aktuelle Version zu heben. Öffnen Sie dazu die UserManagement Admin Web Seite im Browser und loggen Sie sich mit Ihrem Benutzer an; im Anschluss werden Sie aufgefordert das Datenmodell zu aktualisieren, wenn es nicht aktuell ist.

 

11. Aktualisierung Servlet-Engine (optional)

VertiGIS empfiehlt ein Update von Java und Apache Tomcat auf aktuelle (und von VertiGIS freigegebene) Versionen.

WebOffice 10.8 ist zertifiziert für die Versionen Java OpenJDK 11.0.7, Apache Tomcat 9.0.37 und Apache Tomcat Connector 1.2.48.

Hinweise:

VertiGIS empfiehlt die Verwendung von Java OpenJDK 11. Weitere Informationen zur verwendeten Version sowie Installation siehe Kapitel Java.

VertiGIS empfiehlt dringend ein Update auf die letztverfügbare, stabile Apache Tomcat Version. Weitere Informationen zur verwendeten Version sowie Installation siehe Kapitel Apache Tomcat.

 

Vorsicht:

Kontrollieren Sie nach einem Update von Apache Tomcat und bei Verwendung von Apache Tomcat Connector, ob ein lesender Zugriff für den lokalen User "IIS_IUSRS" auf Ordner \Tomcat\conf gesetzt ist.

Wenn Sie ein oder mehrere Sicherheitszertifikate im Java Truststore importiert haben, dann sollten Sie nach Aktualisierung von Java OpenJDK 11 die Sicherheitszertifikate in den Java Truststore des neuen Java Verzeichnis wieder importieren. Dies kann mit Hilfe der Funktion SSL-Zertifikate über SynAdmin importieren durchgeführt werden.

 

12. Aktualisierung Server Object Extension und WebOffice System Verzeichnis

Aktualisieren Sie die ArcGIS Server Object Extension für WebOffice wie folgt:

a.Wählen Sie im ArcGIS Server Manager unter Site/Erweiterungen die VertiGIS Server Object Extension (SOE) und bearbeiten Sie diese, indem Sie die aktuelle SOE-Datei (syn_soe_ao_gateway.soe Datei im Pfad WebOffice10.8-DVD\Software\ArcGIS for Server Object Extension) hochladen.

Vorsicht:

Beachten Sie in diesem Schritt, die SOE-Datei nur zu bearbeiten und nicht zu deinstallieren, da bei einer Neuinstallation die Eigenschaften der VertiGIS Server Object Extension wieder erneut konfiguriert werden müssen.

 

 

Hinweis:

Nach dem Austauschen der SOE-Datei sind das SynOutputService sowie alle anderen Services mit aktivierter Server Object Extension gestoppt. Diese Services müssen gestoppt bleiben, weil sonst der nächste Schritt nicht ausgeführt werden kann.

 

b.Ersetzen Sie die WebOffice-Dateien unter .\arcgisserver\directories\WebOfficeSystem mit den Dateien aus dem Verzeichnis WebOffice10.8-DVD\Software\WebOffice directories\WebOfficeSystem.

 

c.Starten Sie danach den Dienst SynOutputService wieder neu. Wenn Sie die SOE-Datei auch auf anderen Diensten aktiviert haben, müssen Sie auch diese Dienste wieder neu starten.

 

 

13. Upgrade WebOffice Applikation

Nachfolgend finden Sie die notwendigen Installationsschritte für die Aktualisierung der WebOffice Applikation:

a.Stoppen Sie den Dienst Apache Tomcat (über Start/Programme/Verwaltung/Dienste).

Hinweis:

Mehr Informationen dazu siehe Kapitel Apache Tomcat Wartung.

b.Löschen Sie das Apache Tomcat Arbeitsverzeichnis (.\Tomcat\work\Catalina\localhost\<WebOffice Anwendung>).

c.Entfernen Sie die bestehenden WebOffice Anwendungen (vorher Sicherungskopie machen!) aus dem Verzeichnis C:\Tomcat\webapps\<WebOffice application>.

Hinweis:

Bei einem Major Release Upgrade muss die gesamte WebOffice Applikation ausgetauscht werden.

d.Kopieren Sie die gezippte Datei der neuen WebOffice 10.8 Anwendung aus dem Verzeichnis der Installationskomponente WebOffice10.8-DVD\Software\WebOffice Web Application\unpackaged in Ihr WebOffice Anwendungsverzeichnis (z.B. C:\Tomcat\webapps\<WebOffice application>) und entpacken Sie die neue WebOffice 10.8 Applikation an dieser Stelle.

e.Kopieren Sie Ihre zuvor im Schritt 1 exportierten Konfigurationsdateien und kundenspezifischen Dateien aus Ihrem Backup-Verzeichnis in die neue WebOffice 10.8 Applikation.

Hinweis:

Nähere Details finden Sie im Kapitel Kundenspezifische Dateien Exportieren.

f.Starten Sie den Dienst Apache Tomcat (über Start/Programme/Verwaltung/Dienste).

g.Spielen Sie die neue WebOffice Lizenz ein.

Hinweis:

Nähere Details finden Sie im Kapitel Lizenzierung von WebOffice.

h.Starten Sie WebOffice author standalone und öffnen die Anwendungskonfiguration.

Hinweis:

Um keine Probleme zu erhalten, empfiehlt VertiGIS die Datei application_config.xml aus dem originalen Build der neuen WebOffice 10.8 Applikation zu benutzen. Sie müssen somit die korrekten Konfigurationen in der Anwendungskonfiguration erneut setzen.

i.Abschließend müssen alle Projektkonfigurationen in WebOffice author standalone mit Hilfe der Funktion Alle Projekte überprüfen auf das korrekte Versionsschema migriert werden. Falls ein oder mehrere Projekte ungültig sind, können die Projektkonfigurationen mit Hilfe des Buttons Projekte reparieren angepasst werden.

 

Hinweise: 

•Es wird empfohlen nach dem Update den Browsercache zu leeren.

•Bei Verwendung der JavaScript Clients WebOffice core Client und WebOffice flex Client kann es bei Verwendung eines Reverse Proxy zu Problemen in der Kartenbilddarstellung kommen, wenn im Code am Ende der Zeilen ProxyPass und ProxyPassReverse ein Forward Slash "/" gesetzt ist. In diesem Fall entfernen Sie bitte den Slash am Ende der Zeilen. Für mehr Details siehe Kapitel Apache Reverse Proxy.

•Falls Sie Probleme während oder nach dem WebOffice Update haben, kontaktieren Sie bitte das WebOffice Support Team.

 

14. Checks nach Upgrade

Überprüfen Sie nach dem erfolgten Upgrade alle WebOffice Applikationen und den darin enthaltenen Projekten anhand dieser Liste im Kapitel Checks nach einem Update.