Java Installation in Jedox Setup

Windows OS

When installing the full Jedox Suite, including Integrator, Jedox Setup for Windows automatically downloads and installs OpenJDK during installation, creating a new folder \Jedox\Jedox Suite\jdk. This operation requires an active internet connection. Note that OpenJDK is only required when Integrator is installed with the Jedox setup.

Jedox 2022.2 requires Open JDK version 17 LTS. We support the Eclipse Temurin by Adoptium.

Even if OpenJDK is already installed elsewhere on the machine, Jedox will download and install a separate instance of it. Other JDK instances can run independent of the Jedox instance.

For installation on servers without internet access, Jedox setup searches for the package OpenJDKForJedox.zip in the same directory in which you will run the Jedox_2022_2.exe setup. Download the OpenJDK file version 17-LTS from here, move it to the same directory as the setup file, and rename it to OpenJDKForJedox.zip. Ensure that any attempts to connect to the Internet are disabled (turn off Wi-Fi, etc.) and run the setup file. If you receive an error that the package cannot be found, proceed as follows:

  • Verify that the file path \Program Files (x86)\Jedox\Jedox Suite\jdk exists
    • If the path does not exist, create it manually
    • If the path exists, create a backup of the Jedox Suite folder to a different directory and do not delete it
  • Extract the downloaded OpenJDK file and move / replace all files from the folder jdk-17.x.x+x to the folder \Program Files (x86)\Jedox\Jedox Suite\jdk
  • Run the Jedox_2022_2.exe setup file

If setenv.bat requires changes, you must execute the scripts serviceRemove.bat and serviceInstall.bat in <Install_path>\tomcat\bin (with administrative rights) for reinitialization of JedoxSuiteTomcatService.

Important: you must back up your installation files and data before starting the Jedox Setup. The update installation can overwrite manually changed configuration files. Therefore, you should have a backup from which to restore them.

Linux OS

It is recommended to update Java when Jedox Suite is not running and you have an active internet connection. Follow the steps below.

  1. Enter the command sudo mount -o bind /dev/ $INSTALL_PATH/dev/
  2. Change into chroot: chroot $INSTALL_PATH
  3. Call the command:
    > curl -L https://api.adoptium.net/v3/binary/latest/17/ga/linux/$(echo $(uname -m) | sed s/x86_64/x64/)/jdk/hotspot/normal/eclipse | tar -xz -C /usr/lib/jvm

    There must be now a directory like /usr/lib/jvm/jdk-17.x.x+x

  4. Call these commands with the correct JDK directory:
    update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk-17.x.x+x/bin/java 1000

    update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/jdk-17.x.x+x/bin/javac 1000

    update-alternatives --install /usr/lib/jvm/jdk jdk /usr/lib/jvm/jdk-17.x.x+x 1000

  5. Exit from chroot.

  6. Enter the command: sudo umount $INSTALL_PATH/dev/

When there is no active internet connection, you will have to obtain the binaries and manually copy the archive to the machine. For downloading the OpenJDK archive, check the target system for which machine architecture is used. Download the package depending on the machine architecture i.e. Linux x86-64 or Linux x64. You will get a *.tar.gz file.
Jedox 2022.2 requires Open JDK version 17 LTS. We support the Eclipse Temurin by Adoptium.

See also: Software Requirements

Updated November 18, 2024