Page Comparison

...

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: "-Dportal.db.migration=auto"
      

      Anchor
      ConfigTomcat2b ConfigTomcat2b

   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. 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 Namen "jdbc/portaldatasource" ein.
      Beispiel "Resource" XML Tag für MSSQL
      

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

      
      

      Note
      Bei der Verwendung eines Microsoft SQL Server Datenbanktreibers mit Version größer 10.x.x ohne Verschlüsselung muss der url Paramaeter des Resource Tags um ;encrypt=false erweitert werden (in diesem Beispiel url="jdbc:sqlserver://localhost:1433;databaseName=portal;encrypt=false")

      
      

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
      language xml
      <Resource name="jdbc/portaldatasource" 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"/>

      
      

...

Sollten Sie ein Self-Signed TLS/SSL Zertifikat im Tomcat eingebunden haben, kann es vorkommen, dass HTTP-Requests vom Portal zu anderen Modulen nicht durchgeführt werden können. In diesem Fall hinterlegen Sie im Tomcat folgenden Parameter im Feld "Java Options":

-Dportal.api.allowSelfSignedCertificatallowSelfSignedCertificate=true

Damit wird in der Applikation explizit die Verwendung von Self-Signed Zertifikaten erlaubt.

...