Java Information

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.

Java

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:

  1. From the shell-terminal/command-prompt, enter the Java -version command.

  2. Note the Java version number and then compare it to the information in the table below.

Minimum Java Requirements

Java typeMinimum version number supported with IPC
Oracle JavaSE1.8.0_111
OpenJDK1.8.0_202
Amazon Corretto1.8.0_265

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.

IPC and Java information

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.

Java Path

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:

  • https://java.com/en/download/help/path.xml

If the Java Development Kit (JDK) is installed, set the JAVA path in the system variable, for example C:\Java\jdk.1.8.0_144\bin

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

Windows Information

To prepare Windows, do the following:

  1. 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.

  2. 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.

Linux Information

To prepare Linux, do the following:

  1. Download the appropriate Linux Java Runtime Environment (JRE) and unzip it.

  2. Run the commands below to set the Java path, replacing ‘JAVA_PATH’ with the location of the unzipped JRE folder.

  • Sudo update-alternatives --install "/usr/bin/java" "java" "/JAVA_PATH/bin/java" 1
  • Sudo update-alternatives --set java /JAVA_PATH /bin/java

Set JAVA_HOME problems

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).

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:

https://aws.amazon.com/corretto/

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