Versions Compared

Old Version 3

changes.mady.by.user IT Stonebranch

Saved on

compared with

New Version Current

changes.mady.by.user Stonebranch

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Step 1

Select an appropriate method of installation:
 
Windows
We recommend using the GUI installer to create the Apache Tomcat Service:

  1. Download the "32-bit/64-bit Windows Service Installer" from Tomcat 8.5.x or Tomcat 9.0.x.
  2. Follow the instructions to install the package.


Windows or Linux/Unix
Download a tar.gz or zip package that you unzip into a directory:

  1. Download an appropriate package from Tomcat 8.5.x or Tomcat 9.0.x. 
  2. 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.
 

Include Page
IL:CATALINA_OPTS - 6.9
IL:CATALINA_OPTS - 6.9

 
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
titleNote

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:
 

<pre>

set

"CATALINA_OPTS=-Xms512m

-Xmx2048m"

</pre>

Panel
Html bobswift

 
On Linux/Unix, $CATALINA_BASE/bin/setenv.sh:
 

<pre>

CATALINA_OPTS="-Xms512m

-Xmx2048m"

</pre>

Panel
Html bobswift

 
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):

html-bobswift

<ul> <li>

  • Initial
  • memory
  • pool
  • =
  • minimum
  • heap
  • size
  • (Xms)
<li>
  • Maximum
  • memory
  • pool
  • =
  • Maximum
  • heap
  • size
  • (Xmx)
</ul>


 

Note
titleNote

Later, after you start Tomcat and log in to the Controller, you can validate these settings by running the Memory Usage operation, as follows:

  1. From the Administration navigation pane, select Configuration > Server Operations.
  2. Run the Memory Usage operation. The min and max numbers on the top line (Heap) should be similar to the above settings.


...