frevvo v9 is no longer supported. Please visit Live Forms Latest for our current Cloud Release. Earlier documentation is available too.

JDK Prerequisite

You must install the supported version of OpenJDK Java Development Kit (JDK) before installing . The Insight Server requires the JAVA_HOME environment variable to be set to the installation directory for the Java package that you install.

This page refers specifically to a JDK installation on a Windows system. If you are installing on Unix you will need to adjust some of the specifics accordingly.

Follow the steps below:

 On This Page:

 

Check to see if JDK is already installed

If you are not sure whether you have the supported version of JDK installed correctly, please confirm by doing the following:

  1. Run a complete directory search  for the JDK
    1. Run a complete directory search(using the 'All File and Folders' option if available) on your drives for the occurrence of 'jdk' in the filename to search for the JDK.

      1. If your results retrieve a folder with the name 'jdk' immediately followed by a series of version numbers (for example, jdk-11.0.2), then your JDK has been installed. You should double-check the contents of this folder to ensure that the installation files are intact. If you are unsure about this, proceed to Install JDK section to re-install it. Otherwise, proceed to step 4 in that section to check that your JAVA_HOME environment variable has been set correctly.
    1. If you do not retrieve results as explained above, then it is highly likely that your JDK has not been installed. Go to the applicable installation section below for the instructions.

Install JDK

 To install JDK, follow these instructions:

  1. Download the supported version of Java JDK. There are several vendors who source the supported JDK version as OpenJDK. Here are two suggested resources: 
    1. Oracle OpenJDK
    2. Adopt OpenJDK
      For more information about selecting an OpenJDK vendor click here
  2. When the download has finished, extract the zip file into a folder, e.g. C:\Program Files\Java\ and it will create a jdk-11 folder (where the bin folder is a direct sub-folder). You may need Administrator privileges to extract the zip file to this location.
  3. Select Control Panel and then System.

  4. Set a PATH:

    1. Click Advanced and then Environment Variables.
    2. Add the location of the bin folder of the JDK installation to the PATH variable in System Variables.
    3. The following is a typical value for the PATH variable: C:\WINDOWS\system32;C:\WINDOWS;"C:\Program Files\Java\jdk-11\bin"
  5. Set JAVA_HOME:

    1. Enter the variable name as JAVA_HOME.
    2. Enter the variable value as the installation path of the JDK (without the bin sub-folder).
    3. Click OK.
    4. Click Apply Changes
  6. To see if it worked, open up the Command Prompt and type java -version and see if it prints your newly installed JDK.

Upgrading Java

Check that you have replaced the Path and JAVA_HOME environment variables from any prior versions of Java with values that point to the new version. You may need to uninstall the prior Java version and restart your server.

Locate the JDK Installation Directory 

If you already know the installation path for the Java or Software Development Kit, go to the Set the JAVA_HOME Environment Variable section below. Otherwise, find the installation path by following these instructions:

  1. Unless you changed the installation path for the Java Development Kit during installation, it will be in a directory under C:\Program Files(x86)\Java for a 32 bit architecture and under c:\Program Files for a 64 bit Windows system. Using Explorer, open the directory C:\Program Files(x86) or Program Files\Java.
  2. Inside that path will be one or more subdirectories such as jdk11.0.2. If you have just installed the Java Development Kit, it will be installed to the newest directory, which you can find by sorting by date. For example, it may be installed in C:\Program Files\Java\jdk11.0.2. This is the installation path.

Set the JAVA_HOME Environment Variable

Once you have identified the JDK installation path:

  1. Open the Control Panel.
  2. Click the System icon
  3. Click Advanced System Settings.
  4. Click the Environment Variables button.
  5. Under System Variables, click New.
  6. Enter the variable name as JAVA_HOME.
  7. Enter the variable value as the installation path for the Java Development Kit.
  8. Click 'OK'.
  9. Click 'Apply Changes' or 'OK'

Return to Quick Start Installation Guide for frevvo in house if you are evaluating or to Database Setup if you are configuring an external database in your in-house environment.