...

1) Vorbereitende Maßnahmen

1.1) Web Application Server stoppen

1. Stoppen Sie den Web Application Server (z.B. Tomcat) wie gewohnt über die Kommandozeile oder den Dienste-Manager.
2. Löschen Sie den Inhalt des Verzeichnisses „work“ der Tomcat-Installation.

1.2) Datenbank-Backup durchführen

Sie sollten in einem ersten Schritt zuerst ein Datenbank-Backup erstellen, welches wiederhergestellt (Rollback) werden kann, falls das Update fehlschlagen sollte. Informationen, wie dies durchgeführt werden kann, entnehmen Sie bitte dem Benutzerhandbuch Ihres Datenbank-Management-Systems.

1.2) Web Application Server stoppen

...

.

...

...

1.3) Altes Deployment sichern

...

3) Deployment aktualisieren

Manuell:

Kopieren Sie das neue Deployment in das Unterverzeichnis "\webapps", also "<Installationsverzeichnis Tomcat>\webapps\gtc\". Gegebenenfalls müssen Sie das zipWAR-Archiv mit 7-zip entpacken. Alternativ benennen Sie die Datei gtc.war zu gtc.zip um, dann können Sie den Windows-Explorer dafür verwenden.

Analog zur bisher installierten GTC-Version, muss dem neuen Deployment bekannt gemacht werden, mit welcher Art von Datenbank es sich verbinden soll. Dazu wird in der zentralen "<gtc-root>\WEB_INF\classes\repository.xml"-Datei ein Verweis auf die richtige Datenbank (MySql, Oracle, MS SQL) angelegt. Danach müssen die Verbindungsparameter in der jeweiligen repository_<xyz>.xml aktualisiert werden.

...

Falls weitere Anpassungen am Deployment bekannt sind (z.B. in der Datei "web.xml"), übertragen Sie diese bitte auch durch Editieren der jeweiligen Datei.

Halbautomatisch, bspw bei fehlender Datenbankberechtigung:

Sie können in der web.xml die Einstellung use-db-migrations auf "true" stellen, damit das GTC die Datenbank beim Start selbstständig aktualisiert. Eine Überprüfung der Datenbank kann mit einem "true" beim Parameter check-db-migration-state angestoßen werden, ohne dass use-db-migrations an sein muss. Bitte prüfen Sie dann das Log gtc_dbMigration.log auf Fehler.

Sollte die Überprüfung erfolgreich verlaufen, können Sie db-auto-migration auf "true" stellen und die Application updated ohne weitere Abfrage die Datenbank.

Automatisch:

Es ist auch möglich, von uns ein Powershell-Script zur Automatischen Aktualisierung des GTC zu erhalten. Der ausführende User muss Administrationsberechtigung haben.

4) Finale Schritte

1. Starten Sie den Web Application Server wie gewohnt über die Kommandozeile oder den Dienste-Manager. Beim Server-Start werden nun u.U. Autorun-Jobs durchgeführt. Diese sind Teil der Aktualisierung und müssen erfolgreich ausgeführt werden. Brechen Sie den Server-Start also nicht ab, auch wenn das Starten länger als gewöhnlich dauert.
2. Nach dem Start des WAS-Servers testen Sie den Zugriff auf das GlobalTaxCenter oder informieren Sie Ihre zuständige Fachabteilung, um den Zugriff testen zu lassen, falls Sie selbst keine Zugangsdaten für das GTC haben.
3. Wechseln Sie (oder ein berechtigter Vertreter) im Bereich Stammdaten in den Dialog Administration und dort in den Reiter Log und öffnen Sie die Datei "gtc_autorun.log". Prüfen Sie, ob die Autorun-Jobs erfolgreich durchgelaufen sind oder ob Fehlermeldungen angezeigt werden. Im Fehlerfall wenden Sie sich bitte an die Hotline GlobalTaxCenter und schicken die Log-Dateien "gtc_autorun.log" und „gtc_system.log“ mit.
4. Falls nach der Aktualisierung Fehler in der Webapplikation auftreten, kontaktieren Sie bitte ebenfalls die Hotline GlobalTaxCenter und senden die Log-Dateien mit.

...

1. In der Test- und Produktivumgebung ist das GTC in der Version 19 20.00.01 installiert.
2. Sie aktualisieren nun die Testumgebung mit der Version 1920.00.03.
3. Ein paar Wochen später bekommen Sie ein neues Auslieferungspaket bereitgestellt und aktualisieren die Testumgebung. Diese hat nun die Version 1920.00.07.
4. Die Produktivumgebung läuft immer noch mit der Version 1920.00.01.
5. Sie erhalten von der Fachabteilung die Freigabe, das Produktivsystem auf Version 1920.00.07 zu aktualisieren.
6. Sie müssen in jedem Fall im ersten Schritt die Skripte der Version 1920.00.03 einspielen, bevor Sie mit der Installation der Version 1920.00.07 fortfahren. Nur so können Sie verhindern, dass ein Schiefstand in der Datenbank entsteht.

...