...

...

Foreword

We like to welcome you as a client of the GlobalTaxCenter.

...

If your installation requirements differ from the assumptions made here, we will be happy to consult you on how to facilitate the integration of the GlobalTaxCenter in your company.

Preconditions

Data base

A database on one of the following database servers

• Oracle 9i, 10g, 11, 12
• Microsoft SQL Server
2018 (R2)/2012 (R2
• 2012 or later
  
  
• (Oracle 12c)

Application server

• Apache Tomcat 7 or 8

• Oracle Java JDK at least 1.8
• JDBC driver for one of the following databases:
  • MySQL 5.x (http://www.mysql.com/products/connector/j)
  • Oracle 9i, 10g, 11 (http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/)
  • Microsoft SQL Server
  2008(R2) (http://msdn.microsoft.com/data/jdbc
  • 2012 or later
  • (Oracle 12c)

The following folder structure should appear in your delivery after unpacking:

...

• deployment
  • gtc
    • Jsp
    • META_INF
    • WEB_INF
    • Static
    • <and further folders>

Tomcat installation

In the following we assume an installation on a Windows operating system.

...

• We recommend to install the start menu entries to simplify the configuraton.
• The ports used by Tomcat can be customized to your needs.

Configuration after installation

1. Unpack the delivery and extract the file "JAAS.config" in the folder "WEB_INF\classes\" and copy it into the installation directory of Tomcat (C:\serverServer\tomcat).
2. After installation , execute the application "→ start menu → tomcat → "configure tomcat".
3. Perform the following steps:

                Tab "General": Set the start starting-option of the service to automatic

...

                "-Djava.security.auth.login.config=<path and filename of JAAS.config>" (which you copied under in Step 1.)

                Insert the lines in the same window:

...

             These may have to be adjusted over time as the use of the product increases.

Database

1. The steps for setting up the database are kept general at this point in order to do justice to satisfy the different configurations of the database systems.
2. Create a new database/database scheme on the database server.
3. Create a database user with permission to "INSERT", "UPDATE", "DELETE", "ALTER" on this database.
4. Make sure that the database can be accessed from the application server with this user. If you use the SQL Server with windows authentication, the Tomcat service must execute under a domain account and this domain account must be configured as a user in the database.
   Download the sqljdbc_auth.dll of the Microsoft JDBC driver sqljdbc_6.2 from the internet and copy it to the bin directory of Tomcat.
5. Execute the scripts included in your shipment to create the database on it.
6. Make sure that the user who imports the DB scripts has all rights on the GlobalTaxCenter database.

Application setup

The following steps set up the GlobalTaxCenter web application on the Tomcat application server.

...

          here <dbms> stands for the database system selected under 1above. In this file you adjust the IP/ host name of the database server, the database name and the user/ password according to the parameters selected under "Database"

...

         In this file, you adjust the IP/ host name of the database server and the database name.

System start und activation

1. Now start the Tomcat application server either under System Services or with the "Configure tomcat" application.
2. Start a browser and enter in the address bar (note the port selected in "Install Tomcat"): http://<IP adress or hostname of the application server>:8080/gtc
3. It should now load a login page, where you can log in - user: superuser ; password: test.
4. Now a website should ask you for activation. Copy the contents of the upper text window into an e-mail and send it to your contact person from our company. Alternatively, you can click the "Request activation" button, which automatically creates an e-mail.
5. We will send you the activation in the form of  a text file. Please copy its content into the text window below and confirm by clicking on "Activate".
6. If an error should occur with one of the previous points, please check the parameters entered under setup of the application and contact us.

Concluding remark

After the GlobalTaxCenter has been activated, the installation is sucessfully completed.

...