...
1.5) Download das Auslieferungspakets
| Excerpt | ||
|---|---|---|
| ||
Laden Sie über den Link, der Ihnen in der Bereitstellung-Mail mitgeteilt wurde, das Installationspaket herunter. Legen Sie es in einem temporären Ordner ab. Das Deployment-Paket stellen wir Ihnen als war-Datei zur Verfügung. 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) Tomcat auf Java 17 umstellen
Wenn Sie bereits die Version 22.09.00 oder eine neuere Version im Einsatz haben, können Sie diesen Schritt überspringen.
...
Zusätzlich sind dem Tomcat mit der Anwendung "tomcat9w.exe" im Tomcat/bin-Verzeichnis die folgenden Java-Startparameter hinzuzufügen:
--add-opens=java.base/java.util=ALL-UNNAMED
--add-opens=java.base/java.lang.reflect=ALL-UNNAMED
--add-opens=java.base/java.text=ALL-UNNAMED
--add-opens=java.desktop/java.awt.font=ALL-UNNAMED
| Warning | ||
|---|---|---|
| ||
| Bitte beachten Sie, dass der Tomcat 10 (aufgrund der Mindestvoraussetzung der Servlet 5.0 API) nicht verwendet werden kann. |
...
2. Hinterlegen Sie den Treiber im Verzeichnis "<Tomcat-Root>/lib".
1.8)
...
Die Software arbeitet mit einer neuen SAPJCO-Version. Erkundigen Sie sich ggf. bei der Fachabteilung, ob in Ihrem Unternehmen RfC-Schnittstellen in diesem Produkt verwendet werden. Sofern dies der Fall ist, müssen Sie die folgenden Schritte durchführen.
- Laden Sie von der SAP-Support-Seite den passenden Connector für Ihr System herunter.
- Tauschen Sie, falls vorhanden, die Datei "sapjco3{*}.jar" aus dem Verzeichnis "<Tomcat-root>/lib" mit der heruntergeladenen "sapjco3{*}.jar" aus. Ist keine "sapjco3{*}.jar" vorhanden, genügt es die neue Datei einzufügen.
- Entfernen Sie die alte "sapjco.dll". Diese kann in verschiedenen Verzeichnissen liegen, meistens im "system32"-Verzeichnis von Windows.
- Fügen Sie die neue "sapjco.dll" in das Verzeichnis "<Tomcat-root>/bin" ein.
1.9) Kerberos-SSO aktualisieren (optional)
Sofern in Ihrer Installation Single-Sign-On mit Kerberos umgesetzt wurde, müssen Sie Anpassungen vornehmen.
Mit Java 17 wird schwache Kerberos-Authentifizierung nicht mehr offiziell unterstützt. Detaillierte Informationen zur Konfiguration haben wir in diesem Kapitel zusammengetragen.
1.10) Konfiguration der Datenbankverbindung
Zentral im Tomcat (JNDI)
Wenn Sie bereits die JNDI-Konfiguration verwenden, können Sie diesen Schritt überspringen.
Das bisherige Standard-Deployment sah vor, dass die Datenbankverbindung bei jeder Auslieferung in der zur Datenbank passenden repository-Datei kundenspezifisch angepasst wurde. Dieser Prozess ist nun dahingehend vereinfacht, dass das Standard-Deployment mit der JNDI-Datasource "gtcdatasource" konfiguriert ist. Hierzu muss kundenseitig einmalig pro Tomcat die Datei context.xml im Tomcat/conf-Verzeichnis erweitert werden, indem die JNDI-Datasource dort innerhalb des context-Tags definiert wird. Die Verwendung der JNDI-Konfiguration hat den Vorteil, dass die Datenbank-Verbindung nicht mehr innerhalb des Deployments angepasst werden muss.
| Code Block | ||||
|---|---|---|---|---|
| ||||
<Resource auth="Container" driverClassName="oracle.jdbc.driver.OracleDriver"
maxTotal="20" maxIdle="10" maxWaitMillis="-1" name="jdbc/gtcdatasource" username="root" password="test"
type="javax.sql.DataSource" url="jdbc:oracle:thin:@hostname:1521/gtc"
/> |
Bei Verwendung des Microsoft SQL-Servers sind hierbei Angaben zur Verschlüsselung (encrypt) und zur Vertrauenswürdigkeit (trustServerCertificate) des Server-Zertifikats zu machen:
| Code Block | ||||
|---|---|---|---|---|
| ||||
<Resource auth="Container" driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
maxTotal="20" maxIdle="10" maxWaitMillis="-1" name="jdbc/gtcdatasource" username="root" password="test"
type="javax.sql.DataSource" url="jdbc:sqlserver://hostname:1433;DatabaseName=...;encrypt=...;trustServerCertificate=..."
/> |
Im Falle des Microsoft SQL-Servers empfiehlt AMANA zudem eine Installation mit Integrated Security, bei der keine Angaben zu Username und Password in der context.xml hinterlegt werden müssen. Für die Datenbankverbindung wird stattdessen der Account verwendet, unter dem der Tomcat-Dienst ausgeführt wird.
Innerhalb des Deployments
Anstelle einer JNDI-Datasource kann die Datenbankverbindung wie bisher in der zur Datenbank passenden repository-Datei konfiguriert werden.
...
Konfiguration der Datenbankverbindung
Zentral im Tomcat (JNDI)
Wenn Sie bereits die JNDI-Konfiguration verwenden, können Sie diesen Schritt überspringen.
Das bisherige Standard-Deployment sah vor, dass die Datenbankverbindung bei jeder Auslieferung in der zur Datenbank passenden repository-Datei kundenspezifisch angepasst wurde. Dieser Prozess ist nun dahingehend vereinfacht, dass das Standard-Deployment mit der JNDI-Datasource "gtcdatasource" konfiguriert ist. Hierzu muss kundenseitig einmalig pro Tomcat die Datei context.xml im Tomcat/conf-Verzeichnis erweitert werden, indem die JNDI-Datasource dort innerhalb des context-Tags definiert wird. Die Verwendung der JNDI-Konfiguration hat den Vorteil, dass die Datenbank-Verbindung nicht mehr innerhalb des Deployments angepasst werden muss.
| Code Block | ||||
|---|---|---|---|---|
| ||||
<Resource auth="Container" driverClassName="oracle.jdbc.driver.OracleDriver" name="jdbc/gtcdatasource" username="root" password="test"
type="javax.sql.DataSource" url="jdbc:oracle:thin:@hostname:1521/gtc"
maxTotal="200" maxIdle="10" maxWaitMillis="20000" timeBetweenEvictionRunsMillis="10000" testWhileIdle="true" removeAbandonedOnBorrow="true"
/> |
Bei Verwendung des Microsoft SQL-Servers sind hierbei Angaben zur Verschlüsselung (encrypt) und zur Vertrauenswürdigkeit (trustServerCertificate) des Server-Zertifikats zu machen:
| Code Block | ||||
|---|---|---|---|---|
| ||||
<Resource auth="Container" driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver" name="jdbc/gtcdatasource" username="root" password="test"
type="javax.sql.DataSource" url="jdbc:sqlserver://hostname:1433;DatabaseName=...;encrypt=...;trustServerCertificate=..."
maxTotal="200" maxIdle="10" maxWaitMillis="20000" timeBetweenEvictionRunsMillis="10000" testWhileIdle="true" removeAbandonedOnBorrow="true"
/> |
Im Falle des Microsoft SQL-Servers empfiehlt AMANA zudem eine Installation mit Integrated Security, bei der keine Angaben zu Username und Password in der context.xml hinterlegt werden müssen. Für die Datenbankverbindung wird stattdessen der Account verwendet, unter dem der Tomcat-Dienst ausgeführt wird.
Innerhalb des Deployments
Anstelle einer JNDI-Datasource kann die Datenbankverbindung wie bisher in der zur Datenbank passenden repository-Datei konfiguriert werden.
Bitte beachten Sie, dass in diesem Fall in jedem Deployment sowohl die Datei "repository_mssql.xml", "repository_mysql.xml" oder "repository_oracle.xml" als auch die Datei "repository.xml" angepasst werden müssen. Lesen Sie im Abschnitt "Deployment aktualisieren" die Details dazu.
1.9) Pfadangabe zu Windows (optional)
Sofern sich das Tomcat-Installationsverzeichnis nicht auf dem Laufwerk der Windows-Installation befindet, muss der Pfad zur Windows-Installation explizit angegeben werden. Dazu wird in den Tomcat-Startparametern der folgende Eintrag mit der korrekten Pfadangabe ergänzt:
-Dgtc.runtime.system32=<Pfadangabe zum system32-Verzeichnis>
1.10) SAPJCO aktualisieren (optional, für Systeme mit einer RfC-Anbindung an SAP)
Die Software arbeitet mit einer neuen SAPJCO-Version. Erkundigen Sie sich ggf. bei der Fachabteilung, ob in Ihrem Unternehmen RfC-Schnittstellen in diesem Produkt verwendet werden. Sofern dies der Fall ist, müssen Sie die folgenden Schritte durchführen.
- Laden Sie von der SAP-Support-Seite den passenden Connector für Ihr System herunter.
- Tauschen Sie, falls vorhanden, die Datei "sapjco3{*}.jar" aus dem Verzeichnis "<Tomcat-root>/lib" mit der heruntergeladenen "sapjco3{*}.jar" aus. Ist keine "sapjco3{*}.jar" vorhanden, genügt es die neue Datei einzufügen.
- Entfernen Sie die alte "sapjco.dll". Diese kann in verschiedenen Verzeichnissen liegen, meistens im "system32"-Verzeichnis von Windows.
- Fügen Sie die neue "sapjco.dll" in das Verzeichnis "<Tomcat-root>/bin" ein.
1.11) Kerberos-SSO aktualisieren (optional)
Sofern in Ihrer Installation Single-Sign-On mit Kerberos umgesetzt wurde, müssen Sie Anpassungen vornehmen.
Mit Java 17 wird schwache Kerberos-Authentifizierung nicht mehr offiziell unterstützt. Detaillierte Informationen zur Konfiguration haben wir in diesem Kapitel zusammengetragen.
1.12) Registrierung des Moduls am Portal (optional)
Die folgende Konfiguration muss nur durchgeführt werden, wenn ...
- Sie die Anwendung in der GTC Suite betreiben (in der Tabelle TSYSTEM steht der Eintrag "USE_SSO" auf dem Wert "12") und
- Sie bisher eine Version älter als 22.16.04 im Einsatz hatten.
Bisher wurden die Parameter zur Registrierung in der Datenbank in der Tabelle TPORTALCONNECTION gepflegt. Ab sofort wird die Registrierung des Moduls am Portal direkt mit Tomcat-Startparametern vorgenommen.
Die folgenden Parameter sind in jedem Fall notwendig:
-Dincometaxes.url.base=<URL des Moduls>
-Dincometaxes.url.portal=<URL des Portals>
Optional um eine andere API-Adresse anzugeben:
-Dincometaxes.url.api=<URL der API des Moduls>
Optional für die statische Registrierung notwendig (wenn das Modul und das Portal auf einem Tomcat installiert sind):
-Dincometaxes.clientId=<Zeichenfolge aus dem Portal - ClientId>
-Dincometaxes.clientSecret=<Zeichenfolge aus dem Portal - ClientSecret>
Hinweis:
Die URLs müssen immer mit Port angegeben werden, auch wenn es sich um einen Standard-Port (z.B. 80 oder 443) handelt.
1.13) Registrierung des Servicemoduls "Tax Data Hub" (optional)
Die folgende Konfiguration muss nur durchgeführt werden, wenn ...
- Sie die Anwendung in der GTC Suite betreiben (in der Tabelle TSYSTEM steht der Eintrag "USE_SSO" auf dem Wert "12") und
- Sie auf das Servicemodul "Tax Data Hub" zugreifen möchten.
Erstellen Sie einen API-Key für das Servicemodul "Tax Data Hub" und fügen Sie diesen als Startparameter im Tomcat ein. Wie Sie dabei vorgehen müssen, ist im verlinkten Kapitel erläutert.
2) Deployment aktualisieren
...
| 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 die Anwendung 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:
...
- 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 die Anwendung 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 Suite 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 Suite und senden die Log-Dateien mit.
...