You must install the supported version of OpenJDK Java Development Kit (JDK) before installing frevvo. 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:
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:
- Run a complete directory search for the JDK
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.
- 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.
- 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.
To install JDK, follow these instructions:
- Download the supported version of Java JDK. There are several vendors who source the supported JDK version as OpenJDK. Here are two suggested resources:
- Oracle OpenJDK
- Adopt OpenJDK
For more information about selecting an OpenJDK vendor click here.
- Download the supported JDK version.
- When the download has finished, run the Java installer. At one point, you will be asked to choose a directory to install to. Make note of this directory for use later.
- Check that the JAVA_HOME environment variable has been set correctly.
- Open the 'Start' menu, choose 'Run', type cmd in the 'Run' dialog box and click the 'OK' button.
- In the command prompt window, type echo %JAVA_HOME% and then press Enter.
- View the result:
- If a directory path is displayed that looks similar to one of the following examples, with the letters 'jdk' immediately preceding a series of version numbers, and this path matches the location where you installed the JDK in step 3, then your JDK has been successfully installed and your JAVA_HOME environment variable has been set correctly. ''Examples of typical JAVA_HOME environment variable values'':
- C:\Program Files\Java\jdk11.0.2
- If nothing is displayed or you do not see 'jdk' immediately followed by a series of version numbers (like one of the examples above), then you need to set the JAVA_HOME environment variable. Please follow these instructions to set your JAVA_HOME environment to the directory where you have just installed the JDK. By default, this directory is under C:\Program Files(x86)\Java for a 32 bit Windows System. You will find it under c:\Program Files on a 64 bit Windows system
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:
- 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.
- 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:
- Open the Control Panel.
- Click the System icon
- Click Advanced System Settings.
- Click the Environment Variables button.
- Under System Variables, click New.
- Enter the variable name as JAVA_HOME.
- Enter the variable value as the installation path for the Java Development Kit.
- Click 'OK'.
- Click 'Apply Changes' or 'OK'
Return to Quick Start Installation Guide for Live Forms in house if you are evaluating frevvo or to Database Setup if you are configuring an external database in your in-house environment.