Support for IBM Semeru JDK

[JoelProminic]

@JustinProminic revisited the idea that we should be using the same version of Java that Domino uses when compiling Domino Java code. The main target for this is the pending domino-integration feature for moonshine-dev, but this would affect at least:

• domino_java_tools
• NSFODP
• run_dxl_importer.sh (DXL Importer, used by Moonshine-IDE)
• lotusscript_compiler (Pending)

However, we found that Domino 14 only included the JRE (see /opt/hcl/domino/bin/java), so it didn't include javac.

@MarkProminic talked to David Kern at IBM, and we got this clarification:

Here's what I've received:

IBM Semeru doesn't include javac in JRE and the compiler tools/packages are available with JDK only in Java17/21. ND 14.5 is using Java 21.
This change would have happened with ND14.0 itself.
Yes - the customer can download full IBM Semeru OpenJDK Open Edition for their Development needs.

So it sounds like you can download the JDKs corresponding to the JREs in Domino 14.0 or 14.5 to acquire all of the relevant development tools.

We can find IBM Semeru here: https://developer.ibm.com/languages/java/semeru-runtimes/downloads/

This download is public, so we should be able to just download the desired version.

I will need to run some tests with the above Java cases to see if they will work with the new JDK. In previous versions of Domino, we were restricted to JDK 8 (though I see there is an IBM Semeru JDK 8 build as well that we may want to consider using).

[JoelProminic]

I started some tests with domino_java_tools, since is the easist to work with.

I found that the current version of Gradle, 5.4.1, fails with this error:

FAILURE: Build failed with an exception.

* What went wrong:
Could not create service of type ScriptPluginFactory using BuildScopeServices.createScriptPluginFactory().
> Could not create service of type CrossBuildFileHashCache using BuildSessionScopeServices.createCrossBuildFileHashCache().

We need a newer version of Gradle for compatibility with the newer JDK versions.

• JDK 17: Gradle 7.3+. Moonshine-IDE currently uses 7.5.1 to support OpenJDK 17
• JDK 21: Gradle 8.5+

[JoelProminic]

Steps for domino_java_tools

# JDK install
sudo mkdir /opt/jdk
sudo chown java_user:java_group /opt/jdk
cd /opt/jdk/
wget https://github.com/ibmruntimes/semeru17-binaries/releases/download/jdk-17.0.14%2B7_openj9-0.49.0/ibm-semeru-open-jdk_x64_linux_17.0.14_7_openj9-0.49.0.tar.gz
tar xzvf ibm-semeru-open-jdk_x64_linux_17.0.14_7_openj9-0.49.0.tar.gz 

# Gradle update
sdk install gradle 7.5.1
export JAVA_HOME=/opt/jdk/jdk-17.0.14+7/

# Preparing project:
cd ~
cp -r /vagrant/ansible_collections/startcloud/hcl_roles/roles/domino_java_tools/files domino_java_tools
sudo chown -R java_user:java_group domino_java_tools/
cd domino_java_tools/
cp /vagrant/installers/domino-java-helpers/gradle.properties .
gradle clean
gradle clean jarIndividual

I initially got some errors that previously indicated that we need to use JDK 8. For example, this CORBA error:

/local/notesjava/domino_java_tools/src/main/java/net/prominic/domino/vagrant/CheckDatabase.java:75: error: cannot access UserException
    public static void checkServer(Session session, String serverName) throws NotesException, Exception {
                       ^
  class file for org.omg.CORBA.UserException not found

However, this problem cleared after I did more testing on the dependencies. I don't think I changed anything, so this may have just be an issue where the old build wasn't properly cleaned.

[JoelProminic]

I did a quick test with running Moonshine-LotusScript-Compiler with IBM Semeru JDK. To update this, you need to update the executable path in /etc/systemd/system/lscompile.service and the environment in /local/notesjava/LotusScriptCompile/environment. I have templates for both of these already.

However, this failed at runtime with a CORBA error. This makes sense, since the JAR itself was built with JDK still. I'll retest this once I get the build working in the provisioners.

Apr 02 17:54:43 staging.startcloud.com java[275884]: Caused by: java.lang.ClassNotFoundException: org.omg.CORBA.UserException
Apr 02 17:54:43 staging.startcloud.com java[275884]:         at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:827)
Apr 02 17:54:43 staging.startcloud.com java[275884]:         at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188)
Apr 02 17:54:43 staging.startcloud.com java[275884]:         at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:1095)
Apr 02 17:54:43 staging.startcloud.com java[275884]:         ... 43 more