Install Java

This page enables you to install Java. It covers the installation for Windows and Unix environments.

Background

All Fredhopper software requires Oracle Java to be installed. Due to legal restrictions Java is not shipped together with Fredhopper and has to be installed separately.

Compatibility

Depending on the FAS version different versions of Oracle Java are required. See the table below:

Note that later versions of Java are not always backward compatible with the versions listed here.

Java installation requirements

Whether you are installing Java on your local desktop, test environment or production environment please ensure you have user rights that enable you to install new software.

Additional Installation Requirements Note that the instructions on this page are intended to cover the generic cases. Please read the Java installation instructions specific to your operating system and hardware combination for additional information.

Java Installation Step-By-Step

the following steps describe how to set-up Java using Oracle Java 8 update 45 as an example.

Step 1: Download Java

In this step you will download the proper Java version.

1. Go to the JDK 8u45 download page: http://www.oracle.com/technetwork/java/javase/downloads/java-archive-javase8-2177648.html#jdk-8u45-oth-JPR
2. Select the proper OS version and click the download link and select a convenient location to store the file

Ensure you download the JDK, and not the JRE. Fredhopper software will not run with a JRE.

Step 2: Install Java

In this step you will do the actual installation of Java. Please follow the steps listed for you OS, and make a note of the installation path, as it will be needed later on.

Windows

1. Go to the directory the where you have downloaded the file in Step 1
2. Execute the downloaded file, the installation wizard will appear
3. Accept the Java license agreement
4. Configure the installation

   Public JRE The Java Development Kit installer can optionally install a public Java Runtime Environment (JRE). This is not required for Fredhopper.

   

5. Click Next, this will run the installation wizard

Linux, UNIX, Solaris

1. Create a new directory that will be the parent directory of the JDK installation directory, for example /usr/java
2. Switch to that directory
3. Extract downloaded file from step 1, for example gunzip -c jdk-8u45-linux-x64.tar.gz | tar xf -.

The installer will create a new sub-directory below the current directory, for example /usr/java/jdk1.8.0_45.

Solaris Solaris installations will already have the directory /usr/java, and this directory must not be used to install the Java for use with Fredhopper.

Step 3: Set the JAVA_HOME variable

In this step we will setup the JAVA_HOME environment variable to point to the installation directory of Java

JAVA_HOME and JRE_HOME Only the JAVA_HOME environment variable should be set, an additional JRE_HOME environment variable should not be set, or be set to the same value as JAVA_HOME.

Windows

1. Right click on the My Computer icon on your desktop and select properties
2. Click the Advanced Tab
3. Click the Environment Variables button
   
4. Under System Variable, click New
   
5. Enter the variable name as JAVA_HOME
6. Enter the variable value as the installation directory for Java, for example C:\Program Files\java\jdk1.8.0_45
   
7. Click OK
8. Click Apply Changes

Linux, UNIX, Solaris

1. Login to your account and open .bashrc file
   Unable to find source-code formatter for language: bash. Available languages are: actionscript, html, java, javascript, none, sql, xhtml, xml

   $ vi ~/.bashrc
   

   Add the following line to your .bashrc (where <path-to-java> is the path to the Java installation directory)

   Unable to find source-code formatter for language: bash. Available languages are: actionscript, html, java, javascript, none, sql, xhtml, xml

   export JAVA_HOME=<path-to-java>
   

   If the path to your java installation directory is /usr/java/jdk1.8.0_45, set it as follows:

   Unable to find source-code formatter for language: bash. Available languages are: actionscript, html, java, javascript, none, sql, xhtml, xml

   export JAVA_HOME=/usr/java/jdk1.8.0_45
   

2. Save the changes
   

   Please note that the file ~/.bash_profile is similar, with the exception that ~/.bash_profile runs only for Bash login shells and .bashrc runs for every new Bash shell. We must however add these paths to .bashrc, otherwise deployment scripts might not work.

Step 4: Set the PATH environment variable

In this step we will setup the PATH environment variable to include the bin directory of the Java installation. The PATH environment variable on your computer points to the directories the computer searches when looking for applications, such as the programs that enable you to run Java applications.

Windows

1. Right click on the My Computer icon on your desktop and select properties
2. Click the Advanced Tab
3. Click the Environment Variables button
   
4. Under System Variable, select the Path variable and click Edit
5. Navigate to the end of the Variable Value and add a ';' followed by the path to the bin sub-directory of the Java installation directory (for example %JAVA_HOME%\bin) to the end of the value.
   
6. Click OK
7. In the Environment Variable Window click OK

Linux, UNIX, Solaris

1. Login to your account and open .bashrc file
   Unable to find source-code formatter for language: bash. Available languages are: actionscript, html, java, javascript, none, sql, xhtml, xml

   $ vi ~/.bashrc
   

   Add the following line to your .bashrc to make all Java binaries available in the shell.

   Unable to find source-code formatter for language: bash. Available languages are: actionscript, html, java, javascript, none, sql, xhtml, xml

   export PATH=$JAVA_HOME/bin:$PATH
   

2. Save the changes and 'source' the .bashrc or login again to activate the PATH and JAVA_HOME.

Step 5: Validate your Java installation

You can use the following steps to verify that the installation of Java was successful.

Windows

Use the java -version command, as shown below, to verify the installed release. The command should be executed from a command prompt. You can open a command prompt by going to the Start Menu > Run, type cmd and hit enter. This will open a command prompt that u can use to validate your Java installation

C:\fredhopper>java -version
java version "1.8.0_45"
Java(TM) SE Runtime Environment (build 1.8.0_45-b16)
Java HotSpot(TM) 64-Bit Server VM (build 25.51-b03, mixed mode)

The output you see may be different from what is shown above because the java -version command outputs vendor-specific information.

Linux, UNIX, Solaris

Use the java -version command, as shown below, to verify the installed release:

$ java -version
java version "1.8.0_45"
Java(TM) SE Runtime Environment (build 1.8.0_45-b16)
Java HotSpot(TM) 64-Bit Server VM (build 25.51-b03, mixed mode)

The output you see may be different from what is shown above because the java -version command outputs vendor-specific information.

Next Steps

You can now continue with any of the following tasks

• Install, deploy and operate (on premise)
• Install the Fredhopper Data Manager