(Version: 12/06/2024)
| Table of Contents |
|---|
...
Below you will find detailed instructions on how to proceed when updating the Income Taxes module (formerly known as GlobalTaxCenter, GTC) software. Please follow the order given below (first database and then deployment) when updating. A different order can lead to incorrect system behaviour after the update.
...
In addition, the following Java start parameters must be added to the Tomcat with the application "tomcat9w.exe" in the Tomcat/bin directory:
--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 | ||
|---|---|---|
| ||
Please note that the Tomcat 10 (due to the minimum requirement of the Servlet 5.0 API) cannot be used. |
...
that the Tomcat 10 (due to the minimum requirement of the Servlet 5.0 API) cannot be used. |
1.7) Tomcat: Adjusting the number of permitted parameters
Since version 9.0.80, Tomcat provides a value for the maxParameterCount parameter in the server.xml file that differs from the default value. This value is insufficient for the Income Taxes module. The character string 'maxParameterCount="1000"' must be removed from the connector entry.
Example:
<Connector port="8080" protocol="HTTP/1.1"connectionTimeout="20000"redirectPort="8443"maxParameterCount="1000"/>
What is the "maxParameterCount" parameter needed for?
The maxParameterCount parameter in Tomcat specifies the maximum number of request parameters that can be processed per request. This includes both GET and POST parameters. If a request contains more parameters than this value allows, the additional parameters are ignored.
1.8) Store database driver in Tomcat
If you already had a Income Taxes version 22.09.00 or newer installed, you can skip this step.
...
2. Place the driver in the directory "<Tomcat-Root>/lib".
1.
...
9) Configuration of the database connection in the Income Taxes module
Central in Tomcat (JNDI)
If you are already using the JNDI configuration, you can skip this step.
...
Please note that in this case both the file "repository_mssql.xml", "repository_mysql.xml" or "repository_oracle.xml" and the file "repository.xml" must be adapted in each deployment. Read the section "Update Deployment" for details.
1.
...
10) Path to Windows (optional)
If the Tomcat installation directory is not located on the drive of the Windows installation, the path to the Windows installation must be specified explicitly. To do this, the following entry is added to the Tomcat start parameters with the correct path:
-Dgtc.runtime.system32=<path to the system32 directory>
1.
...
11) Update SAPJCO (optional, for systems with a RfC connection to SAP)
The Income Taxes is working with a new SAPJCO version. Check with the department whether RfC interfaces are used in the Income Taxes in your company. If this is the case, you must carry out the following steps.
...
If you get any problems with this please contact our hotline.
1.
...
12) Update Kerberos SSO configuration (optional)
If single sign-on with Kerberos has been implemented in your installation, you must implement adjustments.
...
Kerberos-SSO when using Java 17
1.
...
13) Registering the module on the portal (optional)
The following configuration must only be carried out if ...
...
The URLs must always be specified with port, even if it is a standard port (e.g. 80 or 443).
1.
...
14) Registering the service module "Tax Data Hub" (optional)
The following configuration must only be carried out if ...
...