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 den ATP
      2. "-Ddac6.db.migration=auto" für DAC 6
    3. Tab „Java“: Im Feld "Initial Memory Pool" tragen Sie "512" ein
    4. 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. Wenn Sie die Datenbankverbindung als JNDI-Verbindung im Tomcat konfigurieren möchten, gehen Sie wie folgt vor:
    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 den ATP
      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" />

Einrichtung der Deployments

...

  1. Kopieren und entpacken Sie die war-Dateien aus dem Auslieferungspaket in das „\webapps“-Verzeichnis im Tomcat-Installationsverzeichnis. Sie können das Paket selbstverständlich zunächst an einen anderen Ort editieren, um dort die Konfiguration vorzunehmen, und nach Fertigstellung nach „\webapps“ kopieren.
  2. Nun konfigurieren Sie folgende Dateien unterhalb dieses Ordners:
    1. "\WEB_INF\classes\META-INF\persistence.xml": 
      1. In dieser Datei kommentieren Bei Verwendung einer JNDI-Verbindung
        1. Keine Anpassung in der "persistence.xml"-Datei notwendig
      2. Bei direkte Angabe der Datenbankverbindung
        1. Löschen Sie die Zeile mit dem XML Tag "<non-jta-data-source>" vollständig
        2. Kommentiern Sie den "<properties>" XML Block ein
        3. Kommentieren Sie den Block für Ihr eingesetztes DBMS ein und die anderen Blöcke aus
        4. Passen Sie IP/Hostname des Datenbankservers, den Datenbanknamen und Benutzer/Passwort entsprechend den unter dem Punkt „Datenbank“ gewählten Parametern an.
    2. "\migration\sql\common\V20200113100000000__Insert_TSETTING.sql":
      1. Ändern Sie die URL zum Wert "OPENID_ATP_PATH"
      2. Hier muss die URL angegeben werden, unter der das ATP in Ihrem Netzwerk öffentlich erreichbar ist.
        1. Z.B. "http://demo.amana.de/atp"
      3. Ändern Sie die URL zum Wert "OPENID_DAC6_PATH"
      4. Hier muss die URL angegeben werden, unter der das DAC 6 in Ihrem Netzwerk öffentlich erreichbar ist.
        1. Z.B. "http://demo.amana.de:8080/dac6"
      5. Nur so kann sichergestellt werden, dass sich DAC 6 ordnungsgemäß beim ATP registrieren kann und letztendlich die Weiterleitung funktioniert.
    3. "\migration\sql\common\V20200515000000000__Insert_TSETTING.sql":
      1. Ändern Sie die URL zum Wert "API_ATP_PATH"
      2. Hier muss die URL angegeben werden, unter der das ATP in Ihrem privaten Netzwerk erreichbar ist.
        1. Z.B. "http://servername/atp"
      3. Ändern Sie die URL zum Wert "API_DAC6_PATH"
      4. Hier muss die URL angegeben werden, unter der das DAC 6 in Ihrem privaten Netzwerk erreichbar ist.
        1. Z.B. "http://servername:8080/dac6"
      5. Nur so kann sichergestellt werden, dass DAC 6 und ATP untereinander kommunizieren können.

...