The Java Runtime Environment (JRE) is essential to run IPC. 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 IPC.
JRE 1.8 is often called Java 1.8, or Java 8. IPC 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.
|Java type||Minimum version number supported with IPC|
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.
Provided you have Java 1.8 or above installed, IPC complies with mandates to remove SSL and early versions of TLS.
You cannot use IPC 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 IPC 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 IPC 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
During IPC installation, the installer attempts to identify the location of JRE and set JAVA_HOME for IPC.
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).
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 IPC 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
Feedback or bugs to report?
Ask our developer community.
Search our documentation, API references and articles.