Step 1 | Select an appropriate method of installation:
Windows
We recommend using the GUI installer to create the Apache Tomcat Service: Download the "32-bit/64-bit Windows Service Installer" from Tomcat 8.5.x or Tomcat 9.0.x. Follow the instructions to install the package.
Windows or Linux/Unix
Download a tar.gz or zip package that you unzip into a directory: Download an appropriate package from Tomcat 8.5.x or Tomcat 9.0.x. Follow the instructions to unzip the appropriate package (tar.gz or zip) into a directory on your file system.
Linux/Unix: Redhat and Centos distributions
Instead of downloading a tar.gz or zip package, you can use the yum installer. |
|---|
Step 2 | 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.
If you have installed Tomcat as a service on Windows, see 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:
set "CATALINA_OPTS=-Xms512m -Xmx2048m"
On Linux/Unix, $CATALINA_BASE/bin/setenv.sh:
CATALINA_OPTS="-Xms512m -Xmx2048m"
For additional Tomcat configuration details, including CATALINA_OPTS, see RUNNING.txt.
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): 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.
|
|---|
