Versions Compared

Key

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

...

  1. Führen Sie nach der Installation die Datei "tomcat8w.exe" im bin Verzeichnis des Tomcats aus.
  2. Führen Sie folgende Schritte durch:
    1. Tab „General“: Stellen Sie den Start des Dienstes auf automatisch.
    2. Falls Sie die automatische Datenbankmigration aus den Applikationen nutzen wollen, fügen Sie bitte zusätzlich folgende Parameter im Feld "Java Options" ein:
      1. "-Datp.db.migration=auto" für das Portal
      2. "-Ddac6.db.migration=auto" für DAC 6
    3. Wenn Sie den TransferService von AMANA für die automatische Übertragung der Meldung an die Finanzverwaltung nutzen möchten, ist ein zusätzlicher Parameter notwendig.
      Dieser Parameter aktiviert den regelmäßigen Abruf der Verarbeitungsprotokolle.

      1. -Ddac6.scheduler.autostart=true

        Note

        Der Parameter ist bei einem Setup mit mehreren Tomcats und einem Load Balancer nur bei einem Tomcat vorzunehmen, da beim Abruf ansonsten konkurrierende Zugriffe und Fehler auftreten können.


    4. Tab „Java“: Im Feld "Initial Memory Pool" tragen Sie "512" ein
    5. Tab „Java“: Im Feld "Maximum Memory Pool" tragen Sie ca. die Hälfte des verfügbaren physikalischen Arbeitsspeichers ein. Als Minimum empfehlen wir jedoch "2048". Bedenken Sie bitte bei 32-Bit-Systemen die Beschränkung des Arbeitsspeichers auf ca. 3,5 GB. Die hier gemachten Speichereinstellungen beeinflussen die Performance und Lauffähigkeit der Applikation. Unter Umständen sind diese bei wachsender Benutzung im Laufe der Zeit anzupassen.
  3. Kopieren Sie den zu Ihrem Datenbankserver passenden Datenbanktreiber in das "\lib"-Verzeichnis im Tomcat-Installationsverzeichnis.
    1. Microsoft SQL Server - https://docs.microsoft.com/en-us/sql/connect/jdbc/microsoft-jdbc-driver-for-sql-server
    2. Oracle - https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html
    3. MySQL - https://dev.mysql.com/downloads/connector/j/
  4. Die Datenbankverbindung ist als JNDI-Verbindung im Tomcat zu konfigurieren:
    1. Öffnen Sie die "context.xml"-Datei im "\conf"-Verzeichnis des Tomcats
    2. Fügen Sie einen neuen "Resource" XML Tag mit passenden Attributen für Ihr eingesetztes DBMS und folgenden Namen ein:
      1. "jdbc/portaldatasource" für das Portal
      2. "jdbc/dac6datasource" für DAC 6
    3. "Resource" XML Tag Beispiel für DAC6 mit MSSQL


      Code Block
      languagexml
      <Resource name="jdbc/dac6datasource" auth="Container" type="javax.sql.DataSource"
                     maxTotal="100" maxIdle="30" maxWaitMillis="10000"
                     username="dac6" password="dac6" driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
                     url="jdbc:sqlserver://localhost:1433;databaseName=dac6" />


  5. Optional für Microsoft SQL Server: Konfiguration für Windows-Authentifizierung
    1. Aus dem JDBC Treiber Paket muss zusätzlich aus dem Ordner auth die passende dll in das System32 Verzeichnis des Systems kopiert werden.
      Beispiel-Pfad: .\sqljdbc_8.2.2.0_deu\sqljdbc_8.2\deu\auth\x64\mssql-jdbc_auth-8.2.2.x64.dll
    2. Der Windows Benutzer muss im Tomcat eingetragen werden
      1. Der Benutzer benötigt Berechtigungen auf dem Server des Tomcats zum Ausführen des Tomcat-Dienstes sowie Schreibberechtigungen im Tomcatordner für Logs
      2. Der Benutzer benötigt Berechtigungen auf dem Server der Datenbank
      3. Der Benutzer benötigt o.g. Berechtigungen auf dem Datenbankschema



    3. Die Verbindungen in der context.xml müssen diesem Beispiel entsprechen:

      Code Block
      languagexml
      <Resource name="jdbc/dac6datasource" type="javax.sql.DataSource"
                              maxTotal="100" maxIdle="30" maxWaitMillis="10000
      						driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
      						url="jdbc:sqlserver://[SERVER-NAME];DatabaseName=[DATABASE_NAME];Integratedsecurity=true"/>


...