Prerequisites for Footprints 20.XX installation

Version 1
    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


    APPLIES TO:

    Footprints 20.XX



    DETAILS:

    Prerequisites for Footprints 20.19.XX installation
     

    The Footprints 2019 prerequisites have changed.

    Footprints 2019 requires Tomcat 8.5 along with Open JDK 11.0.2 to be deployed on your Footprints Server environment prior to installation or upgrade of the Footprints software.

      

    This document provides the steps you need to perform before you start upgrading or installing Footprints. 

      

    Prerequisites for Footprints 2019 R1 installation 

      

    Windows 

      
       
    1. Install and configure Java Open JDK 11.0.2 

      Download “Open JDK 11.0.2”   https://download.java.net/java/GA/jdk11/9/GPL/openjdk-11.0.2_windows-x64_bin.zip
      Unzip file

      Copy folder jdk-11.0.2 into program files folder e.g. - C:\Program Files\Java 

      

    Note:
    The default Java installations that are a part of the operating system might not include all functionality required to run FootPrints 

      

     

      
       
    1. Install and Configure Tomcat 8.5 

      Download Tomcat 8.5 from https://tomcat.apache.org/download-80.cgi  
      Install Tomcat 8.5

      Post installation configure Tomcat by following these steps: 

      Go to the Tomcat installation folder e.g. “C:\Program Files\Apache Software Foundation\Tomcat 8.5\bin” 

      Start the Tomcat Service Wrapper (Tomcat8w.exe)  

      Select JVM from C:\Program Files\Java\jdk-11.0.2\bin\server\jvm.dll. 

      Refer to the image below when making changes in the Tomcat Service Wrapper. 

      

     

    Initial Memory and Maximum memory pools are dependent upon your individual system resources.

      

    Open a command window with admin rights and run the following commands to set the JAVA_HOME and PATH environment variables to point to the correct Java Version 

      

     

      
       
    1. setx -m JAVA_HOME "C:\Progra~1\Java\jdk-11.0.2" 

      
       
    1. setx -m PATH "%PATH%;%JAVA_HOME%\bin";   

      Note: The SETX -m PATH command does not work correctly if the PATH has more than
      1024 characters If you have a larger path you will need to make sure that the path is correct by editing your entire path.

      

    Set JAVA_HOME environment variable and add it to the path variable too (make sure in Path variable the location is added at the beginning )

      

    Linux  

      
       
    1. Install and configure Java Open JDK 11.0.2 

      
       
    1. Download “Open JDK 11.0.2” from here: https://download.java.net/java/GA/jdk11/9/GPL/openjdk-11.0.2_linux-x64_bin.tar.gz

      
       
    1. Set the JAVA_HOME environment variable in Linux, where JAVA_HOME="PATH extracted above"  

      

    e.g. - 

      

    JAVA_HOME="/opt/java/jdk-11.0.2" 

      

    export JAVA_HOME 

      

    export PATH=$PATH:$JAVA_HOME/bin 

      
       
    1. In terminal enter the command "echo $JAVA_HOME" to check the environment variable is set.  It should return the openJDK11 path (a restart of the machine might be required if not returned correctly). 

      

    Note: The default Java installations that are a part of the operating system might not include all functionality required to run FootPrints. Because of this you must download and install Java even if it was already a part of the operating system. 

      

    Set JAVA_HOME environment variable and add it to the path variable too (make sure in Path variable the location is added at the beginning )

      
       
    1. Install and Configure Tomcat 8.5 

      
       
    1. Download Tomcat 8.5 from https://tomcat.apache.org/download-80.cgi 

      
       
    1. Go to Tomcat8.5 bin directory (/tomcat8.5/bin) 

      
       
    1. Create a setenv.sh file or open the file if it already exists  

      
       
    1. Add the following line in the file     

      

    export JAVA_HOME=/opt/java/jdk-11.0.2 

      

    export CATALINA_OPTS="$CATALINA_OPTS -Xms2048m"  

      

    export CATALINA_OPTS="$CATALINA_OPTS -Xmx8192m" 

      

    export CATALINA_OPTS="$CATALINA_OPTS -XX:MaxPermSize=256m" 

      

    export JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8" 

      

    IMPORTANT NOTE:  

      

    When upgrading to Footprints 2019 R1 from versions prior to 20.18.03, you need to reconfigure the default ports of Tomcat 7 in server.xml file that is 

      
       
    1. 8080 

      
       
    1. 8005 

      
       
    1. 8009 

      

    To some other port numbers as these will be used by Tomcat 8 for 2019 R1 

      
       
    1. if Footprints is not started via Tomcat8.5 and the tomcat logs contains an error related to cxf add the following line in setenv.sh 

      

    export CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.cxf.stax.allowInsecureParser=1" 

      

    For more detailed instructions refer to Knowledge Article https://bmcsites.force.com/casemgmt/sc_KnowledgeArticle?sfdcid=000166012

     


    Article Number:

    000166217


    Article Type:

    Product/Service Description



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