Versions Compared

Old Version 11

changes.mady.by.user ANI

Saved on

compared with

New Version Current

changes.mady.by.user ANI

Saved on

Key

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

...

In the following we provide instructions for the initial installation of the Tax Data Hub on a Tomcat application server. If your requirements for the installation differ from the assumptions made here, we will be happy to advise you to facilitate the integration of the Tax Data Hub in your company.

Tax Data Hub 24.1.1 and newer

If you want to install version 24.1.1 (or newer) of Tax Data Hub, please install Tomcat 10.1.

In this case, please read the linked instructions.

Checking the preconditions - infrastructure

...

Excerpt
nameTomcat_Config

Configuration of the "Tomcat 9"

Memory

  1. After installation, run the application "->Startmenu->Tomcat->"configure tomcat" and perform the following steps:

    1. Tab "General": Set the start of the service to automatic.

    2. Tab "Java": Enter "512" in the field "Initial Memory Pool".

    3. Tab "Java": In the field "Maximum Memory Pool" enter approximately half of the available physical memory. For example, 2048 for 4096 MB RAM. For 32-bit systems, please bear in mind the limitation of the working memory to approx. 3.5 GB. The memory settings made here affect the performance and runability of the application. They may need to be adjusted over time as usage increases.

HTTPS

Make the necessary connector settings in the „D:\Server\Tomcat\lib\server.xml" configuration file to ensure communication via https. A reference to a valid key store for identifying the module to other applications must be maintained.

Connection to the database

Database driver

Copy the database driver that matches your database server into the "\lib" directory in the Tomcat installation directory.

  1. Microsoft SQL Server - https://docs.microsoft.com/en-us/sql/connect/jdbc/microsoft-jdbc-driver-for-sql-server

Configuration

Configure the database connection as a JNDI connection in Tomcat:

...

Excerpt
namewindows_auth_db

Windows authentication

(Optional for Microsoft SQL Server)

From the JDBC driver package, the appropriate “*.dll”-file must also be copied from the folder “auth” into the directory “System32” of the system.
Example path: .\sqljdbc_8.2.2.0_deu\sqljdbc_8.2\deu\auth\x64\mssql-jdbc_auth-8.2.2.x64.dll

  1. The Windows user must be entered in Tomcat

    1. The user needs permissions on the server of the Tomcat to run the Tomcat service as well as write permissions in the Tomcat folder for logs.

    2. The user needs permissions on the database server.

    3. The user needs the above-mentioned permissions on the database schema.

      Image RemovedImage Added

  2. The connections in the context.xml must correspond to this example:

...

-Dtaxdatahub.url.base=<URL of the module Tax Transfer Data Hub>

-Dtaxdatahub.url.portal=<URL of the module Portal>

...

-Dtaxdatahub.url.api=<API URL of the module Tax Transfer Data Hu>

Optionally required for static registration (if the module and the portal are installed on one Tomcat):

...

Info

The URLs must always be specified with port, even if it is a standard port (e.g. 80 or 443).

Communication with other GTC Suite modules (API key)

For secure communication with other modules in the GTC Suite, an API key has to be generated. You can access the documentation via this link.

Deployment setup

The following steps set up the Tax Data Hub module on the "Tomcat 9" application server.

...

Excerpt
nameself-signed_Certificates

Use of Self-Signed Certificates

If you have integrated a self-signed TLS/SSL certificate in Tomcat, it can happen that HTTP requests from the Tax Data Hub this module to other modules cannot be carried out. In this case, enter the following parameter in the "Java Options" field in Tomcat. This explicitly allows the use of self-signed certificates in the application. This configuration is generally not recommended for productive systems.

-Dtaxdatahub.api.allowSelfSignedCertificat=true

Excerpt
nameTomcat_start

Start

  1. Start the Tomcat application server on which you have installed the

...

  1. service module, either under System Services or with the "Configure Tomcat" application.

  2. Wait until the server has started.

...

Open a supported browser and enter the following in the address bar (note the port selected when installing the Tomcat): "http://:/taxdatahub".

...

  1. Whether the service module has been configured correctly and is accessible from other modules can be checked via the module view of the portal. To do this, log in to the portal with administration rights and click on Modules in the Administration tab.

  2. The service module appears in the list and is indicated by a green traffic light. If the traffic light is yellow, check the connection properties to see whether the corresponding paths have been maintained correctly and check whether the https connection has been maintained correctly.

Excerpt
nameremarks

Concluding remarks

The software can now be handed over to the departments for use or professional testing.

Finally, a few comments:

  • We would like to recommend that you make a regular backup of the database, as this contains the data of the application.

  • The deployment does not have to be backed up constantly. Here it is sufficient to have the status ready when a version is delivered.