Tomcat-Einstellungen
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
Einstellung am Connector
Folgende Einstellungen sollten am Tomcat in der Konfigurationsdatei TOMCAT_VERZEICHNIS/conf/server.xml vorgenommen werden:
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:
Beispiel für eine maximale Uploadgröße von 10 MB, die Angabe erfolgt in Bytes:
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:
Beispiel für 64 KB, die Angabe erfolgt in Bytes:
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:
Beispiel
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
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
<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.
<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.