Prerequisites (2020 releases)

If you have Windows installed, perform the following steps:

1. Install OpenJDK 12 or OpenJDK 13.

   Notes

   • FootPrints does not support OpenJDK 11 and OpenJDK 14.
   • The default Java installations that are a part of the operating system might not include all the functionality required to run FootPrints. You must download and install Java even if it was already a part of the operating system.
2. Extract and copy the jdk folder into the Program files folder. For example, C:\Program Files\Java.
3. Install and configure Tomcat 8.5:
   
   1. Download Tomcat 8.5 from the Apache Tomcat website.
   2. Go to the Tomcat installation folder. For example, C:\Program Files\Apache Software Foundation\Tomcat 8.5\bin.
   3. Start the Tomcat Service Wrapper (Tomcat8w.exe).
   4. From C:\Program Files\Java\jdk-<version>\bin\server\jvm.dll, select JVM.
      Refer to the following figure when you are updating the Tomcat Service Wrapper:
      

   5. 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:

      setx -m JAVA_HOME "C:\Progra~1\Java\jdk-<version>"
      setx -m PATH "%PATH%;%JAVA_HOME%\bin";
      

      Notes

      • Use the appropriate version in the command in accordance with your jdk version.
      • The setx -m PATH command does not work correctly if the PATH has more than 1,024 characters.

If you have Linux installed, perform the following steps:

1. Install OpenJDK 12 or OpenJDK 13.

   Notes

   • FootPrints does not support OpenJDK 11 and OpenJDK 14.
   • The default Java installations that are a part of the operating system might not include all the functionality required to run FootPrints. You must download and install Java even if it was already a part of the operating system.

2. Extract and copy the jdk folder. Set the JAVA_HOME environment variable in Linux, where the JAVA plus HOME value is the path extracted in the previous step.

   Example

   JAVA_HOME="/opt/java/jdk-<version>"
   export JAVA_HOME                   
   export PATH=$PATH:$JAVA_HOME/bin    

   Note

   Use the appropriate version in the command in accordance with your jdk version.

3. In the terminal, enter the command echo $JAVA_HOME to check whether the environment variable is set correctly. The command must return the OpenJDK 12 or the OpenJDK 13 path.

   Note

   If the command does not return the correct OpenJDK path, restart the machine.

4. Install and configure Tomcat 8.5:
   1. Download Tomcat 8.5 from the Apache Tomcat website.
   2. Go to the Tomcat 8.5 bin directory (/tomcat8.5/bin).
   3. Create a setenv.sh file or open the file if it already exists.

   4. Add the following lines in the file:

      export JAVA_HOME=/opt/java/jdk-<version>
      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"

      Note

      Use the appropriate version in the command in accordance with your OpenJDK version.

5. If FootPrints is not started via Tomcat 8.5 and Tomcat logs contain an error related to cxf, add the following line in the setenv.sh file:

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