The Tomcat server requires the following configuration settings to be modified in order for FootPrints to install and run correctly:

• Java Virtual Machine (JVM) Memory Settings
• URIEncoding
• maxThreads
• (Optional): Enable data compression
• Manage size of catalina.out file
• Max HTTP Header Size
• ReduceTomcat Startup time

• Windows

  • Tomcat installed as a Windows service When Tomcat is installed as a Windows service, Tomcat is started and stopped using the Tomcat Service Wrapper. The service wrapper can be found in the "bin" folder in the Tomcat installation, .
    e.g.,

    C:\Program Files\Apache Software Foundation\Tomcat 7.0\bin\Tomcat7w.exe

  • Steps:
    1. Start the Tomcat Service Wrapper (Tomcat7w.exe) Refer to the image below when making changes in the Tomcat Service Wrapper.
    2. On the Java tab add the following line to the Java Options field:

       -Dfile.encoding=UTF-8

    3. On the next Line below -Dfile.encoding=UTF-8 add:

       -XX:+UseParallelGC

       Note: The parallel scavenge collector (Enabled using -XX:UseParallelGC). The algorithm is tuned for gigabyte heaps (over 10GB) on multi-CPU machines. This collection algorithm is designed to maximize throughput while minimizing pauses. It has an optional adaptive tuning policy which will automatically resize heap spaces. If you use this collector, you can only use the the original mark-sweep collector in the old generation (i.e. the newer old generation concurrent collector cannot work with this young generation collector).  More Info

    4. In the Initial memory pool box, enter a value of 4096.
    5. In the Maximum memory pool box, enter a value of 8192.

       NOTE: When setting the Maximum memory pool (-Xmx) value, ensure there is enough physical RAM on the server to accommodate this setting as ALL available memory of the server will be used for the Maximum memory pool setting. Therefore, a server should have 10-12GB of RAM if a Maximum memory pool setting of 8192 or more is to be used. See the System Requirements - Hardware Requirements for additional information on Maximum memory pool (-Xmx) settings.  80% is recommendation.

       USING JAVA 8 FOR FootPrints VERSIONS 12.1.01 up to 20.18.03:
       

       WARNING: Make sure there are no extra spaces at the end of any of the newly added lines. Additionally, be sure to set the Initial memory pool and Maximum memory pool values in the boxes indicated by the arrows in the image above, and DO NOT set these values using the -Xms (Initial Memory pool) and -Xmx (Maximum memory pool) in the Java Options field.

    6. Click "OK" to save your changes and close the dialog.
    7. Open the Services module on the Windows server.
       1. Change the "Startup Type" of the "Apache Tomcat 7.0 Tomcat7" service from "Manual" to "Automatic".
       2. Restart Tomcat.

1. relaxedQueryChars="[]" needs to be added to connector attribute in server.xml

• Linux

/usr/share/tomcat7/bin/startup.sh 
/usr/share/tomcat7/bin/shutdown.sh

1. Backup the "server.xml" file before making any changes.
2. Edit "server.xml".
3. Locate the connector node used by the FootPrints Service Core web app. The default node will look like this:

   <Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443"/>

   Modify the node and add the "URIEncoding" attribute. The node should look like this when correctly modified:

   <Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443" URIEncoding="UTF-8"/>

4. Save the "server.xml" file.

1. Backup the "server.xml" file before making any changes.
2. Edit "server.xml".
3. Locate the connector node used by the FootPrints Service Core web app. The node, after successfully having set the URIEncoding, will look like this:

   <Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443" URIEncoding="UTF-8"/>

   Modify the node and add the "maxThreads" attribute. The node should look like this when correctly modified:

   <Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443" URIEncoding="UTF-8" maxThreads="550"/>

4. Save the "server.xml" file.

1. Backup the "server.xml" file before making any changes.
2. Edit "server.xml".
3. Locate the Connector element and modify it to add the compression parameters highlighted below:

   <Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" 
   redirectPort="8443" URIEncoding="UTF-8" maxThreads="550" 
   compression="on" 
   compressionMinSize="2048" 
   noCompressionUserAgents="gozilla, traviata" 
   compressibleMimeType="text/html,text/xml,text/plain,text/css,text/javascript,application/x-javascript,
   application/javascript,application/xml,application/extjson,x-font/otf,application/x-font-woff,x-font/ttf,x-font/eot"
   />

4. Save the "server.xml" file.

• A shell script can be written to delete the catalina.out file each time Tomcat is restarted. The catalina.out file can also be manually deleted if it is found to be extremely large and believed to be contributing to performance degradation of Tomcat.
• The following 2 sites provide information on rotating the catalina.out file: https://dzone.com/articles/how-rotate-tomcat-catalinaout

• The "logging level" that is captured by the console logger/handler can be reduced using the following steps:
  1. Be sure to stop the Tomcat service before proceeding.
  2. Make a backup copy of the tomcat_install_dir/conf/logging.properties file (i.e. /usr/share/tomcat7/conf/logging.properties).
  3. Open the logging.properties file for editing in vi, vim, emacs, etc. Locate the following line in the file (indicated by the red arrow):
     
  4. Change the word "FINE" to "WARNING" or "SEVERE".
  5. Save the catalina.out file when done editing.
  6. Restart Tomcat.

1. Stop Tomcat.
2. Backup the current Tomcat server.xml file before making any changes.
3. Edit the server.xml
4. Locate the connector node used by the FootPrints application where the URIEncoding parameter is set. The node would typically look like this:

   <Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443" URIEncoding="UTF-8" maxThreads="550"/>

5. Modify the node by adding the maxHttpHeaderSize parameter. The node should look like this when correctly modified:

   <Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443" URIEncoding="UTF-8" maxThreads="550" maxHttpHeaderSize="8192"/>

6. Save the changed to the server.xml file.
7. Start Tomcat.