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:

   JAVA_OPTS="$JAVA_OPTS ‑Djava.awt.headless=true ‑Xms256m ‑Xmx256m"

   to this:

   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:

      <session-timeout>45</session-timeout>

      This tag specifies the Apache Tomcat time-out limit. The value is given in minutes.

   3. Save and close the file.

4. Start the Web Administration Service daemon:

   /etc/init.d/vasco-was start