Changeset 35672 for main

Timestamp:

2021-10-23T17:12:12+13:00 (3 years ago)

Author:

davidb

Message:

Greenstone3 also uses the 'jre/lib/ext/jce.jar' extension, which we also need to make available to bootclasspath. More details in the READM.txt

Location:

main/trunk/release-kits/shared/core/java-rt

Files:

• README.txt (modified) (2 diffs)
• US_export_policy.jar (added)
• jce1_2_2.jar (added)
• local_policy.jar (added)
• sunjce_provider.jar (added)

main/trunk/release-kits/shared/core/java-rt/README.txt

@@ -7 +7 @@
 The purpose of this directory is to store such rt.jar files, which are
 then included into our compilation process through setting JAVACFLAGS
-appropriate.
+appropriate (using -bootclasspath).
 
-At the time of writing Greenstone3 targets JDK 1.6 as the oldest
+
+At the time of writing Greenstone3 targets JDK 1.8 as the oldest
 supported version.  Over time it is expected that we might start
 accumulating other versions of rt.jar here, and so this file has been
 named:
 
-  rt-openjdk6.jar
+  rt-openjdk8.jar
 
-which reflects that it is the OpenJDK Version 6 of rt.jar that has
+which reflects that it is the OpenJDK Version 8 of rt.jar that has
 been placed here. The actualy distribution of JDK used (OpenJDK)
 should not be relevant here, but is reflected in the filename chosen
@@ -25 +26 @@
   https://stackoverflow.com/questions/15492948/javac-source-and-target-options
 
+==
+
+An added extra wrinkle is we also need to deal with any jar files in
+jre/lib/ext (part of Java's extension mechanism) that are used by any
+Greenstone3 Java source code.  It turns out Greenstone3 admin tool uses
+javax.crypto package which means we also need to effectively add in
+'jce.jar' here.  Unlike rt.jar, this is *not* something that is expected
+to change over time, and forunately Oracle has a download for the extension:
+
+  https://www.oracle.com/java/technologies/java-archive-downloads-java-plat-downloads.html#
+
+At the time of writing, JCE-1.2.2
+
+Following the instructions included in the download, there are in fact 4 jar files that
+java/javac need access to to support the JCE extension:
+
+  jce1_2_2.jar  local_policy.jar sunjce_provider.jar  US_export_policy.jar
+
+These are provided there, and added in to the -bootclasspath part of JAVACFLAGS
+through rk-setup.bash