Versions Compared

Old Version 9

changes.mady.by.user Juergen Kalinski

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.

...

Table of Contents

...

Vorwort

Wir möchten Sie herzlich als Kunde Kunden des GlobalTaxCenter willkommen heißen.

Im Folgenden geben wir eine Kurzanleitung Anleitung zur erstmaligen Installation des GlobalTaxCenter unter Annahme einer Standardinstallation auf einem Tomcat-Applikationsserver. Falls sich Ihre Anforderungen für die Installation von den hier gemachten Annahmen unterscheiden,beraten  beraten wir Sie gern, um Ihnen die Integration des GlobalTaxCenter in Ihrem Unternehmen zu erleichtern.

Prüfung der Vorbedingungen

Datenbank

Eine Datenbank auf einem der folgenden Datenbankserver

...

Applikationsserver

  • Apache Tomcat 8
Warning

Die Versionen 8.0.41 und 8.5.11 enthalten laut Apache einen Bug. Diese Versionen sind nicht mit dem GlobalTaxCenter kompatibel.

  • Oracle Java JDK mindestens 1.8
  • JDBC Treiber für eine der folgenden Datenbanken:
    • Microsoft SQL Server 2012 oder neuer
    • (Oracle 12c)

...

Infrastruktur

Bitte prüfen Sie mit Hilfe des Dokuments Systemanforderungen, ob die bei Ihnen gegebene Infrastruktur aktuell ist. Sollte dies nicht der Fall sein, passen Sie die Infrastruktur bitte an, bevor Sie mit der GTC-Installation beginnen.

Installationsdateien

In Ihrem Auslieferungspaket sollten Sie nach dem Entpacken folgende Ordnerstruktur vorfinden:

  • Datenbankskripte

      ...

        • <„MSSql|Oracle-create.

      ...

        • sql-Skript“>
        • < ggf. weitere Skripte mit Nummerierung >
      • Deployment
      • gtc
        • Jsp
        • META_INF
        • WEB_INF
        • Static
        • <und weitere Ordner>
        • <gtc>.war

      Installation der Datenbank

      1. Die Schritte zur Einrichtung sind an dieser Stelle allgemein gehalten, um den unterschiedlichen Konfigurationen der Datenbanksysteme gerecht zu werden.
      2. Erstellen Sie eine neue Datenbank/Datenbankschema auf dem Datenbankserver.
      3. Erstellen Sie einen Datenbankbenutzer mit Berechtigung zum „INSERT“, „UPDATE“, „DELETE“, „ALTER“ auf diese Datenbank.
        1.  Unter SQL Server benötigt der Anwender die Datenbankrollen db_datareader, db_datawriter und ein Rolle zur Ausführung von Stored Procedures, z.B.: db_executor:
          CREATE ROLE db_executor
          GO
          GRANT EXECUTE TO db_executor
          GO
      4. Stellen Sie sicher, dass vom Applikationsserver aus mit diesem Benutzer auf die Datenbank zugegriffen werden kann. Wenn Sie den SQL Server mit Windows Authentisierung nutzen, muss der Tomcat-Dienst unter einem Domänen-Account laufen und dieser Domänen-Account in der Datenbank als User konfiguriert werden. Laden Sie aus dem Internet die sqljdbc_auth.dll des Microsoft JDBC-Treibers sqljdbc_6.2 herunter und kopieren Sie sie in das bin-Verzeichnis des Tomcat.
      5. Führen Sie die in Ihrer Auslieferung enthaltenen Skripte zur Erstellung der Datenbank auf dieser aus.
      6. Achten Sie darauf, dass der User, der die DB-Skripte einspielt, alle Rechte auf der Datenbank des GlobalTaxCenter hat.

      Installation des Web Application Servers

      Wir gehen im Folgenden von einer Installation auf einem Windows-Betriebssystem aus. Eine Installation auf einem Unix-artigenSystem artigen System unterscheidet sich lediglich in den Pfaden und dem unter 1) und 2) beschriebenen Installationsvorgang.

      Installation des JDK

      Installieren Sie

      ...

      ein passendes JDK und erstellen die Systemvariable „JAVA_HOME“, die auf das Installationsverzeichnis zeigt.

      Installation des "Tomcat 8.5"

      Installieren Sie Apache Tomcat 8.5 in ein Verzeichnis Ihrer Wahl. Im weiteren Verlauf wird das Verzeichnis „C:\Server\Tomcat“ angenommen.

              Dazu im Einzelnen:

      1. Wir empfehlen, die

      ...

      1. Einträge für das Startmenü zu installieren, um die Konfiguration zu vereinfachen.
      2. Die Ports, welche der Tomcat verwendet, können nach Ihren Anforderungen angepasst werden.

      Konfiguration des "Tomcat 8.5" nach der Installation

      ...

      1. Führen Sie nach der Installation die Applikation „->Startmenü->Tomcat->“configure tomcat“ aus.
      2. Führen Sie folgende Schritte durch:
        1. Tab „General“: Stellen Sie den Start des Dienstes auf automatisch.
        2. Tab „Java“: Im

      ...

        1. Feld „Java Options“ fügen Sie die

      ...

        1. Zeile „-Djava.security.auth.login.config=<Pfad und Dateiname der unter 1. kopierten JAAS.config>“

      ...

      Fügen Sie in gleichem Fenster die Zeilen ein:

        1. , "-XX:PermSize=256m

      ...

        1. " und "-XX:MaxPermSize=512m" ein
        2. Tab „Java“: Im

      ...

        1. Feld "Initial Memory Pool" tragen Sie „128“ ein

      ...

        2. Tab „Java“: Im

      ...

        1. Feld "Maximum Memory Pool" tragen Sie ca. die Hälfte des verfügbaren physikalischen Arbeitsspeichers ein. Bedenken Sie bitte

      ...

        1. bei 32-Bit-Systemen die Beschränkung des Arbeitsspeichers auf ca. 3

      ...

        1. ,5 GB. Die hier gemachten Speichereinstellungen beeinflussen die

      ...

        1. Performance und Lauffähigkeit der Applikation. Unter Umständen sind diese bei wachsender Benutzung im Laufe der Zeit anzupassen.

      ...

        Die Schritte zur

      Einrichtung

      ...

      1.  Unter SQL Server benötigt der Anwender die Datenbankrollen db_datareader, db_datawriter und ein Rolle zur Ausführung von Stored Procedures, z.B.: db_executor:
        CREATE ROLE db_executor
        GO
        GRANT EXECUTE TO db_executor
        GO

      ...

      Einrichtung der Applikation

      des GTC-Deployments

      Die folgenden Schritte richten die Webapplikation GlobalTaxCenter (GTC) auf dem "Tomcat 8.5"-Applikationsserver ein.

      1. Kopieren Sie den Ordner „gtc“ aus Ihrer Auslieferung in das „webapps“ und entpacken Sie die Datei „gtc.war“ aus dem Auslieferungspaket in das „\webapps“-Verzeichnis im Tomcat-Installationsverzeichnis. Sie können ihn das Paket selbstverständlich zunächst an einen anderen Ort editieren, um dort die Konfiguration vorzunehmen, und nach Fertigstellung nach „webapps“ kopieren„\webapps“ kopieren.
      2. Entnehmen Sie die Datei „<gtc>\WEB_INF\classes\JAAS.config“ aus der entpackten Verzeichnisstruktur und kopieren diese in das Installationsverzeichnis des Tomcat "C:\Server\Tomcat". Diese Datei wird später für die GTC-Authentifizierung benötigt.
      3. Nun konfigurieren Sie folgende Dateien unterhalb dieses Ordners:
        1. "\WEB_INF\classes\repository.xml":

      ...

        1.  suchen Sie die Zeile: <!ENTITY datasource SYSTEM "repository_mysql.xml"> und ersetzen Sie entsprechend Ihrer Datenbank „mysql“ ggf. durch „oracle“, „mssql“ oder „mssql_integratedSecurity“.
        2. "\WEB_INF\classes\repository_<dbms>.xml":

      ...

        1.  hier steht <dbms> für das

      ...

        1. im vorherigen Punkt gewählte Datenbanksystem. In dieser Datei passen Sie IP/Hostname des Datenbankservers, den Datenbanknamen und Benutzer/Passwort entsprechend den unter dem Punkt „Datenbank“ gewählten Parametern an.
        2. nur falls unter Punkt a die "\WEB_INF\classes\repository_mssql_integratedSecurity.xml

      ...

        1. " ausgewählt wurde: In dieser Datei passen Sie IP/Hostname des Datenbankservers und den Datenbanknamen an.

      ...

      Start und Aktivierung

      1. Starten Sie nun den Tomcat Applikationsserver entweder unter den Systemdiensten oder mit der „Configure Tomcat“ ApplikationStarten .
      2. Warten Sie bis der Server gestartet wurde.
      3. Öffnen Sie einen unterstützten Browser und geben folgendes in die Adressleiste ein (beachten Sie den bei „Installation Tomcat“ der Installation des Tomcats gewählten Port): "http://<IP-Adresse oder Hostname der Applikationsservers>:8080/gtc"
      4. Es sollte nun eine Login-Seite laden, dort können Sie sich – Benutzer: superuser ; Passwort: test – einloggen.
      5. Nun sollte eine Webseite Sie zur Aktivierung auffordern. Kopieren Sie den Inhalt des oberen Textfensters Textfelds "Seriennummer" in eine E-Mail und schicken Sie die Mail an Ihren Ansprechpartner aus unserem Haus. Alternativ können Sie den Button „Aktivierung anfordern“ klicken, der automatisch eine E-Mail automatisch erstellt.
      6. Wir schicken Ihnen die Aktivierung in Form einer Textdatei zu. Dessen Inhalt kopieren Sie bitte in das untere Textfenster Textfeld und bestätigen durch Klick auf „Aktivieren“.
      7. Sollte bei einem der vorherigen Punkte ein Fehler auftreten, prüfen Sie bitte die unter Einrichtung der Applikation eingetragenen Parameter und nehmen Kontakt mit uns auf.
      8. Überprüfen Sie abschließend die Inhalte der Log-Dateien "gtc_system.log" und "gtc_autorun.log" auf ERROR-Meldungen. Nehmen Sie bei Auffälligkeiten bitte ebenfalls Kontakt mit uns auf.#

      Abschließende Bemerkungen

      Nach erfolgter Aktivierung des GlobalTaxCenter ist die Installation erfolgreich abgeschlossen.

      ...

      1. Wir möchten empfehlen, eine regelmäßige Sicherung der Datenbank durchzuführen, da diese die Daten der Applikation enthält.
      2. Das Deployment muss nicht ständig gesichert werden. Hier reicht es, den Stand bei Auslieferung einer Version bereitzuhalten.
      3. Es können noch weitere Konfigurationen, z.B. in Bezug auf Passwortrichtlinien vorgenommen werden. Weitere Informationen hierzu finden Sie in den anderen Kapiteln des Benutzerhandbuchs.
      4. Die durchgeführte Konfiguration sollten Sie dokumentieren, damit Anpassungen im Falle von Aktualisierungen des Systems oder einer Wiederherstellung nachvollzogen werden können. Insbesondere Anpassungen, die abweichend von diesem Dokument vorgenommen wurden, sind zu beachtendokumentieren.