--- title: "Increasing Apache Tomcat memory allocation" slug: "oas-iglnx-increasing-apache-tomcat-memory-allocation-3-29" updated: 2026-01-12T10:22:28Z published: 2026-01-15T08:07:00Z canonical: "docs.onespan.com/oas-iglnx-increasing-apache-tomcat-memory-allocation-3-29" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # Increasing Apache Tomcat memory allocation If you intend to import a large number of users or authenticator records, we recommend that you use the Tcl Command-Line Administration tool for the import. For more information, refer to the OneSpan Authentication Server Administrator Guide. If you cannot use the Tcl Command-Line Administration tool, you will have to increase the memory allocation for Apache Tomcat. To increase Apache Tomcat memory allocation 1. Stop the Web Administration Service daemon: /etc/init.d/vasco-was stop 2. Modify the Apache Tomcat init script, i.e. /etc/init.d/vasco-was, to increase the initial and the maximum memory allocation values passed to the Java Runtime Environment. Change the following line: ```shell JAVA_OPTS="$JAVA_OPTS ‑Djava.awt.headless=true ‑Xms256m ‑Xmx256m" ``` To this: ```shell JAVA_OPTS="$JAVA_OPTS ‑Djava.awt.headless=true ‑Xms512m ‑Xmx512m" ``` We recommend to set the initial and the maximum amount of memory allocated to the JVM heap to the same value. In most cases 512 MB will be enough; you may need to set higher values only if you experience issues when importing very large user import files (CSV) or DPX files. 3. Increase the Apache Tomcat session time-out limit: 1. Open the Administration Web Interface web application deployment descriptor file: /opt/vasco/iaswas/tomcat/conf/web.xml 2. Locate the session-timeout tag and set the value to at least 45: ```markup 45 ``` 3. Save and close the file. 4. Start the Web Administration Service daemon: /etc/init.d/vasco-was start