How to configure Tomcat for Footprints 12.X -- 20.X on  Windows

Version 11
    Share This:

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    PRODUCT:

    FootPrints


    COMPONENT:

    Footprints Rewrite in Java - Renoir


    APPLIES TO:

    Footprints 12 and above



    QUESTION:

    How to configure Tomcat for Footprints 12.X -- 20.X on  Windows ?


    ANSWER:

    The Apache Tomcat is the only supported Web Server (Servlet Container) that can host the FootPrints application server. For performance considerations, use of a dedicated Tomcat instance is recommended.

    The following Apache Tomcat versions are supported.
     

                                                                                    
    FootPrints VersionFootPrints Version
    FootPrints 12.1.x and 20.18.02Apache Tomcat Version 7.0.x (64-bit) 
     
    FootPrints 20.18.03 , 20.19.XApache Tomcat Version 8.5.x (64-bit) 
     
      
          

    Prerequisites 

      

    1. Install and configure Java for usage in Footprints ( Knowledge Base )

      

     

      
                                                                                                                                
    FootPrints VersionJava Version
    FootPrints 20.19.03OpenJDK 12.0.2 & 13.0
    FootPrints 20.19.02OpenJDK 12.0.2
    FootPrints 20.19.01OpenJDK 11.0.2
    FootPrints 12.1.x and 20.18.03Java 8 (64-bit) 
      
          

    2. Tomcat service must be configured to use Local System service account 

      
       
    1.  Click Start, point to Administrative Tools, and then click Services.
    2.  
    3.  Right-click on Apache Tomcat service, and then click Properties.
    4.  
    5.  Click the Log On tab, select Local system radio button, and then click Apply.
    6.  
    7. Click the General tab, and then click Start to restart the service.
       
       User-added image
      

     3. Configure Java Virtual Machine (JVM) Memory Setting up

      

     

      
       
    1. The options that you should set and the values they are set to depend on your version of Java and the application server that you use.
          
                                                                                                      
    FootPrints VersionJava OptionsJava 9 Options
    FootPrints 12.1.x - 20.18.03-Dfile.encoding=UTF-8
    -XX:+UseParallelGC
    -Djava.awt.headless=true
     
    FootPrints 20.19.X-Dfile.encoding=UTF-8
    -XX:+UseParallelGC
    -Djava.awt.headless=true
    --illegal-access=permit
      
          
       
    1. In the Initial memory pool box, enter a value of 4096.
    2.  
    3. In the Maximum memory pool box, enter a value not more than 80% of your maximum server memory.
      
      User-added image
      
       
    1. Click "Apply" to save your changes and close the dialog. 
    2.  
    3. In General tab, stop and start Tomcat service  
      

    4. Configure Server.xml file 

      
       
    1. Shutdown the Tomcat Service
    2.  
    3. Edit the server.xml file found under Tomcat's conf directory C:\Program Files\Apache Software Foundation\Tomcat x.x\conf\server.xml
    4.  
    5. Search for Connector port="8080" and highlighted attributes. 
      
                                                                                    
    FootPrints VersionAttributes
    FootPrints 20.19.X  <Connector port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol"
                   connectionTimeout="3000"
                   redirectPort="8443"
                   URIEncoding="UTF-8"
                   maxThreads="550" 
                   maxHttpHeaderSize="65536"
                   relaxedQueryChars="[]" />     
     
    FootPrints 12.1.x and 20.18.03<Connector port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol"
                   connectionTimeout="3000"
                   redirectPort="8443"
                   URIEncoding="UTF-8"
                   maxThreads="550" 
                   maxHttpHeaderSize="65536" />  
        
      
          
       
    1. Save the server.xml file
    2.  
    3. Re-start the server
    Sometimes you may notice that there is high HTTP traffic, and you may determine that it's because the server is attempting to return high volumes of data back to the browser. In this case, if you are running Tomcat, you have the added option of turning on compression at the application server level. To enable compression adding following attribute in server.xml file in the Connector port="8080" 

    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"
      

    Note:

      
       
    1. If you are using secure LDAP (LDAPS) for authentication or Address Book. add this variable in Java Option -Dcom.sun.jndi.ldap.object.disableEndpointIdentification=true
    2.  
    3. If Web Server Authentication is enabled  (Single Sign on), replace following line in server.xml file
      
    <!-- Define an AJP 1.3 Connector on port 8009 -->     <Connector port="8009" protocol="AJP/1.3" redirectPort="8443"/>
       with:   
    <!-- Define an AJP 1.3 Connector on port 8009 -->     <Connector port="8009" protocol="AJP/1.3" packetSize="65536" tomcatAuthentication="false" URIEncoding="UTF-8"/>

     


    Article Number:

    000175451


    Article Type:

    FAQ/Procedural



      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles