...
Im Folgenden erhalten Sie einen kurzen Überblickdetaillierte Anleitung, wie Sie beim Update der Software GlobalTaxCenter (GTC) vorgehen sollten.
Das Auslieferungspaket für die GTC-Anwendung besteht in der Regel aus einem Deployment (Verzeichnis mit Dateien, war-Datei, o.ä.).
Nachdem das Auslieferungspaket heruntergeladen wurde, können Sie mit der Installation beginnen.
Note |
---|
Bitte halten Sie die unten angegebene Reihenfolge bei der Aktualisierung ein. Eine andere Reihenfolge kann zu einem fehlerhaften Systemverhalten nach der Aktualisierung führen. |
Genauere Informationen zu den einzelnen Schritten erhalten Sie in den nachfolgenden Abschnitten.
1) Vorbereitende Maßnahmen
...
Sollte es notwendig sein, Inhalte im Paket anzupassen, muss die Datei vorher mit 7-zip entpackt werden. Alternativ benennen Sie die Datei gtc.war in gtc.zip um, dann können Sie den Windows-Explorer dafür verwenden.
1.6) SAPJCO aktualisieren (optional für Systeme mit einer RfC-Anbindung an SAP)
Das GTC arbeitet mit einer neuen SAPJCO-Version. Erkundigen Sie sich ggf. bei der Fachabteilung, ob in Ihrem Unternehmen RfC-Schnittstellen im GTC verwendet werden. Sofern dies der Fall ist, müssen Sie die folgenden Schritte durchführen.
...
Optional haben Sie die Möglichkeit die Aktualisierung der Datenbank manuell durch Skripte durchführen zu lassen. Die Skripte werden wir Ihnen auf Anfrage bereitstellen. Wir benötigen dafür die Versionsnummer des bereits installierten GTC. Im Abschnitt 3.2 wird darauf näher eingegangen.
3.1) Automatisches Update der Datenbank
Stellen Sie unbedingt sicher, dass eine aktuelle Sicherung der Datenbank verfügbar ist und diese im Bedarf wieder eingespielt werden kann.
...
Code Block | ||
---|---|---|
| ||
2021-09-16 14:39:43 [INFO ] ###################### Migration successful ###################### 2021-09-16 14:39:43 [INFO ] ScriptLocationPath: C:\Tomcat 9.0_GTC\webapps\ROOT\migration/sql 2021-09-16 14:39:43 [INFO ] ConfigLocationPath: C:\Tomcat 9.0_GTC\webapps\ROOT\migration/flywayConfig.properties 2021-09-16 14:39:43 [INFO ] CSVPlaceholderPath: C:\Tomcat 9.0_GTC\webapps\ROOT\migration/FlywayPlaceholders.csv 2021-09-16 14:39:44 [INFO ] ############################################ 2021-09-16 14:39:44 [INFO ] Current version: 20210705100000021_Insert TAUTORUNJOB MigrateUserDialogPresentation 2021-09-16 14:39:44 [INFO ] Pending Scripts: No pending scripts 2021-09-16 14:39:44 [INFO ] ############################################ |
3.2) Manuelles Update der Datenbank
Warning | ||
---|---|---|
| ||
Verwenden Sie zum Ausführen der Datenbankskripte einen Datenbankbenutzer, der volle Berechtigungen für das Datenbankschema hat. Andernfalls kann es vorkommen, dass Datenbanktabellen nicht korrekt erstellt oder aktualisiert werden können oder dass das GTC zur Laufzeit nicht korrekt auf die Tabellen zugreifen kann. Überprüfen Sie auf jeden Fall die Ergebnisse in den Protokolldateien, um festzustellen, ob es irgendwelche Anomalien gab. Sollten Sie einen Fehler feststellen, wenden Sie sich bitte an unsere Hotline. |
Wenn Sie die manuelle Aktualisierung nutzen, führen Sie bitte folgende Schritte aus:
...
- 01_MSSQL_xyz_abc.sql
- 02_Insert_Reporting_MSSQL.sql
- usw.
4) Finale Schritte
...
- Starten Sie den Web Application Server wie gewohnt über die Kommandozeile oder den Dienste-Manager. Beim Server-Start werden nun u. U. das Update der Datenbank und Autorun-Jobs durchgeführt. Diese sind Teil der Aktualisierung und müssen erfolgreich ausgeführt werden.
Warning Brechen Sie den Server-Start also nicht ab, auch wenn das Starten länger als gewöhnlich dauert. Kontaktieren Sie im Zweifelsfalle die Hotline. - Nach dem Start des 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.
- 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.
- Falls nach der Aktualisierung Fehler in der Webapplikation auftreten, kontaktieren Sie bitte ebenfalls die Hotline GlobalTaxCenter und senden die Log-Dateien mit.
...
- In der Test- und Produktivumgebung ist das GTC in der Version 20 22.00.01 installiert.
- Sie aktualisieren nun die Testumgebung mit der Version 2022.00.03.
- Ein paar Wochen später bekommen Sie ein neues Auslieferungspaket bereitgestellt und aktualisieren die Testumgebung. Diese hat nun die Version 2022.00.07.
- Die Produktivumgebung läuft immer noch mit der Version 2022.00.01.
- Sie erhalten von der Fachabteilung die Freigabe, das Produktivsystem auf Version 2022.00.07 zu aktualisieren.
- Sie müssen in jedem Fall im ersten Schritt die Skripte der Version 2022.00.03 einspielen, bevor Sie mit der Installation der Version 2022.00.07 fortfahren. Nur so können Sie verhindern, dass ein Schiefstand in der Datenbank entsteht.
...
"Host" und "Port" müssen passend zur durchgeführten TC-Installation eingegeben werden. Sofern die Web Service URL des TC nicht auf "eric" endet, muss der letzte Teil der URL (z.B. eric29) in der Verbindung in das Feld Parameter 1 eingegeben werden.
Kategorie | WebService |
---|---|
Name | eric |
Host | <http://ipOderDns> |
Port | <Port> |
Parameter 1 | <"eric..."> |
6.2) Proxy zwischen GTC und TransferClient (optional)
Der Proxy wird als separater Verbindungsparameter auf der Administrationsseite gepflegt.
Kategorie | Externes System |
---|---|
Name | atcProxy |
Host | <http://ipOderDns> |
Port | <Port> |
Benutzer | <UserName> |
Passwort | <Password> |
6.3) Verbindungstest zum TransferClient
...
Der Proxy wird als separater Verbindungsparameter auf der Administrationsseite gepflegt.
Kategorie | Externes System |
---|---|
Name | ericProxy |
Host | <http://ipOderDns> |
Port | <Port> |
Benutzer | <UserName> |
Passwort | <Password> |
Parameter 1 | <"Any"/"Basic"/"Digest"/"DigestIE"/"GSS"/"NTLM"> |
...