06.05.2025
10:21
Dear Community,
I’d like to share a potential issue I encountered during the upgrade to WEBCON BPS 2025 R2, specifically related to the Search Server component. I hope this post can save others some time and effort.
🔍 Problem Summary
During the upgrade process, the Search Server component fails to start due to a missing Java installation. This occurs even if Java was installed previously via the default WEBCON setup using OpenJDK.
⚠️ Root Cause
1. The upgrade process deletes the entire WEBCON BPS Search Server folder (e.g., C:\Program Files\WEBCON\WEBCON BPS Search Server), which, in my case, also contained the bundled Java installation.
2. The Java folder is not restored or re-copied during the Solr/Search Server update phase.
3. As a result, when the setup attempts to launch the Search Server, it fails due to a missing JAVA_HOME or JRE_HOME, as seen in the Solr logs.
✅ Workarounds
You can resolve or avoid this issue using one of the following methods:
Option 1 – Recommended:
• Install or copy Java (e.g., OpenJDK) to a separate directory (not inside the WEBCON BPS Search Server folder).
• Update the JRE_HOME system environment variable to point to this location.
• Restart the upgrade of Solr (done automatically after fail)
Option 2 – Timing-Based Fix (Advanced):
• As soon as the WEBCON BPS Search Server folder is recreated during setup, quickly copy Java back into it before the Search Server tries to start (you’ll have around 10–15 seconds).
• This works but requires precise timing and is more of a temporary hack.
Hope this helps someone in case of similar issue.
Best.
