TSTool / Development Environment / Windows Oracle Java 8
- Introduction
- Download Oracle Java 8
- Install Oracle Java 8
- Create Symbolic Links for Oracle Java 8
- Confirm Oracle Java 8 Eclipse Run Script Configuration
Introduction
This documentation is an archive of old documentation that was used to set up the Java 8 development environment using Oracle Java 8 through TSTool 14.8.6, including discussion of 64-bit and 32-bit environments.
Oracle began charging a fee for Java Standard Edition as of January 2019. TSTool development was able to continue using the free version of Oracle Java. However, the free OpenJDK version was phased in as of TSTool 14.9.0 to avoid fees and allow Java to be updated to supported versions.
The links in this documentation may become unavailable as the Oracle web pages change.
Download Oracle Java 8
TSTool has traditionally been developed using Oracle Java. The major Java version (8) is important and otherwise the latest minor version can be downloaded to ensure support for recent operating systems and security patches.
Download the Java SE Development Kit from the Oracle Java Download Site.
The 64-bit version download file will be named jdk-8u112-windows-x64.exe or similar.
The 32-bit version (for older versions of TSTool) is named Windows x86 or similar and the download file will be named jdk-8u171-windows-i586.exe or similar.
Install Oracle Java 8
This documentation needs to be updatd for 64-bit Java. Edits have been made to folder locations to indicate 64-bit installation but images need to be updated.
Run the installer from the previous step. Administrator privileges will be required. The following procedure may vary slightly as new Java releases are made.
Java Installation - Welcome (see full-size image)
Press Next > to continue.
Java Installation - Custom Setup (see full-size image)
Accept the defaults in the above dialog without changing.
Note that since installing the 64-bit version the installation folder is C:\Program Files
(older 32-bit installation used C:\Program Files (x86)).
Other installations of Java may already exist on the computer, which is OK.
Press Next > to continue.
Java Installation - Destination Folder (see full-size image)
Accept the defaults in the above dialog without changing. Press Next > to continue. A progress indicator will be shown.
Java Installation - Complete (see full-size image)
Press Close to close the above dialog.
Create Symbolic Links for Oracle Java 8
64-bit Java
The Java installation process creates files as shown in the following image (the links are created in steps below).
Java Installation Folders (see full-size image)
The use of version-specific folder can be problematic because Eclipse Java Runtime Environment and build utilities must be configured to use the specific version. This may result in developers with different minor versions of Java flip-flopping repository contents. To minimize such issues, open a Windows command shell with Administrator privileges and create symbolic links as shown in the following image and summarized below. Actualy, Exclipse seems to traverse the link and use the specific resource in its environment, showing the full path rather than the link, but it is convenient nevertheless and is needed for the step below.
mklink /d jdk8 jdk1.8.0_191
mklink /d jre8 jre1.8.0_191
In addition, the automated build system uses JRE folder that requires another symbolic link to find the JRE to distribute with the installer.
Create the link as follows in the C:\Program Files\Java folder:
mklink /d jre_18 jre8
32-bit Java
The Java installation process creates files as shown in the following image.
Java Installation Folders (see full-size image)
The use of version-specific folder can be problematic because Eclipse Java Runtime Environment and build utilities must be configured to use the specific version. This may result in developers with different minor versions of Java flip-flopping repository contents. To minimize such issues, open a Windows command shell with Administrator privileges and create symbolic links as shown in the following image and summarized below. Actualy, Exclipse seems to traverse the link and use the specific resource in its environment, showing the full path rather than the link, but it is convenient nevertheless and is needed for the step below.
mklink /d jdk8 jdk1.8.0_171
mklink /d jre8 jre1.8.0_171
Java Symbolic Links (see full-size image)
In addition, the automated build system uses JRE folder that requires another symbolic link to find the JRE to distribute with the installer.
Create the link as follows in the C:\Program Files (x86)\Java folder:
mklink /d jre_18 jre8
Confirm Oracle Java 8 Eclipse Run Script Configuration
The order that Java and Eclipse are installed may vary. These major development environment components need to be configured appropriately and it is useful to use a run script to start Eclipse.