Wie migriere ich die Tomcat-seitige Konfiguration eines BOC Produkts?
Problemstellung
Sie möchten eine neue Version Ihres BOC Produkts (ADONIS, ADOIT oder ADOGRC) selbstständig installieren und alle bisherigen Daten und Einstellungen migrieren.
Das grundsätzliche Vorgehen zur Migration ist in der Dokumentation der Neuerungen der jeweiligen BOC Produktversion beschrieben - die entsprechenden Links finden Sie am Ende dieser Seite. Die Migration von webserver-seitigen Daten und Einstellungen Ihres BOC Produkts kann jedoch zusätzliche Detailhinweise erfordern, die nachfolgend beschrieben sind.
Wichtig: Bitte beachten Sie, dass der Webserver Apache Tomcat für den Betrieb von BOC Produkten (ADONIS, ADOIT, ADOGRC) vorausgesetzt wird. Apache Tomcat ist kein Produkt der BOC Gruppe, sondern Software eines Drittanbieters. Die BOC Gruppe übernimmt keine Verantwortung für Installation, Konfiguration und Wartung von Drittanbieter-Software.
Ablauf der Migration webserver-seitiger Daten und Einstellungen
Führen Sie folgende Schritte durch, um wichtige webserver-seitige Daten und Einstellungen Ihres BOC Produkts zu übertragen.
Schritt | Beschreibung |
---|---|
1. | Applikationsserver und Webserver Services stoppen |
2. | Übertragen Sie die relevanten Einstellungen für ADONIS, ADOGRC oder ADOIT aus \<Tomcat Installationsverzeichnis> \ webapps \ <BOC Webclient-Produktordner> \ adoxx_web.properties |
3. | Übertragen Sie jede parametrische Abweichung von einer Standardinstallation auf den neuen Webserver (bsp. nachträgliche Änderungen in \<Tomcat Installationsverzeichnis> \ webapps \<BOC Webclient-Produktordner> \ WEB-INF \ web.xml) |
4. | Übertragen Sie folgende Ordner und Dateien von Ihrem bisherigen BOC Webclient-Produktordner auf den neuen BOC Webclient-Produktordner: |
BOC Webclient-Produktordner
Schritt | Beschreibung |
---|---|
4.a. | Ordner \<Tomcat Installationsverzeichnis> \ webapps \<BOC Webclient-Produktordner> \ WEB-INF \ registry \ collaboration |
4.b. | Ordner \<Tomcat Installationsverzeichnis> \ webapps \<BOC Webclient-Produktordner> \ WEB-INF \ registry \ upload |
4.c. | Ordner \<Tomcat Installationsverzeichnis> \ webapps \<BOC Webclient-Produktordner> \ WEB-INF \ registry \ auth |
4.d. | Ordner \<Tomcat Installationsverzeichnis> \ webapps \<BOC Webclient-Produktordner> \ WEB-INF \ registry \ rest |
4.e. | Datei \<Tomcat Installationsverzeichnis> \ webapps \<BOC Webclient-Produktordner> \ WEB-INF \ registry \ axw.ids |
Die Migration der webserver-seitigen Daten und Einstellungen für eine Standardinstallation ist damit abgeschlossen. Falls Ihre Installation vom Standard abweicht, kontaktieren Sie Ihren BOC Kundenbetreuer.
Beachten Sie auch die weiteren erforderlichen Migrationsschritte aus der Dokumentation der Neuerungen der betroffenen BOC Produktversion: News ADONIS, News ADOIT oder News ADOGRC.
Allgemeine Hinweise
Bitte beziehen Sie das OpenJDK für Ihre Umgebung als ZIP, um bei einem Upgrade das neue OpenJDK übergangsweise parallel betreiben zu können. So haben Sie im Notfall die Möglichkeit, noch auf die alte Version zurückwechseln zu können, um einen reibungslosen Betrieb sicherzustellen. Das trifft auch auf Ihre Apache Tomcat Installation zu.
Bitte legen Sie Zertifikate abseits vom Installationsordner ab (z.b C:\BOC\ADONIS\ oder C:\BOC\Tomcat\ oder C:\BOC\JAVA\ oder C:\BOC\Certificates). Abgelegte Zertifikate innerhalb des Installationsordners werden im Zuge von Updates fallweise überschrieben oder gelöscht.