When upgrading to 15.5.1 from a release prior to 15.5.0, the upgrade will fail because of an incorrect use of the wrong version of the JDK during the upgrade process. This is a defect DE45971 In order to get around this the following process can be used.
Workaround for direct upgrade to 15.5.1:
1. Prepare the release-install.properties file
Each release hop can be given a set of properties to use during the upgrade. In this case we want to specify the location of JDK8 for the upgrades to use.
java_home=<full path to the root of the jdk 8 installation>
- Create a file called release-install.properties in a convenient location on the same machine the upgrade is being done on. Add the following line to it and save the file:
For example, let’s say that on my Windows machine my Jdk 8 installation is under c:\jdks\jdk1.8.0_171. My release-install.properties file would contain (note the escaped path separators):
Linux example file content:
2. Begin the upgrade
Start the 15.5.1 upgrade install script. After being prompted for and giving the location of the ‘Third Party Libraries Jar Directory’ we should copy over the release-install properties file to the upgrade directories. As an example, let’s say I am upgrading from 15.4.0. I will see something like this in the command prompt window:
Third Party Libraries Jar Directory [c:] : c:\deploy\tplib
You chose the following:
thirdparty.libs.jar.dir = c:\deploy\tplib
Copying 1 file to c:
Created dir: c:\deploy\tplibsdir
Expanding: c:\deploy\thirdparty.libs.15.5.1.jar into c:\deploy\tplibsdir
Current version: 126.96.36.1990
Expanding: c:\deploy\install-packages\15.4.1\upgrade-repack.188.8.131.52tpexcludes.jar into c:\deploy\install-packages\15.4.1\upgrade-repack.184.108.40.206tpexcludes
Expanding: c:\deploy\install-packages\15.5.0\upgrade-repack.220.127.116.11tpexcludes.jar into c:\deploy\install-packages\15.5.0\upgrade-repack.18.104.22.168tpexcludes
You need to copy the release-install properties into each of the directories that were created through the expansion of the jar files,
3. Continue the upgrade
At this point, the command should be waiting for user inputs to continue the upgrade. When prompted for the ‘J2SDK Home Directory’ give the full path to the root of the JDK 11 installation.