Versions Compared

Old Version 12

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 Tax Transfer Hub 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:

...

-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
nameTomcat_start

Start

  1. Start the Tomcat application server on which you have installed the service module, either under System Services or with the "Configure Tomcat" application.

  2. Wait until the server has started.

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

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