...
- Entfernen Sie die Datei "sapjco3{*}.jar" aus dem Deployment-Verzeichnis "<gtc-root>/lib".
Die nachfolgenden Schritt sind einmalig durchzuführen: - Entfernen Sie ggf. die Datei "sapjco3{*}.jar" aus dem Verzeichnis "<Tomcat-root>/lib".
- Aus lizenzrechtlichen Gründen dürfen wir Ihnen diese Dateien nicht zum Download anbieten oder im Paket verteilen. Laden Sie von das SAP-Support-Seite die Dateien "sapjco3*.dll" bzw. "libsapjco3.so" sowie "sapjco3{*}.jar" herunter.
- Tauschen Sie die dll- bzw. so-Datei aus. (Die Windows-dll wird meistens im system32-Ordner abgelegt.)
Legen Sie die heruntergeladene "sapjco3{*}.jar"-Datei im Verzeichnis "<Tomcat-root>/lib" ab. Die Datei darf nicht umbenannt werden.
2) Datenbank aktualisieren
Es stehen zwei Varianten für die Aktualisierung der Datenbank zur Verfügung. Neben der manuellen Aktualisierung, die im Folgenden beschrieben wird, gibt es nun auch die Möglichkeit, die Aktualisierung der Datenbank automatisch beim Serverstart durchführen zu lassen. Im Abschnitt 4 wird darauf näher eingegangen.
Wenn der Auslieferung SQL-Skripte beiliegen, führen Sie bitte folgende Schritte aus:
- Starten Sie das SQL Server Management Studio ihres Datenbank-Servers und wählen sie das Datenbank-Schema aus, das zur GTC-Applikation gehört.
- Führen Sie die mitgelieferten SQL-Update-Skripte in Sortierreihenfolge der Dateinamen bzw. Versionen auf diesem Schema aus. Nutzen Sie einen Benutzer, der volle Rechte auf der Datenbank hat.
Beispiel:
- 01_MSSQL_8.3.02_8.4.04.sql
- 02_Insert_Reporting_MSSQL.sql
- usw.
| Warning | ||
|---|---|---|
| ||
Nutzen Sie für das Einspielen der Datenbank-Skripte einen Benutzer, der volle Rechte auf dem Datenbank-Schema besitzt. Sonst kann es passieren, dass Tabellen nicht korrekt angelegt oder aktualisiert werden können oder das GTC zur Laufzeit nicht ordnungsgemäß auf die Tabellen zugreifen kann. Prüfen Sie in jedem Fall die Ergebnisse im Protokoll, ob Auffälligkeiten gegeben sind. Bei Fehlern wenden Sie sich bitte an die Hotline GlobalTaxCenter. |
...
2) Deployment aktualisieren
| Info | ||
|---|---|---|
| ||
| Es ist auch möglich, von AMANA ein Powershell-Script zur automatischen Aktualisierung des GTC zu erhalten. Der ausführende User muss Administrationsberechtigung besitzen. |
...
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. Im einzelnen:
| Warning | ||
|---|---|---|
| ||
Kopieren Sie nicht einfach die repository.xml-Dateien aus dem alten GTC-Deployment in das neue Deployment. Dies kann zu Fehlern führen, da sich der Inhalt der repository-Dateien mit der Zeit leicht verändern kann. |
...
Falls weitere Anpassungen am Deployment bekannt sind (z.B. in der Datei "web.xml"), übertragen Sie diese bitte auch durch Editieren der jeweiligen Datei.
...
3)
...
Bevor das automatische Update eingeschaltet wird, muss die Applikation prüfen, ob die Vorbedingungen für das Update erfüllt sind. Öffnen Sie die Datei <Tomcat>/<GTC>/WEB-INF/web.xml. Suchen Sie den Parameter check-db-migration-state und ändern Sie den Wert auf true. Wenn der Tomcat nun mit der neu ausgelieferten WAR-Datei gestartet wird, überprüft eine interne Routine die Datenbank.
Anschließend öffnen Sie die Logdatei "gtc_dbMigration.log" und überprüfen diese auf Meldungen. Sofern die Vorbedingungen erfüllt sind, können Sie im Prozess fortfahren, ansonsten führen Sie das Datenbank-Update manuell durch.
...
Datenbank aktualisieren
Es stehen zwei Varianten für die Aktualisierung der Datenbank zur Verfügung.
Im Standard erhalten Sie ein Auslieferungspaket ohne Datenbankskripte mit eingestellter automatischer Datenbankaktualisierung.
Optional haben Sie die Möglichkeit die Aktualisierung der Datenbank manuell durch Skripte durchführen zu lassen. Die Skripte können wir Ihnen auf Anfrage bereitstellen. 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.
Zur Aktualisierung der Datenbank sind keine weiteren Schritte notwendig. Beim Start der Anwendung unter Punkt 5) wird das Update der Datenbank automatisch durchgeführt.
Achtung: Die Applikation aktualisiert ohne weitere Abfrage die Datenbank. Bitte prüfen Sie danach unbedingt die Logdatei "gtc_dbMigration.log" auf Fehler.
Im Erfolgsfalle wird dies im Log durch folgende Meldung angezeigt:
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
Wenn Sie die manuelle Aktualisierung nutzen, führen Sie bitte folgende Schritte aus:
- Starten Sie das DBMS ihres Datenbank-Servers und wählen sie das Datenbank-Schema aus, das zur GTC-Applikation gehört.
- Führen Sie die mitgelieferten SQL-Update-Skripte in Sortierreihenfolge der Dateinamen bzw. Versionen auf diesem Schema aus. Nutzen Sie einen Benutzer, der volle Rechte auf der Datenbank hat.
Beispiel:
- 01_MSSQL_xyz_abc.sql
- 02_Insert_Reporting_MSSQL.sql
- usw.
5) Finale Schritte
- Starten Sie den Web Application Server wie 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. 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 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.
- 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.
...
Haben Sie das GTC-Modul Tax Return erworben, beinhaltet die Auslieferungsmail auch immer das Installationspaket für das Modul TransferClient. Jedoch ändert sich nicht zwangsläufig mit jeder GTC-Bereitstellung auch die TC-Version. Um unnötige Aufwände auf Ihrer Seite zu vermeiden, prüfen Sie daher bitte vor dem Update, ob sich die bereits installierte TC-Version und die in der Mail bereitgestellte Version unterscheiden. Die Versionsnummer (=Dateiversion) der installierten TC-Version können Sie in den Eigenschaften der Datei TransferClient.exe einsehen:
Unterscheiden sich die beiden TC-Versionen, installieren Sie neue TC-Version bitte mit Hilfe der hier verlinkten Anleitung. Bei der Installation notieren Sie bitte die Web-Service-URL, da diese später im GTC-Administrationsbereich hinterlegt bzw. aktualisiert werden muss.
...