Setting up JasperReports Server 8.0.3 to use Java 11 on Windows

WorldServer 11.8 uses Java 17; however, JasperReports Server 8.0.3 (delivered in WorldServer 11.8.0 and 11.8.1) is not compatible with this version of Java. If you want to use JasperReports Server 8.0.3 on a machine that uses a version of Java other than version 11, configure JRS to use Java 11.

About this task

Common use cases:
I want to...Does this procedure apply to me?Notes
Install JasperReports Server from scratch and run WorldServer and JasperReports Server on the same machine.YESYour WorldServer instance already uses Java 17, so you need to configure JasperReports Server to run on Java 11.
Install JasperReports Server from scratch and run WorldServer and JasperReports Server on different machines.NOInstall Java 11 on the JasperReports Server machine and follow the main installation procedure. The JasperReports Server machine will use Java 11, whereas the WorldServer machine will use Java 17.
Upgrade to WorldServer 11.8.0 or 11.8.1. WorldServer and JasperReports Server are currently running on the same machine.YESInstall Java 17 on your machine for WorldServer 11.8.0 or 11.8.1 to work, and then configure JasperReports Server to run on Java 11.
Upgrade to WorldServer 11.8.0 or 11.8.1. WorldServer and JasperReports Server are currently running on different machines.NOUpgrade to WorldServer 11.8.0 or 11.8.1 on the WorldServer machine. Then, depending on the version of JasperReports Server you are currently using, upgrade JasperReports Server to version 8.0.3 on the JasperReports Server. If you are upgrading from version 7.5 to version 7.9, for example, your JasperReports Server machine already uses Java 11.

Procedure

  1. Open a command prompt as an administrator.
  2. Temporarily change the JAVA_HOME and PATH environment variables so that the JasperReports Server installation process uses Java Runtime Environment 11:
    set JAVA_HOME=c:\Jasper\jasperreports-server-8.0.3-bin\Reports\jre-windows
    set Path=%JAVA_HOME%\bin;%Path%
    Java Runtime Environment 11 is provided in the WorldServer 11.8.0 or 11.8.1 distribution kits, under <js-install>\Reports\jre-windows.
  3. Check your Java version: java -version
    The response should be similar to the following:
    openjdk version "11.0.18" yyyy-mm-dd
    OpenJDK Runtime Environment Temurin-11.0.18+10 (build 11.0.18+10)
    OpenJDK 64-Bit Server VM Temurin-11.0.18+10 (build 11.0.18+10, mixed mode)

What to do next

Follow the main installation procedure and skip the Java installation commands.