In order to accommodate large workloads, Universal Controller requires that you configure the Java heap size options using the CATALINA_OPTS environment variable. The following table outlines the minimum recommended configuration.
Include Page |
---|
| IL:CATALINA_OPTS - 6.9 |
---|
| IL:CATALINA_OPTS - 6.9 |
---|
|
If you have installed Tomcat as a service on Windows, see 13303853 Windows Service, below; otherwise, see All Platforms:
All Platforms
A recommended way to set the CATALINA_OPTS environment variable is to use the optional setenv
script.
The script is placed into either the CATALINA_BASE/bin or CATALINA_HOME/bin directory and is named setenv.bat
(on Windows) or setenv.sh
(on Linux/Unix). The file must be readable.
Note |
---|
|
The CATALINA_BASE environment variable specifies location of the root directory of the "active configuration" of Tomcat. It is optional. It defaults to be equal to CATALINA_HOME. |
By default, the setenv
script file is absent. If the script file is present in both CATALINA_BASE and CATALINA_HOME, the file in CATALINA_BASE is preferred.
For example, to configure the CATALINA_OPTS environment variable for Java 8, you can create the following script file:
On Windows, %CATALINA_BASE%\bin\setenv.bat
:
Panel |
---|
set "CATALINA_OPTS=-Xms512m -Xmx2048m"
|
On Linux/Unix, $CATALINA_BASE/bin/setenv.sh:
Panel |
---|
CATALINA_OPTS="-Xms512m -Xmx2048m"
|
For additional Tomcat configuration details, including CATALINA_OPTS, see RUNNING.txt.
Anchor |
---|
| Windows Service |
---|
| Windows Service |
---|
|
Windows Service If you installed Tomcat as a Windows service, you can set values using the
$CATALINA_HOME\bin\tomcatw.exe
GUI tool.
Enter the parameters as follows (for Tomcat 8.5.x or Tomcat 9.0.x):
- Initial memory pool = minimum heap size (Xms)
- Maximum memory pool = Maximum heap size (Xmx)
Note |
---|
|
Later, after you start Tomcat and log in to the Controller, you can validate these settings by running the Memory Usage operation, as follows: - From the Administration navigation pane, select Configuration > Server Operations.
- Run the Memory Usage operation. The min and max numbers on the top line (Heap) should be similar to the above settings.
|