---
title: "Increasing Apache Tomcat memory allocation"
slug: "oas-iglnx-increasing-apache-tomcat-memory-allocation-3-28"
updated: 2025-07-04T10:04:25Z
published: 2025-07-07T13:49:16Z
canonical: "docs.onespan.com/oas-iglnx-increasing-apache-tomcat-memory-allocation-3-28"
---

> ## 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
<session-timeout>45</session-timeout>
```
  3. Save and close the file.
4. Start the Web Administration Service daemon:

/etc/init.d/vasco-was start
