Systemeinstellungen - Tomcat-Einstellungen

Page / - zuletzt bearbeitet von gru am 27.07.2021, 09:20

Tomcat-Einstellungen

zuletzt bearbeitet von gru

am 27.07.2021, 09:20

Inhaltsverzeichnis

Speicher

Einstellung am Connector

Beschränkung der Upload-Größe ändern

Beschränkung der HTTP-Headergröße ändern

UTF-8

Session-Timeout

Kontextname

Benutzerpfad für Tomcat

Inhalt [ Verbergen ]

Speicher

Einstellung am Connector

Beschränkung der Upload-Größe ändern

Beschränkung der HTTP-Headergröße ändern

UTF-8

Session-Timeout

Kontextname

Benutzerpfad für Tomcat

Diese Einstellungen sollten an jedem System entsprechend vorgenommen werden. Optional können noch folgende Einstellungen vorgenommen werden:

Bereitstellung über HTTPS
Konfiguration des Tomcats um Aufruf über HTTPS zu ermöglichen

Xima® Formcycle von Root-Domain aufrufen
Statt etwa über http://formcycle.eu/formcycle/ kann Xima® Formcycle so über http://formcycle.eu/ aufgerufen werden.

Datenverzeichnis von Xima® Formcycle ändern
Verzeichnis, in dem interne Daten von Xima® Formcycle und Formularen gespeichert werden.

Speicher

Folgende Einstellungen bzgl. Arbeitsspeicher sollten vorgenommen bzw. angepasst werden.

-Xms512m
Anfangsgröße des Heap

-Xmx4096m
Maximalgröße des Heap

Beispiel (Linux)

Der Pfad zur Konfigurationsdatei ist TOMCAT_VERZEICHNIS/bin/setenv.sh

export JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx4096m"

Einstellung am Connector

Folgende Einstellungen sollten am Tomcat in der Konfigurationsdatei TOMCAT_VERZEICHNIS/conf/server.xml vorgenommen werden:

<Connector port="80" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443"
URIEncoding="UTF-8"
maxPostSize="10485760"
maxHttpHeaderSize="65536"
relaxedQueryChars="[ \ ] ^ ` { | }" />

Weitere Informationen zu den Parametern finden Sie in den folgenden Abschnitten.

Beschränkung der Upload-Größe ändern

Diese Einstellung betrifft die Maximalgröße von Dateien beim Upload im Formular durch Uploadelemente und beim Upload im Posteingang. Ist die Uploadgröße kleiner als definiert, kommt es zu einem Fehler beim Hochladen der Datei. Der Default-Wert sind 2MB.

Der Pfad zur Konfigurationsdatei ist TOMCAT_VERZEICHNIS/conf/server.xml

Folgende Option muss innerhalb des Connectors definiert sein:

maxPostSize="Wert in Bytes"

Beispiel für eine maximale Uploadgröße von 10 MB, die Angabe erfolgt in Bytes:

<Connector ...
maxPostSize="10485760"
... />

Beschränkung der HTTP-Headergröße ändern

Diese Einstellung betrifft die Maximalgröße der vom Tomcat akzeptierten HTTP-Header. Diese kann zum Beispiel bei aktivierter Kerberos-Authentifizierung den Standardwert überschreiten, sodass Tomcat zum Beispiel der Aufruf eines Formulars mit einem HTTP-Fehlercode 400 (Ungültiger Request) verweigert.

Der Pfad zur Konfigurationsdatei ist TOMCAT_VERZEICHNIS/conf/server.xml.

Folgende Option muss innerhalb des Connectors definiert sein:

maxHttpHeaderSize="Wert in Bytes"

Beispiel für 64 KB, die Angabe erfolgt in Bytes:

<Connector ...
maxHttpHeaderSize="65536"
... />

UTF-8

Kommt es zu Fehlern bei der Darstellung von Umlauten oder anderen landesspezifischen Zeichen, prüfen Sie, ob das URIEncoding am Connector angegeben wurde.

Der Pfad zur Konfigurationsdatei ist TOMCAT_VERZEICHNIS/conf/server.xml

Folgende Option muss innerhalb des Connectors definiert sein:

URIEncoding="UTF-8"

Beispiel

<Connector ...
URIEncoding="UTF-8"
... />

Kommt es ferner zu Darstellungsproblemen von Dateinamen mit Sonderzeichen und/oder Umlauten ergänzen sie bitte den Java-Parameter -Dfile.encoding=UTF-8. Dieser muss je nach verwendetem Betriebssystem entweder in der verwendeten Konfigurationsdatei oder Konfigurationsfenter angegeben werden.

Beispiel (Linux)
Der Pfad zur Konfigurationsdatei ist TOMCAT_VERZEICHNIS/bin/setenv.sh

export JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8"

Session-Timeout

Das Session-Timeout kann innerhalb der web.xml von Xima® Formcycle erhöht werden, sollte die Standardeinstellung von 30 Minuten nicht ausreichen.

Der Pfad zur Konfigurationsdatei ist TOMCAT_VERZEICHNIS/webapps/formcycle/WEB-INF/web.xml

<!-- 30 Minuten bis Session-Timeout -->
<session-config>
<session-timeout>30</session-timeout>
</session-config>

Kontextname

Der Kontextname wird beispielsweise genutzt, um Monitoring Beans zum Überwachen des Serverstatus einzurichten. Standardmäßig ist der Kontextname der Name der WAR-Datei, kann aber auch geändert werden, indem der Kontextparameter XFC_CONTEXT_NAME in der Konfigurationsdatei web.xml geändert wird.

<context-param>
<param-name>XFC_CONTEXT_NAME</param-name>
<param-value>formcycle</param-value>
</context-param>

Benutzerpfad für Tomcat

Auf manchen Linux-basierten Systemen besitzt der Tomcat Nutzer standardmäßig keinen Benutzerordner. Ein solcher wird aber benötigt, damit Xima® Formcycle grundlegende Einstellungen ablegen kann. Der Pfad des Benutzerordners wird üblicherweise in der Datei /etc/passwd vorgenommen.