Tomcat settings

Last modified by Sabrina Schulze on 07.01.2019

The settings described on this page should be performed for every system. Additional optional settings include:


The following settings should be applied to increase the amount of available memory.

  • -Xms512m
    Initial size of the heap.
  • -Xmx4096m
    Maximum size of the heap.
  • -XX:PermSize=128m
    Intial size of the permanent generation.
  • -XX:MaxPermSize=512m
    Maximum size of the permanent generation (initial + virtual).

Example (Linux)

The path to the configuration file is TOMCAT_DIRECTORY/bin/

export JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx4096m -XX:PermSize=128m -XX:MaxPermSize=512m"


When you notice issues with the special characters of foreign letters, for example when translating a form to Arabic or Chinese, check whether the URIEncoding has been set on the connector.

The path to the configuration file is TOMCAT_DIRECTORY/conf/server.xml

The parameter should be set as follows on the connector: URIEncoding="UTF-8".


<Connector port="80" protocol="HTTP/1.1"
               URIEncoding="UTF-8" />

If there are also display problems with filenames with special characters and/or umlauts, please add the Java parameter -Dfile.encoding=UTF-8. Depending on the used operating system, this must either be specified in the configuration file or configuration view.

Example (Linux)

The path to the configuration file is TOMCAT_DIRECTORY/bin/

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

Session timeout

Should the default setting of 30 minutes not be sufficient, the session timeout can be increased by modifying the file web.xml. Uses will be logged out when they are idle longer than this limit.

The path to the  configuration file is TOMCAT_DIRECTORY/webapps/formcycle/WEB-INF/web.xml

<!-- Sets the sesssion timeout to 30 minutes -->

Context name

The context name is used, for example, by Monitoring Beans to monitor the server status.

The context name defaults to the name of the WAR file of Xima® Formcycle, but it can be changed when necessary by modifying the context parameter XFC_CONTEXT_NAME in the configuration file web.xml.

Created by superadmin on 24.06.2015
Translated into en by superadmin on 26.07.2016
Copyright 2000-2020