Verwendung unterschiedlicher WebOffice-Anwendungsstände

Dieses Kapitel umfasst die Einrichtung von zwei WebOffice-Anwendungsständen mit unterschiedlicher Version innerhalb eines Apache Tomcat Anwendungsservers. Dabei werden in diesem Kapitel alle notwendigen Schritte zur Einrichtung einer weiteren WebOffice-Anwendung mit unterschiedlichem Patchstand beschrieben. Zusätzlich werden noch ebenfalls die Schritte zur Anpassung möglicher anderer WebOffice Komponenten beschrieben.

 

icon_comment

Bei diesem Anwendungsszenario kann es vorkommen, dass die vorherige WebOffice-Anwendung nicht mehr vollständig kompatibel mit der Server Object Extension ist. Dies kann zu Problemen führen, falls Funktionen, welche über die Server Object Extension ausgeführt werden, nicht mehr ordnungsgemäß funktionieren (siehe dazu auch Kapitel Server Object Extension (SOE) - Alle Funktionalitäten). Dieses Szenario ist für Anwendungsständen mit unterschiedlichen Patchständen gedacht, welche dieselbe Versionsbasis haben.

icon_cross-reference

Sollten Fragen in Verbindung mit der Einrichtung und Verwendung von unterschiedlichen WebOffice-Anwendungsständen auftreten, können Sie sich an das WebOffice Support Team wenden.

Stoppen des Apache Tomcat Dienstes

Um eine weitere Anwendung hinzufügen zu können, muss der Anwendungsserver Apache Tomcat unter den Services bzw. Diensten in Windows beendet werden. Dieser Schritt ist ebenfalls mit Configure Tomcat möglich, falls dieses installiert ist.

Stoppen des Apache Tomcat Dienstes

Stoppen des Apache Tomcat Dienstes

Hinzufügen einer weiteren Anwendung in Apache Tomcat

Der erste Schritt zur Bereitstellung einer weiteren WebOffice-Anwendung mit unterschiedlichen Versionsstand ist das Hinzufügen einer neuen Anwendung in Apache Tomcat. Dabei muss die neue Anwendung auf Basis einer vollständigen WebOffice Installation erstellt werden.

Verzeichnis der Apache Tomcat Applikationen (Unterordner "webapps")

Verzeichnis der Apache Tomcat Applikationen (Unterordner "webapps")

 

Hinzufügen einer neuen Weboffice Applikation zum Apache Tomcat Applikationssever

Hinzufügen einer neuen Weboffice Applikation zum Apache Tomcat Applikationssever

 

icon_comment

Es darf zur Anlegung einer neuen Anwendung kein WebOffice Patch verwendet werden. Es muss dabei die Installation der gesamten WebOffice-Anwendung benutzt werden. Mehr Informationen zur Installation finden Sie unter Kapitel Installation der WebOffice-Anwendung. Für die Installation von weiteren WebOffice Patches finden Sie die Informationen im Kapitel Upgrade WebOffice.

icon_comment

Sollte eine neue Lizenz aufgrund von Versionsänderungen notwendig sein, muss die neue Lizenzdatei in das entsprechende Verzeichnis der neuen Anwendung (z.B. C:\Tomcat\webapps\WebOffice2\WEB-INF\classes\configuration\license) eingefügt werden oder über die WebOffice Administrationsseite (SynAdmin) eingespielt werden. Nähere Informationen zur Installation einer Lizenz finden Sie im Kapitel Lizenz Installation.

icon_cross-reference

Sollten Sie eine bestehende Version upgraden wollen, gehen Sie bitte wie im Kapitel Upgrade und dessen Subkapitel vor.

Erstellung eines eigenen WebOfficeSystem Ordner für die hinzugefügte Anwendung

Als nächstes muss ein zusätzliches WebOfficeSystem Verzeichnis unter dem ArcGIS Server Installations Verzeichnis (z.B. C:\arcgisserver\directories\WebOfficeSystem2) angelegt werden. Zusätzlich müssen die WebOffice System Dateien für die jeweilig eingesetzte Anwendungsversion in den Ordner kopiert werden. Dieser WebOffice System Ordner beinhaltet die zugehörigen Java Bibliotheken für die jeweilige eingesetzte WebOffice Version.

icon_cross-reference

Nähere Informationen zu diesem Thema siehe Kapitel WebOfficeSystem Daten am ArcGIS Server verteilen

 

Hinzufügen eines weiteren WebOffice System Ordner im ArcGIS Server Verzeichnis

Hinzufügen eines weiteren WebOffice System Ordner im ArcGIS Server Verzeichnis

 

Hinzufügen der WebOffice Systemdateien

Hinzufügen der WebOffice Systemdateien

 

icon_comment

Bitte vergewissern Sie sich, ob die beinhaltenden Dateien mit den Stand Ihrer WebOffice-Anwendung (z.B. 104.0.0.201604141935 des Ordner im Screenshot weist auf eine WebOffice 10.4 Anwendung hin) übereinstimmen.

Bereitstellung einer aktualisierten Server Object Extension

Bei unterschiedlichen WebOffice-Anwendungsständen muss die Server Object Extension immer mit der aktuelleren Version direkt am ArcGIS Server Manager aktualisiert werden. Die notwendigen Schritte zur Aktualisierung der Server Object Extension finden Sie im Readme eines Patches oder im folgenden Kapitel ArcGIS Server Object Extension für WebOffice installieren unter Editierung der Erweiterung.

Aktualisierung der Server Object Extension über den ArcGIS Server Manager

Aktualisierung der Server Object Extension über den ArcGIS Server Manager

Erstellung und Veröffentlichung eines weiteren SynOutputService

Zusätzlich zur Aktualisierung der Server Object Extension muss ein neues SynOutputService für die neu erstellte WebOffice-Anwendung angelegt werden. Dieses SynOutputService beinhaltet dann die volle Kompatibilität zu der Anwendung und ermöglicht die Benutzung von bestehenden bzw. neuen Funktionen im Bereich der WebOffice extensions.

 

Im ersten Schritt werden die Daten im Service Documents Verzeichnis (.\arcgisserver\directories\ServiceDocuments) vom Inhalt der WebOffice-DVD (WebOffice10.9R3-DVD\Software\WebOffice directories\ServiceDocuments) entsprechend kopiert und umbenannt (z.B. Verzeichnis SynOutputService104 bzw. SynOutputService104.mxd).

 

Duplizieren des SynOutputService.mxd für neue Applikation

Duplizieren des SynOutputService.mxd für neue Applikation

 

Anlegung eines weiteren Workspace

Anlegung eines weiteren Workspace

 

Im nächsten Schritt werden die beschriebenen Installationsschritte auf Basis der neuen Dateien (z.B. Verzeichnis SynOutputService104 bzw. SynOutputService104.mxd) zur Veröffentlichung des weiteren SynOutputService entsprechend des Kapitels SynOutputService publizieren durchgeführt.

 

Erstellung eines weiteren SynOutputService im ArcGIS Server Manager

Erstellung eines weiteren SynOutputService im ArcGIS Server Manager

 

Zusätzlich muss der Pfad bei der Registerkarte Allgemein in den Eigenschaften der Server Object Extension im ArcGIS Server Manager entsprechend des neu erstellten WebOfficeSystem Ordners angepasst werden (z.B. C:\arcgisserver\directories\WebOfficeSystem104\syn_soe_ao_gateway.json).

 

Anpassung der Handler configuration im ArcGIS Server Manager

Anpassung der Handler configuration im ArcGIS Server Manager

Aktualisierung von WebOffice author

Bei unterschiedlichen WebOffice-Anwendungsständen wird empfohlen, dass der WebOffice author auf die letzte Version aktualisiert wird. Die Aktualisierung des WebOffice author wird in folgendem Kapitel Upgrade WebOffice author beschrieben. Generell kann immer nur WebOffice author auf einer Maschine installiert werden. Falls zwei Anwendungen mit unterschiedlichen Versionsständen (z.B. Version 10.5 bzw. 10.6) gleichzeitig im Einsatz sind, kann es passieren, dass Änderungen im WebOffice usermanagement aufgrund der Inkompatibilität der jeweiligen WebOffice author Version auftreten. Um dies zu umgehen, installieren Sie sich auf einer anderen Maschine eine kompatible Version für die Benutzerverwaltung und verbinden Sie sich auf die entsprechende WebOffice-Anwendung über einen UNC Pfad in den Einstellungen.

icon_comment

Generell sind aber neuere WebOffice author Versionen zur Bearbeitung von älteren WebOffice Projekten kompatibel.

Aktualisierung der WebOffice Extension

Um die generelle Kompatibilität gewährleisten zu können, sollte immer die aktuellste WebOffice Extension installiert werden. Sollte keine aktuellere verfügbar sein, so kann dieser Schritt übersprungen werden. Nähere Informationen zur Aktualisierung der WebOffice Extension finden Sie im Kapitel Upgrade WebOffice extensions.

Installation einer weiteren bzw. aktualisierten WebOffice Benutzerverwaltung

Diesen Schritt kann übersprungen werden, sollte kein WebOffice usermanagement im Einsatz sein. Sollte es unterschiedliche Versionen der Benutzerverwaltung zwischen den WebOffice-Anwendungsständen geben, muss eine weitere Benutzerverwaltungsapplikation installiert werden. Dabei können mehrere WebOffice Benutzerverwaltungen parallel installiert werden. Sollte es keine unterschiedlichen Versionen der Benutzerverwaltung geben, kann die derzeit installierte Benutzerverwaltung genutzt werden.

 

Anlegung eines weiteren <%Usermangement%>

Anlegung eines weiteren <%Usermangement%>

 

Generell wird im Ordner des IIS (z.b. C:\inetpub\wwwroot) eine neue Anwendung unter anderem Namen angelegt (z.B. UserManagementAdminWeb104). Zusätzlich wird danach ein Virtuelles Verzeichnis im IIS hinzufügt, welches auf den Pfad der neu angelegten Benutzerverwaltungsapplikation zeigt. Danach wird dieses in eine Anwendung konvertiert.

 

icon_cross-reference

Mehr Details zur Installation von WebOffice usermanagement siehe Kapitel WebOffice Benutzerverwaltung (Anwendungsserver) und dessen Unterkapitel.

icon_comment

Es wird empfohlen für jede Benutzerverwaltungsapplikation einen eigenen Anwendungspool einzurichten, da manche Versionen unterschiedliche Anwendungspool Voraussetzungen haben.

Eine bestehende Datenbank ist immer nur mit dem Schema der verknüpften Benutzerverwaltung gültig. Es besteht die Möglichkeit das Benutzerverwaltungsdatenbankschema auf die neueste Version upzugraden. Bei einem Parallelbetrieb unterschiedlicher Benutzerverwaltungsapplikationen wird empfohlen eine neue Datenbank für die neu erstellte Benutzerverwaltungsapplikation zu erstellen und die bereits bestehende UM-Datenbank zu exportieren und in die neue zu importieren. Danach kann das Schema mithilfe des Benutzerverwaltungs Upgrade Assistenten auf die neueste Version gehoben werden (siehe Kapitel Erstellen einer Benutzerverwaltungsdatenbank).

 

Der jeweilig installierte WebOffice author ist immer nur mit der jeweilig kompatiblen Benutzerverwaltung kompatibel. Sollte eine nicht kompatible Version des WebOffice author für die im Profil spezifizierte Benutzerverwaltungsdatenbank angegeben sein, kommt es zu der folgenden Hinweismeldung:

 

Hinweismeldung bei Inkompatibilität von WebOffice Author und Benutzerverwaltung

Hinweismeldung bei Inkompatibilität von WebOffice Author und Benutzerverwaltung

 

icon_comment

Der WebOffice author kann nur einmalig am System installiert werden. Die Verwaltung einer anderen Weboffice Version muss gegebenenfalls über einen anderen Rechner mit installiertem WebOffice author erfolgen.

Erstellung eines weiteren WebOffice FTS-Index

Falls bereits eine Volltextsuche in der kopierten Anwendungskonfiguration definiert ist, müssen die folgenden Schritte entsprechend durchgeführt werden. Um die Volltextsuche der neuen WebOffice 10.9 R3 Anwendung zu verwenden, muss ein weiteres WebOffice FTS-Index eingerichtet werden. Die notwendigen Schritte zur Einrichtung finden Sie im Kapitel Einrichten mehrerer Cores im WebOffice FTS-Index.

icon_warning

ACHTUNG!

Das Szenario zur Benutzung eines WebOffice FTS-Index für mehrere WebOffice Anwendungen wird von VertiGIS GmbH jedoch NICHT EMPFOHLEN! EIN WebOffice FTS-Index sollte nur von EINER WebOffice Anwendung verwendet werden.

(Optional) Anpassung bei den Einstellungen des Apache Tomcat Connector

Nähere Informationen zur Anpassung der Einstellungen des Apache Tomcat Connector finden Sie im Kapitel Erstellung von weiteren WebOffice-Anwendungen.

Anpassung des Internet Informations Server (IIS)

Nähere Informationen zur Erstellung eines neuen Ausgabeverzeichnis im IIS finden Sie im Kapitel Erstellung von weiteren WebOffice-Anwendungen.

Anpassung der Grundeinstellungen bzw. Profile im WebOffice author

Nähere Informationen zur Anpassung der Einstellungen im WebOffice author finden Sie im Kapitel Erstellung von weiteren WebOffice-Anwendungen.

Anpassung der Anwendungskonfiguration im WebOffice author

Nähere Informationen zur Anpassung bzw. Konfiguration des neuen Ausgabeverzeichnis in der WebOffice 10.9 R3 Anwendungskonfiguration finden Sie im Kapitel Erstellung von weiteren WebOffice-Anwendungen.

Ⓒ Copyright 2023 by VertiGIS GmbH