Troubleshooting Common Problems When Upgrading the JRE

The latest version of Xeams allows you to upgrade the JRE from the web interface. This page talks about the steps Xeams takes in the background and a few common troubleshooting tips.

The Goal

The goal is simple: replace the existing $INSTALL_DIR\jre folder with a newer copy of the JRE. However, a few additional steps are needed before replacing this folder. These steps are:

  • Downloading the JRE files
  • Downloading an additional JAR file called lib4njre.jar from the Synametrics Website. This file goes in the $INSTALL_DIR\libs folder. This step is only needed when upgrading from JRE 8 to the latest version. If you're using an older version of JRE 21, this file may already be there.
  • Uninstall and reinstall the service on Windows. This step is only needed on Windows (not Linux) and only if lib4njre.jar was missing prior to upgrading.

Common Troubleshooting Tip

The following tips assume that you had backed up the jre and lib folders as instructed on the screen. Since you ran into a problem, you have now switched the folders so the older version is now in use and Xeams is up and running.

Problem # 1 - Xeams does not come up at all after upgrading

This means Xeams was unable to download the JRE files, or they were corrupted. Try downloading them manually using the links below. After downloading, check the MD5 signature to confirm they have not been modified. The download links are:

Problem # 2 - Xeams comes up but runs into a problem during startup

This occurs when lib4njre.jar is either missing or corrupted. Download this file manually from the link below, place it in the lib folder, and restart.


Contact support via email if none of the options work.