Upgrade WebOffice 10.9 R2 SP1 nach 10.9 R3
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.
|
ACHTUNG! •Beachten Sie in Verwendung von WebOffice 10.9 R3 die Kompatibilität zur Basissoftware von Esri ArcGIS: oArcGIS 2021 (ArcGIS Enterprise 10.9.1, ArcMap 10.8.2, ArcGIS Pro 2.9.x) ist der letzte von WebOffice unterstützte ArcGIS Release. oArcGIS 2022 (ArcGIS Enterprise 11.x, ArcGIS Pro 3.x) wird in zukünftigen WebOffice Versionen nicht unterstützt. •VertiGIS empfiehlt die Esri Produktversionen ArcGIS Desktop (ArcMap) 10.8.2 und ArcGIS Enterprise 10.9.1, da es sich hierbei um Long Term Releases von Esri Inc. handelt. Weiter wird empfohlen ArcGIS Pro 2.9.x zu verwenden. •Für die Installation der WebOffice extensions und WebOffice usermanagement ist mindestens Windows .NET Framework 4.8 erforderlich. Siehe dazu auch Microsoft .NET-Framework. •WebOffice 10.9 R3 unterstützt die in den Serverseitige Voraussetzungen gelisteten ArcGIS Versionen sowie die in den Clientseitige Voraussetzungen angeführten Browserversionen. •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. |
|
•WebOffice 10.9 R3 wird mit ArcGIS Maps SDK for JavaScript 4.27 (früher bekannt unter ArcGIS API for JavaScript 4.27) freigegeben. •Der JDBC-Treiber für MS SQL Server hat ein Update auf die Version 11.2.0 erfahren. Deshalb ist es von Bedeutung, beim DB-Verbindungsparameter zusätzlich ;trustServerCertificate=true hinten dranzuhängen (z B. jdbc:sqlserver://hostsde;DatabaseName=MyDatabase;trustServerCertificate=true). |
Beim Upgrade Ihrer bestehenden WebOffice Anwendung nach Version 10.9 R3 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
1.Sichern Sie Ihre WebOffice usermanagement Datenbank, indem Sie die Benutzerverwaltungsdatenbank: Exportieren.
2.Optional: Exportieren Sie die Konfigurationsdateien und kundenspezifischen Dateien aus Ihrer WebOffice-Anwendung.
|
Nähere Details finden Sie im Kapitel Kundenspezifische Dateien Exportieren. |
3.Optional: Exportieren Sie Ihre WebOffice author standalone Anwendungsprofile aus den Einstellungen.
4.Optional: Wenn mehrere WebOffice FTS-Index Cores verwendet werden, können diese vor der Deinstallation von WebOffice FTS-Index weggesichert werden und nach Neuinstallation wieder verwendet werden.
|
Nähere Details finden Sie im Kapitel Mehrere Cores im WebOffice FTS-Index einrichten. |
5.Optional: Wenn ein Update von Apache Tomcat durchgeführt werden soll, ist ein Backup des gesamten Apache Tomcat Ordners zu empfehlen.
6.Wichtig: Sichern Sie die bestehenden WebOffice Anwendungen aus dem Verzeichnis C:\Tomcat\webapps\<WebOffice application> und kopieren diese an einem sicheren Ort.
2. Deinstallation WebOffice author standalone
Deinstallieren Sie WebOffice author standalone über Systemsteuerung\Programme\Programme und Features.
|
Mehr Details im Kapitel Upgrade WebOffice author standalone. |
|
Seit Version WebOffice 10.8 hat sich das Arbeitsverzeichnis des WebOffice author standalone geändert. 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.
|
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 VertiGIS Studio Printing Engine
Falls VertiGIS Studio Printing Engine installiert ist, deinstallieren Sie diese über Systemsteuerung\Programme\Programme und Features.
|
Mehr Details zum Upgrade im Kapitel Installation mit Setup sowie allgemeine Informationen zu VertiGIS Studio Printing Engine im Kapitel VertiGIS Studio Printing Engine. |
5. Deinstallation WebOffice FTS-Index
Deinstallieren Sie WebOffice FTS-Index über Systemsteuerung\Programme\Programme und Features.
|
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. |
6. Optional: Aktualisierung Servlet-Engine (Neuinstallation von Java und Tomcat)
VertiGIS empfiehlt ein Update von Java und Apache Tomcat auf aktuelle (und von VertiGIS freigegebene) Versionen.
|
•WebOffice 10.9 R3 ist zertifiziert für die Versionen Java JDK 11.0.23+9, Apache Tomcat 9.0.88 und Apache Tomcat Connector 1.2.49. •VertiGIS empfiehlt hierbei die Verwendung von Java Eclipse Temurin by Adoptium. •Wenn eine Neuinstallation von Apache Tomcat durchgeführt werden soll, ist ein Backup des gesamten Apache Tomcat Ordners dringend zu empfehlen. |
Deinstallieren Sie zunächst die installierten Versionen von Apache Tomcat und anschließend Java JDK11.
|
•Für eine Neuinstallation von Java folgen Sie die Schritte im Kapitel Java. •Für eine Neuinstallation von Apache Tomcat folgen Sie die Schritte im Kapitel Apache Tomcat installieren. •Nach einer Neuinstallation von Apache Tomcat und gleichzeitiger Verwendung von Apache Tomcat Connector müssen gegebenfalls die Connector-Dateien neu in das Verzeichnis Tomcat\conf verteilt werden. Beachten Sie dafür das Kapitel Installation des Apache Tomcat Connector. |
|
ACHTUNG! •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. |
7. Optional: Upgrade ArcGIS
|
ACHTUNG! •VertiGIS empfiehlt die Esri Produktversionen ArcGIS Desktop (ArcMap) 10.8.2 und ArcGIS Enterprise 10.9.1, da es sich hierbei um Long Term Releases von Esri Inc. handelt. Weiters wird empfohlen ArcGIS Pro 2.9.x zu verwenden. •Vergewissern Sie sich VOR einem Update von ArcGIS Desktop (ArcMap als auch ArcGIS Pro) sowie ArcGIS Enterprise, dass die WebOffice extensions und WebOffice author standalone zuvor sauber deinstalliert worden sind! Fahren Sie erst danach mit dem Update von ArcGIS Desktop bzw. ArcGIS Enterprise fort. Wird dieser Schritt vergessen, und es treten Probleme bei der Deinstallation des WebOffice author standalone auf, kann das Kapitel Probleme beim Deinstallieren des Author Standalone Abhilfe schaffen. |
|
•Seit WebOffice 10.9 SP2 und ArcGIS Desktop 10.8.2 wird ArcGIS Enterprise 10.9.1 wieder vollumfänglich unterstützt. Das Spezielle Installationsszenario enfällt in diesem Fall, da alle Komponenten wieder auf einer einzelnen Maschine (Single-Server-Szenario) installiert werden können. •Bei Verwendung der VertiGIS Studio Printing Engine mit ArcGIS 10.8.1 ist die Installation von Patch ArcGIS Server 10.8.1 Print Service Patch und ArcGIS Server 10.8.1 Print Service and Text Element Patch notwendig! |
|
Mehr Details im Kapitel Upgrade ArcGIS. |
WebOffice 10.9 R3 unterstützt folgende Versionen von Esri ArcGIS:
Wird beim WebOffice-Upgrade auch ArcGIS von einer Version niedriger als 10.6 auf eine höhere ArcGIS Version aktualisiert, dann müssen bestehende benutzerdefinierte VertiGIS-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.
|
Eine genaue Anleitung hierfür findet sich unter Migration von Layouttemplates nach ArcGIS Pro. Details zur Verwendung vom Werkzeug VertiGIS Printing in WebOffice siehe Kapitel VertiGIS Printing. |
8. Installation WebOffice author standalone
Befolgen Sie die Schritte in Installation von WebOffice Author Standalone.
|
ACHTUNG! Vergewissern Sie sich VOR einem Update von ArcGIS Desktop (ArcMap als auch ArcGIS Pro) sowie ArcGIS Enterprise, dass die WebOffice extensions und WebOffice author standalone zuvor sauber deinstalliert worden sind! Fahren Sie erst danach mit dem Update von ArcGIS Desktop bzw. ArcGIS Enterprise fort. Wird dieser Schritt vergessen, und es treten Probleme bei der Deinstallation des WebOffice author standalone auf, kann das Kapitel Probleme beim Deinstallieren des Author Standalone Abhilfe schaffen. |
|
Alternativ ist auch eine Quiet Installation der WebOffice author standalone möglich. Siehe Kapitel Quiet Installation. |
9. Installation WebOffice extensions
Befolgen Sie die Schritte im Kapitel Upgrade WebOffice extensions.
|
ACHTUNG! •Falls nach dem Upgrade weiterhin Probleme mit den WebOffice extensions auftreten, hilft es die vorhandenen GeoOffice Komponenten auf der Maschine zu deinstallieren, danach die WebOffice extensions mit der Reparaturoption neu zu installieren und anschließend den Server neu zu starten. •Für die Installation ist mindestens Windows .NET Framework 4.8 erforderlich. |
|
Alternativ ist auch eine Quiet Installation der WebOffice extensions möglich. Siehe Kapitel WebOffice Extensions Silent Installation. |
10. Installation VertiGIS Studio Printing Engine (optional)
Befolgen Sie die Schritte im Kapitel VertiGIS Printing.
|
ACHTUNG! •Seit Version WebOffice 10.9 R2 ändert sich der Name des Geoverarbeitungsservice für VertiGIS Studio Printing Engine: •Dies bedeutet nach einem Upgrade von einer älteren Version zur aktuellsten Version, dass im WebOffice author standalone in allen Projektkonfigurationen, in der VertiGIS Studio Printing Engine Tool konfiguriert ist, die GP-Service URL gegebenfalls anzupassen ist; für mehr Details siehe Als Werkzeug in WebOffice konfigurieren. |
|
•Zusätzlich zu den bereits bekannten WebOffice extensions Druckfunktionen bietet WebOffice ein auf Geoprocessing (Python) basiertes Drucken mit dem Namen VertiGIS Studio Printing Engine an. Daher ist diese Installation eine optionale Möglichkeit. •Zur Verwendung der VertiGIS Studio Printing Engine wird mindestens ArcGIS 10.8.1 benötigt. VertiGIS empfiehlt jedoch ausdrücklich die Esri Produktversionen ArcGIS Desktop (ArcMap) 10.8.2 und ArcGIS Enterprise 10.9.1, da es sich hierbei um Long Term Releases von Esri Inc. handelt. Weiters wird empfohlen ArcGIS Pro 2.9.x zu verwenden. •Auf Grund bekannter technischer Limitierungen kann eine fehlerlose Installation sowie Verwendung von VertiGIS Studio Printing Engine auf ArcGIS 10.8.1 und älteren Versionen nicht mehr gewährleistet werden. •Bei Verwendung der VertiGIS Studio Printing Engine mit ArcGIS 10.8.1 ist die Installation von Patch ArcGIS Server 10.8.1 Print Service Patch und ArcGIS Server 10.8.1 Print Service and Text Element Patch zwingend notwendig! |
11. Installation WebOffice FTS-Index (Volltextsuche)
WebOffice 10.9 R3 verwendet WebOffice FTS-Index aktuell in der Version 9.3.0.
Befolgen Sie die Schritte im Kapitel Installation von WebOffice FTS-Index oder Installation von Solr Cloud in einem Loadbalancing-Szenario.
|
•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. |
12. Installation WebOffice usermanagement Admin Web
Befolgen Sie die Schritte im Kapitel Upgrade UserManagement Admin Web.
|
ACHTUNG! •Für die Installation ist mindestens Windows .NET Framework 4.8 erforderlich. Siehe dazu auch Microsoft .NET-Framework. •Danach ist eine Aktualisierung der Benutzerverwaltungsdatenbank 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. |
13. Aktualisierung Server Object Extension (SOE) und WebOffice System Verzeichnis
Aktualisieren Sie die ArcGIS Server Object Extension für WebOffice wie folgt:
1.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.9R3-DVD\Software\ArcGIS for Server Object Extension) hochladen.
|
ACHTUNG! 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. |

Aktualisieren der Server Object Extension (SOE) im ArcGIS Server Manager
|
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. |
2.Ersetzen Sie die WebOffice-Dateien unter .\arcgisserver\directories\WebOfficeSystem mit den Dateien aus dem Verzeichnis WebOffice10.9R3-DVD\Software\WebOffice directories\WebOfficeSystem.

WebOffice-Dateien im WebOfficeSystem Verzeichnis aktualisieren
3.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.

SynOutputService im ArcGIS Server Manager starten
14. Aktualisierung WebOffice Anwendung
Nachfolgend finden Sie die notwendigen Installationsschritte für die Aktualisierung der WebOffice Anwendung:
1.Stoppen Sie den Dienst Apache Tomcat (über Start/Programme/Verwaltung/Dienste).
|
Mehr Informationen dazu siehe Kapitel Apache Tomcat Wartung. |
2.Löschen Sie das Apache Tomcat Arbeitsverzeichnis (.\Tomcat\work\Catalina\localhost\<WebOffice Anwendung>).
3.Entfernen Sie die bestehenden WebOffice Anwendungen (vorher Sicherungskopie machen!) aus dem Verzeichnis C:\Tomcat\webapps\<WebOffice application>.
|
Bei einem Major Release Upgrade muss die gesamte WebOffice-Anwendung ausgetauscht werden. |
4.Kopieren Sie die gezippte Datei der neuen WebOffice 10.9 R3 Anwendung aus dem Verzeichnis der Installationskomponente WebOffice10.9R3-DVD\Software\WebOffice Web Application\unpackaged in Ihr WebOffice Anwendungsverzeichnis (z.B. C:\Tomcat\webapps\<WebOffice application>) und entpacken Sie die neue WebOffice 10.9 R3 Anwendung an dieser Stelle.
5.Kopieren Sie Ihre zuvor im Abschnitt 1 exportierten Konfigurationsdateien und kundenspezifischen Dateien aus Ihrem Backup-Verzeichnis in die neue WebOffice 10.9 R3 Anwendung.
|
Nähere Details finden Sie im Kapitel Kundenspezifische Dateien Exportieren. |
6.Starten Sie den Dienst Apache Tomcat (über Start/Programme/Verwaltung/Dienste).
7.Spielen Sie die neue WebOffice 10.9 R3 Lizenz ein.
|
Nähere Details finden Sie im Kapitel Lizenzierung von WebOffice. |
8.Starten Sie WebOffice author standalone und öffnen die Anwendungskonfiguration - gegebenenfalls muss die Anwendungskonfiguration einmal neu abgespeichert werden.
9.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.

Funktion "Alle Projekte prüfen" im WebOffice author standalone
|
•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. |
15. Checks nach Upgrade
Überprüfen Sie nach dem erfolgten Upgrade alle WebOffice Anwendungen und den darin enthaltenen Projekten anhand der Liste im Kapitel Checks nach einem Update.