Prerequisites (2021 Release 02)

If you have Windows installed, perform the following steps:

1. Install OpenJDK 17.

   Important

   • FootPrints does not support earlier versions of OpenJDK.
   • 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 is 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 or Apache Tomcat Version 9.x:
   
   1. Download Tomcat 8.5 or Apache Tomcat Version 9.x 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 or Tomcat9w.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";
      

      Important

      • 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.
      • (2021 Release 02 only) In the Java 9 Options section, add --add-exports=java.naming/com.sun.jndi.ldap=ALL-UNNAMED. 

If you have Linux installed, perform the following steps:

1. Install OpenJDK 17.

   Important

   • FootPrints does not support earlier versions of OpenJDK.
   • 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    

   Important

   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 17 path.

   Important

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

4. Install and configure Tomcat 8.5 or Tomcat 9.x:
   1. Download Tomcat 8.5 or Tomcat 9.x from the Apache Tomcat website.
   2. Go to the Tomcat 8.5 or Tomcat 9.x 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"

      Important

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

5. If FootPrints is not started via Tomcat 8.5 or Tomcat 9.x 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"