Tomcat configuration recommendations

This topic provides some configuration tips for getting started with your Tomcat application server.

Keep in mind that complete documentation on configuring and using the Tomcat server is available at this URL for the server: http://localhost:8080/docs/

This topic provides some configuration tips that are specific to the Integrator ETL Server application.

Creating a setenv file

It is recommended that you create a file named setenv.bat (Windows) or setenv.sh (Linux) and place it in the Tomcat bin directory. With this file (which is run by the catalina.bat and catalina.sh scripts), you can change the following Tomcat environment settings with the JAVA_OPTS variable:

• You can set the minimum and maximum memory heap size with the JVM -Xms and -Xmx parameters. The best limits depend on many conditions, such as transformations that Integrator ETL should execute. For Information Discovery transformations, a maximum of 1 GB is recommended. For example, to set the minimum heap size to 128 MB and the maximum heap size to 1024 MB, use:

  JAVA_OPTS="-Xms128m -Xmx1024m"

• You should set the maximum limit of the PermGen (Permanent Generation) memory space to a size larger than the default. The default of 64 MB is not enough for enterprise applications. A suitable memory limit depends on various criteria, but 256 MB would make a good choice in most cases. If the PermGen space maximum is too low, OutOfMemoryError: PermGen space errors may occur. You can set the PermGen maximum limit with the following JVM parameter:

  -XX:MaxPermSize=256m

• For performance reasons, it is recommended that the application is run in Server mode. Apache Tomcat does not run in Server mode by default. You can set the Server mode by using the JVM -server parameter. You can set the JVM parameter in the JAVA_OPTS variable in the environment variable in the setenv file.

The following is an example of a setenv.bat file:

set "JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx1024m -XX:MaxPermSize=256m -server"

About database connections

By default, Integrator ETL Server uses an embedded Apache Derby database. This database is suitable for testing and evaluation environments. In these environments, no additional configuration is necessary.

In production environments, use of the embedded Derby database is not recommended. In these environments, you should use a robust, production-quality database, such as an Oracle or MySQL database. For details about configuring these databases, see the Integrator ETL Server Guide.