Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

(Stand: 12.06.2024)

Table of Contents

...

Im Folgenden erhalten Sie eine detaillierte Anleitung, wie Sie beim Update der Software Income Taxes (ehemals GlobalTaxCenter, GTC) vorgehen sollten. Bitte halten Sie die unten angegebene Reihenfolge bei der Aktualisierung ein. Eine andere Reihenfolge kann zu einem fehlerhaften Systemverhalten nach der Aktualisierung führen.

...

Tip
titleJava 17

Im Jahr 2022 haben wir das Produkt von Java 8 auf Java 17 umgestellt. Bitte stellen Sie daher sicher, dass ihr Tomcat 9 mit Java 17 läuft. Eine Anleitung, wie Java 17 installiert wird, können Sie über diesen Link abrufen.

Wenn die Java-Installation durchgeführt wurde, können Sie mit dem Update fortfahren.

1.2)

...

Tomcat 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.

...

--add-opens=java.desktop/java.awt.font=ALL-UNNAMED

Warning
titleKein Tomcat 10
Bitte beachten Sie, dass der Tomcat 10 (aufgrund der Mindestvoraussetzung der Servlet 5.0 API) nicht verwendet werden kann.

...

Kein Tomcat 10
Bitte beachten Sie, dass der Tomcat 10 (aufgrund der Mindestvoraussetzung der Servlet 5.0 API) nicht verwendet werden kann.

1.7) Tomcat: Menge der erlaubten Parameter anpassen

Seit der Version 9.0.80 liefert Tomcat in der Datei server.xml einen vom Standardwert abweichenden Wert für den Parameter maxParameterCount aus. Dieser Wert ist für das Modul Income Taxes unzureichend. Die Zeichenkette 'maxParameterCount="1000"' ist aus dem Connector-Eintrag zu entfernen.

Beispiel:

<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443"
maxParameterCount="1000"
/>

Wofür wird der Parameter "maxParameterCount" benötigt?

Der Parameter maxParameterCount in Tomcat legt die maximale Anzahl von Anfrageparametern fest, die pro Anfrage verarbeitet werden können. Dies umfasst sowohl GET- als auch POST-Parameter. Wenn eine Anfrage mehr Parameter enthält, als dieser Wert zulässt, werden die zusätzlichen Parameter ignoriert.

1.8) Tomcat: Datenbanktreiber hinterlegen

Wenn Sie bereits die Version 22.09.00 oder eine neuere Version im Einsatz haben, können Sie diesen Schritt überspringen.

...

2. Hinterlegen Sie den Treiber im Verzeichnis "<Tomcat-Root>/lib".

1.8) Tomcat: Konfiguration der Datenbankverbindung

Zentral im Tomcat (JNDI)

Wenn Sie bereits die JNDI-Konfiguration verwenden, können Sie diesen Schritt überspringen.

...

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.

...

10) Tomcat: 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.

...

11) 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.

  1. Laden Sie von der SAP-Support-Seite den passenden Connector für Ihr System herunter.
  2. 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.
  3. Entfernen Sie die alte "sapjco.dll". Diese kann in verschiedenen Verzeichnissen liegen, meistens im "system32"-Verzeichnis von Windows.
  4. Fügen Sie die neue "sapjco.dll" in das Verzeichnis "<Tomcat-root>/bin" ein.

1.

...

12) Kerberos-SSO aktualisieren (optional)

Sofern in Ihrer Installation Single-Sign-On mit Kerberos umgesetzt wurde, müssen Sie Anpassungen vornehmen.

...

Kerberos-SSO unter Java 17

1.

...

13) Registrierung des Moduls am Portal (optional)

Die folgende Konfiguration muss nur durchgeführt werden, wenn ...

...

Die URLs müssen immer mit Port angegeben werden, auch wenn es sich um einen Standard-Port (z.B. 80 oder 443) handelt.

1.

...

14) Registrierung des Servicemoduls "Tax Data Hub" (optional)

Die folgende Konfiguration muss nur durchgeführt werden, wenn ...

...