The Java Runtime Environment (JRE) is essential to run IPS. Use the information in this topic to ensure your JRE is correct and up-to-date.
You must install the Java Runtime Environment (JRE) version 1.8 before you install IPS.
JRE 1.8 is often called Java 1.8, or Java 8. IPS supports Oracle JavaSE, OpenJDK and Amazon Corretto.
To check your Java version, do the following:
From the shell-terminal/command-prompt, enter the Java -version command.
Note the Java version number and then compare it to the information in the table below.
Minimum Java Requirements
|Java type||Minimum version number supported with IPS|
Note: If Java is not present, or the Java version number is lower than necessary, download the latest Java Runtime Environment (JRE) from your provider.
IPS and Java information
Provided you have Java 1.8 or above installed, IPS complies with mandates to remove SSL and early versions of TLS.
You cannot use IPS if the Java version is below 1.8
If you copy the Java Runtime Environment from an existing JRE folder (e.g. for a reference build or ‘gold’ build) you must set the path. Set the JRE path in the JAVA_HOME variable in /[local folder name]/setenv.bat(sh) file after IPS installation.
To make the older JRE path available to other applications, you must add the older JRE path to the start of the system PATH variable.
For information on how to set the system PATH variable, use this URL:
If the Java Development Kit (JDK) is installed, set the JAVA path in the system variable, for example
Note: You must have Microsoft XML4 (MSXML4) if you want to use IPS to print receipts direct to the printer. Download and install MSXML4 from: - http://www.microsoft.com/en-us/download/details.aspx?id=19662
To prepare Windows, do the following:
Download the appropriate Windows Java Runtime Environment (JRE) and install it. After the installation of JRE, a popup appears to uninstall the older version of Java.
If there are no other applications dependent on the older version of Java, uninstall the older Java application (recommended). If other applications depend on the older Java, follow the Java Path instructions below.
To prepare Linux, do the following:
Download the appropriate Linux Java Runtime Environment (JRE) and unzip it.
Run the commands below to set the Java path, replacing ‘JAVA_PATH’ with the location of the unzipped JRE folder.
update-alternatives --install "/usr/bin/java" "java" "/JAVA_PATH/bin/java" 1
update-alternatives --set java /JAVA_PATH /bin/java
Set JAVA_HOME problems
During IPS installation, the installer attempts to identify the location of JRE and set JAVA_HOME for IPS.
In some environments it may not do this. If there is a problem, locate the file
my_installation_path/YESEFT/setenv.bat (for Windows) or
my_installation_path/YESEFT/setenv.sh (for Linux). Then edit the file to set JAVA HOME to the location of the correct Java Runtime Environment (JRE).
Security and updates
For security reasons, keep your Java versions up to date.
The last free Java 8 update was in January 2019. In future you must pay a subscription fee to update your current version of Oracle Java 8.
Oracle offers a free version of Java called Open JDK (Java Development Kit) along with the paid version. But this free version only works with 64 bit operating systems. An alternative is Amazon’s long-term free support for Java 8 with Amazon Corretto. This production-ready Open JDK works on 32 bit and 64 bit operating systems; use the link below to download it:
If you run a 32 bit operating system on your Point of Sale (POS) system, Worldpay will continue to offer compatible IPS versions. But to update your Java you must use one of the following:
The 32 bit version of Java from Amazon Corretto
The Oracle subscription service for Java updates