Installing Apache Tomcat
Note
Apache Tomcat versions 8.5.x and 9.0.x are supported.
Install Apache Tomcat
Perform the following steps to install Apache Tomcat (download and installation procedure for Apache Tomcat may vary a bit for each platform):
Â
Step 1 | Select an appropriate method of installation:
Windows or Linux/Unix
Linux/Unix: Redhat and Centos distributions | ||||
---|---|---|---|---|---|
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.
 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. Â
Â
Â
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:
|
Start and Validate Apache Tomcat
Perform the following steps to start and validate Apache Tomcat:
Step 1 | Tomcat is normally run as a system service or daemon. You can start Tomcat using the standard method for your operating system or by using a script, as follows: |
---|---|
Step 2 | Open a browser and go to the following URL: http://localhost:8080. |
Step 3 | The following screen displays, verifying that you have successfully installed and started Tomcat: |
Troubleshooting
Tomcat Post Limit: STATUS_MAX_POST_SIZE_EXCEEDED
Problem
The following error message displays:
The server did not receive the data that was sent to it. Please see the documentation for isc.RPCResponse.STATUS_MAX_POST_SIZE_EXCEEDED
Resolution
Remove the post limit by specifying the following attribute on the <Connector> element in conf/server.xml
:
maxPostSize="-1"
Special Characters Not Displaying Correctly
Problem
Some special characters not getting displayed correctly in your browser GUI.
Resolution
Tomcat on Windows requires you to define code page UTF-8 as the default code page for war files.
To do this, add the following to the Java options statement just as you did with the memory parameter:
-Dfile.encoding=UTF8