Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

Damit das Zusammenspiel von PPP und dem MariaDB-Server funktioniert, müssen in der Datei C:\Program Files\MariaDB 10.311\data\my.ini im Abschnitt „[mysqld]“ im Vergleich zur Standard-Installation die folgenden Einstellungen ergänzt bzw. auf die angegebenen Werte geändert werden.

...

Um ein ordnungsgemäßes Funktionieren der PICTURE-Prozessplattform sicherzustellen, müssen einige Optionen der Instanz der Java Virtual Machine (JVM) angepasst werden, welche vom Tomcat-Server benutzt wird. Konfigurieren Sie dazu mit der Tomcat-Applikation Apache Tomcat 910.0 Tomcat9 → 1 Tomcat10 → Configure Tomcat die Java Options auf der Registerkarte Java.

...

Codeblock
-Xmx2g
-XX:ReservedCodeCacheSize=128m
-Dppp.config_directory=C:\PICTURE\config
-Duser.timezone=CET
-Duser.country=DE
-Djxl.nogc=true
-Djavax.net.ssl.trustStore=C:\Program Files\Apache Software Foundation\Tomcat 910.01\conf\truststore.jks
-Djavax.net.ssl.trustStorePassword=StrengGeheim1234!

Im Einzelnen sind folgende Einstellungen für den Betrieb der PPP relevant:

Einstellung

Bedeutung

Beispielwert

-Xmx

Maximale Größe des Java-Heapspeichers. Der Bedarf wird maßgeblich beeinflusst durch die zu unterstützende Anzahl paralleler Nutzer.

-Xmx2g (Szenario "Kleine Arbeitsgruppe"),
-Xmx8g (Szenario "Verwaltungsweites Informationssystem")

-XX:ReservedCodeCacheSize

Größe des Code Caches während der Compilierung. Beim Parallelbetrieb vieler Mandanten (> 50) reicht die Standard-Einstellung (i.d.R. 48 MB) ggf. nicht aus und es muss ein größerer Wert gesetzt werden. Sollen nur einzelne Mandanten betrieben werden, kann die Einstellung weggelassen werden.

-XX:ReservedCodeCacheSize=128m

-Dppp.config_directory

Verzeichnis, unterhalb dessen die Konfigurationsverzeichnisse der einzelnen PPP-Mandanten abgelegt werden

-Dppp.config_directory=C:\PICTURE\config

-Duser.timezone

Zeitzone, von welcher der Server betrieben wird

-Duser.timezone=CET

-Duser.country

Locale-Einstellung (beeinflusst Formatierung von Zahlen, Währungsangaben etc.)

-Duser.country=DE

-Djxl.nogc

Konfiguriert das Garbage-Collection-Verhalten der Drittanbieter-Bibliothek "JExcelAPI", welche für Excel-Exporte verwendet wird.

HinweisHier ist unbedingt die Einstellung "true" zur Deaktivierung der expliziten GC-Aufrufe durch JExcelAPI vorzunehmen, sodass ausschließlich die regulären, automatisch durch die JVM ausgelösten GC-Läufe durchgeführt werden. Andernfalls kann es im Server-Betrieb zu signifikanten Performance-Einbußen bis hin zum Blockieren der kompletten Tomcat-Instanz für mehrere Sekunden kommen, sobald Excel-Exporte und Berichte ausgeführt werden.

-

Djxl.nogc=true-

Djavax.net.ssl.trustStore

(optional)

Pfad zur TrustStore-Datei, in welcher vertrauenswürdige Zertifikate für SSL-verschlüsselte Verbindungen gespeichert werden. Die angegebene Datei muss Zertifikate für alle Ziel-Domains beinhalteten, zu denen durch die PPP SSL-geschützte Verbindungen aufgebaut werden sollen (z.B. SMTP-Server, über den automatisch generierte E-Mails verschickt werden). Wenn die PPP keine solchen SSL-geschützten Verbindungen zu Endpunkten aufbauen muss, die über kein Zertifikat verfügen, denen das JRE standardmäßig vertraut, kann diese Einstellung entfallen.

-Djavax.net.ssl.trustStore=C:\Program Files\Apache Software Foundation\Tomcat

9

10.

0

1\conf\truststore.jks

-Djavax.net.ssl.trustStorePassword

(optional: kann entfallen, wenn kein TrustStore benötigt wird)

Passwort zum Öffnen der o.g. TrustStore-Datei

-Djavax.net.ssl.trustStorePassword=StrengGeheim1234!

Hinweis

Die hier verwendeten JVM-Einstellungen bzgl. der Speicherbereiche sind Erfahrungswerte, mit denen i.d.R. ein problemloser Betrieb im Rahmen der im Abschnitt "Hardwareanforderungen" skizzierten Einsatz-Szenarien möglich ist. Treten im Live-Betrieb Fehler auf, welche auf zu gering dimensionierte Speicherbereiche hindeuten, passen Sie die Werte ggf. an. Hintergrundinformationen zur Bedeutung der einzelnen JVM-Parameter finden Sie unter httphttps://docs.oracle.com/javaseen/8java/docsjavase/technotes11/tools/unix/java.html.


Starttyp des Apache-Server-Dienstes ändern

...

Damit der Tomcat-Server im Falle eines Neustart Ihres Windows Servers automatisch gestartet wird, passen Sie noch den Starttyp des Apache-Dienstes an. Öffnen Sie dazu die Dienste-Applikation des Windows-Servers und bearbeiten Sie die Eigenschaften des Dienstes Apache Tomcat 910.0 Tomcat91 Tomcat10. Ändern Sie den Starttyp von Manuell auf Automatisch.