Prerequisites (2019 Release 03)

If you have Windows installed, perform the following steps:

1. Install OpenJDK 12 or OpenJDK 13.

   Notes

   • (2019 Release 03 and later) FootPrints does not support OpenJDK 11.
   • 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.
      When updating the Tomcat Service Wrapper, see the following figure:
      

   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

   • (2019 Release 03 and later) FootPrints does not support OpenJDK 11.
   • 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 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"

1. Download the Windows installer.
2. Use 7-zip or winrar to extract the contents of the installer.
3. When the password window appears, enter fp2019r3.
   The data is extracted.

1. Download the installer to a directory.
2. Start the terminal.
3. Go to the directory where you had copied the installer.
4. Type gpg in the terminal and press Enter.
   This verifies that the machine is running the gpg module.
5. Type the following command:
   gpg -d <footprintsInstallerName>.tar.gz.gpg | tar zxvf –
6. When prompted for password, enter fp2019r3.
   The data is extracted.