Building OpenJDK Version 8 with OpenJ9

Building OpenJDK 8 with OpenJ9 will be familiar to anyone who has already built OpenJDK. The easiest method involves the use of Docker and Dockerfiles to create a build environment that contains everything you need to produce a Linux binary of OpenJDK V8 with the Eclipse OpenJ9 virtual machine. If this method sounds ideal for you, go straight to the Linux 🐧 section.

Build instructions are available for the following platforms:

Linux 🐧
AIX 📘
Windows 📒
macOS 🍎
ARM 📱
AArch64

User documentation for the latest release of Eclipse OpenJ9 is available at the Eclipse Foundation. If you build a binary from the current OpenJ9 source, new features and changes might be in place for the next release of OpenJ9. Draft user documentation for the next release of OpenJ9 can be found here.

Linux

🐧 This build process provides detailed instructions for building a Linux x86-64 binary of OpenJDK V8 with OpenJ9 on Ubuntu 16.04. The binary can be built directly on your system, in a virtual machine, or in a Docker container 🐳.

If you are using a different Linux distribution, you might have to review the list of libraries that are bundled with your distribution and/or modify the instructions to use equivalent commands to the Advanced Packaging Tool (APT). For example, for Centos, substitute the apt-get command with yum.

If you want to build a binary for Linux on a different architecture, such as Power Systems™ or z Systems™, the process is very similar and any additional information for those architectures are included as Notes 📝 as we go along.

1. Prepare your system

🐧 Instructions are provided for preparing your system with and without the use of Docker technology.

Skip to Setting up your build environment without Docker.

Setting up your build environment with Docker 🐳

If you want to build a binary by using a Docker container, follow these steps to prepare your system:

The first thing you need to do is install Docker. You can download the free Community edition from here, which also contains instructions for installing Docker on your system. You should also read the Getting started guide to familiarise yourself with the basic Docker concepts and terminology.
Obtain the docker build script to build and run a container that has all the correct software pre-requisites.

Download the docker build script to your local system or copy and paste the following command:

wget https://raw.githubusercontent.com/eclipse/openj9/master/buildenv/docker/mkdocker.sh

Next, run the following command to build a Docker image, called openj9:

bash mkdocker.sh --tag=openj9 --dist=ubuntu --version=16.04 --build

Start a Docker container from the openj9 image with the following command, where -v maps any directory, <host_directory>, on your local system to the containers /root/hostdir directory so that you can store the binaries, once they are built:

docker run -v <host_directory>:/root/hostdir -it openj9

📝 Depending on your Docker system configuration, you might need to prefix the docker commands with sudo.

Now that you have the Docker image running, you are ready to move to the next step, Get the source.

Setting up your build environment without Docker

If you don't want to user Docker, you can still build directly on your Ubuntu system or in a Ubuntu virtual machine. Use the output of the following command like a recipe card to determine the software dependencies that must be installed on the system, plus a few configuration steps.

bash mkdocker.sh --tag=openj9 --dist=ubuntu --version=16.04 --print

Install the list of dependencies that can be obtained with the apt-get command from the following section of the Dockerfile:

apt-get update \
 && apt-get install -qq -y --no-install-recommends \
   ...

The previous step installed g++-7 and gcc-7 packages, which might be different than the default version installed on your system. Export variables to set the version used in the build.

export CC=gcc-7 CXX=g++-7

Download and setup freemarker.jar into a directory. The example commands use /root to be consistent with the Docker instructions. If you aren't using Docker, you probably want to store the freemarker.jar in your home directory.

cd /root
wget https://sourceforge.net/projects/freemarker/files/freemarker/2.3.8/freemarker-2.3.8.tar.gz/download -O freemarker.tgz
tar -xzf freemarker.tgz freemarker-2.3.8/lib/freemarker.jar --strip=2
rm -f freemarker.tgz

Download and setup the boot JDK using the latest AdoptOpenJDK v8 build.

cd /<my_home_dir>
wget -O bootjdk8.tar.gz "https://api.adoptopenjdk.net/v3/binary/latest/8/ga/linux/x64/jdk/openj9/normal/adoptopenjdk"
tar -xzf bootjdk8.tar.gz
rm -f bootjdk8.tar.gz
mv $(ls | grep -i jdk8) bootjdk8

2. Get the source

🐧 First you need to clone the Extensions for OpenJDK for OpenJ9 project. This repository is a git mirror of OpenJDK without the HotSpot JVM, but with an openj9 branch that contains a few necessary patches. Run the following command:

git clone https://github.com/ibmruntimes/openj9-openjdk-jdk8.git

Cloning this repository can take a while because OpenJDK is a large project! When the process is complete, change directory into the cloned repository:

cd openj9-openjdk-jdk8

Now fetch additional sources from the Eclipse OpenJ9 project and its clone of Eclipse OMR:

bash get_source.sh

📝 OpenSSL support: If you want to build an OpenJDK with OpenJ9 binary with OpenSSL support and you do not have a built version of OpenSSL v1.1.x available locally, you must specify --openssl-version=<version> where <version> is an OpenSSL level like 1.1.0 or 1.1.1. If the specified version of OpenSSL is already available in the standard location (SRC_DIR/openssl), get_source.sh uses it. Otherwise, the script deletes the content and downloads the specified version of OpenSSL source to the standard location and builds it. If you already have the version of OpenSSL in the standard location but you want a fresh copy, you must delete your current copy.

3. Configure

🐧 When you have all the source files that you need, run the configure script, which detects how to build in the current build environment.

bash configure --with-freemarker-jar=/root/freemarker.jar --with-boot-jdk=/usr/lib/jvm/adoptojdk-java-80

⚠️ You must give an absolute path to freemarker.jar

⚠️ The path in the example --with-boot-jdk= option is appropriate for the Docker installation. If not using the Docker environment, set the path appropriate for your setup, such as "/<my_home_dir>/bootjdk8" as setup in the previous instructions.

📝 Non-compressed references support: If you require a heap size greater than 57GB, enable a noncompressedrefs build with the --with-noncompressedrefs option during this step.

📝 OpenSSL support: If you want to build an OpenJDK that includes OpenSSL, you must specify --with-openssl={fetched|system|path_to_library}

where:

fetched uses the OpenSSL source downloaded by get-source.sh in step 2. Get the source.
system uses the package installed OpenSSL library in the system.
path_to_library uses a custom OpenSSL library that's already built.

If you want to include the OpenSSL cryptographic library in the OpenJDK binary, you must include --enable-openssl-bundling.

4. Build

🐧 Now you're ready to build OpenJDK V8 with OpenJ9:

make all

⚠️ If you just type make, rather than make all your build will be incomplete, because the default make target is exploded-image. If you want to specify make instead of make all, you must add --default-make-target=images when you run the configure script.

Two Java builds are produced: a full developer kit (jdk) and a runtime environment (jre)

build/linux-x86_64-normal-server-release/images/j2sdk-image
build/linux-x86_64-normal-server-release/images/j2re-image

🐳 If you built your binaries in a Docker container, copy the binaries to the containers /root/hostdir directory so that you can access them on your local system. You'll find them in the directory you set for <host_directory> when you started your Docker container. See Setting up your build environment with Docker.

📝 On other architectures the /j2sdk-image and /j2re-image directories are in build/linux-ppc64le-normal-server-release/images (Linux on 64-bit Power systems) and build/linux-s390x-normal-server-release/images (Linux on 64-bit z Systems)

5. Test

🐧 For a simple test, try running the java -version command. Change to the /j2re-image directory:

cd build/linux-x86_64-normal-server-release/images/j2re-image

Run:

./bin/java -version

Here is some sample output:

openjdk version "1.8.0-internal"
OpenJDK Runtime Environment (build 1.8.0-internal-admin_2017_10_31_10_46-b00)
Eclipse OpenJ9 VM (build 2.9, JRE 1.8.0 Linux amd64-64 Compressed References 20171031_000000 (JIT enabled, AOT enabled)
OpenJ9   - 68d6fdb
OMR      - 7c3d3d7
OpenJDK  - 27f5b8f based on jdk8u152-b03)

📝 OpenSSL support: If you built an OpenJDK with OpenJ9 that includes OpenSSL v1.1.x support, the following acknowledgements apply in accordance with the license terms:

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/).
This product includes cryptographic software written by Eric Young (eay@cryptsoft.com).

🐧 Congratulations! 🎉

AIX

📘

🚧 This section is still under construction. Further contributions expected.

The following instructions guide you through the process of building an OpenJDK V8 binary that contains Eclipse OpenJ9 on AIX 7.2.

1. Prepare your system

📘 You must install the following AIX Licensed Program Products (LPPs):

Java7_64
xlc/C++ 13.1.3
x11.adt.ext

A number of RPM packages are also required. The easiest method for installing these packages is to use yum, because yum takes care of any additional dependent packages for you.

Download the following file: yum_install_aix-ppc64.txt

This file contains a list of required RPM packages that you can install by specifying the following command:

yum shell yum_install_aix-ppc64.txt

It is important to take the list of package dependencies from this file because it is kept right up to date by our developers.

Download and setup freemarker.jar into your home directory by running the following commands:

cd /<my_home_dir>
wget https://sourceforge.net/projects/freemarker/files/freemarker/2.3.8/freemarker-2.3.8.tar.gz/download -O freemarker.tgz
tar -xzf freemarker.tgz freemarker-2.3.8/lib/freemarker.jar --strip=2
rm -f freemarker.tgz

2. Get the source

📘 First you need to clone the Extensions for OpenJDK for OpenJ9 project. This repository is a git mirror of OpenJDK without the HotSpot JVM, but with an openj9 branch that contains a few necessary patches. Run the following command:

git clone https://github.com/ibmruntimes/openj9-openjdk-jdk8.git

Cloning this repository can take a while because OpenJDK is a large project! When the process is complete, change directory into the cloned repository:

cd openj9-openjdk-jdk8

Now fetch additional sources from the Eclipse OpenJ9 project and its clone of Eclipse OMR:

bash get_source.sh

📝 OpenSSL support: If you want to build an OpenJDK with OpenJ9 binary with OpenSSL support and you do not have a built version of OpenSSL v1.1.x available locally, you must specify --openssl-version=<version> where <version> is an OpenSSL level like 1.1.0 or 1.1.1. If the specified version of OpenSSL is already available in the standard location (SRC_DIR/openssl), get_source.sh uses it. Otherwise, the script deletes the content and downloads the specified version of OpenSSL source to the standard location and builds it. If you already have the version of OpenSSL in the standard location but you want a fresh copy, you must delete your current copy.

3. Configure

📘 When you have all the source files that you need, run the configure script, which detects how to build in the current build environment.

bash configure --with-freemarker-jar=/<my_home_dir>/freemarker.jar \
               --with-cups-include=<cups_include_path> \
               --disable-warnings-as-errors

where <my_home_dir> is the location where you stored freemarker.jar and <cups_include_path> is the absolute path to CUPS. For example, /opt/freeware/include.

📝 Non-compressed references support: If you require a heap size greater than 57GB, enable a noncompressedrefs build with the --with-noncompressedrefs option during this step.

📝 OpenSSL support: If you want to build an OpenJDK that includes OpenSSL, you must specify --with-openssl={fetched|system|path_to_library}

where:

fetched uses the OpenSSL source downloaded by get-source.sh in step 2. Get the source.
system uses the package installed OpenSSL library in the system.
path_to_library uses a custom OpenSSL library that's already built.

If you want to include the OpenSSL cryptographic library in the OpenJDK binary, you must include --enable-openssl-bundling.

4. build

📘 Now you're ready to build OpenJDK with OpenJ9:

make all

⚠️ If you just type make, rather than make all your build will be incomplete, because the default make target is exploded-image. If you want to specify make instead of make all, you must add --default-make-target=images when you run the configure script.

Two Java builds are produced: a full developer kit (jdk) and a runtime environment (jre)

build/aix-ppc64-normal-server-release/images/j2sdk-image
build/aix-ppc64-normal-server-release/images/j2re-image

📝 A JRE binary is not currently generated due to an OpenJDK bug.

5. Test

📘 For a simple test, try running the java -version command. Change to the /j2sdk-image directory:

cd build/aix-ppc64-normal-server-release/images/j2sdk-image

Run:

./bin/java -version

Here is some sample output:

openjdk version "1.8.0-internal"
OpenJDK Runtime Environment (build 1.8.0-internal-admin_2017_10_31_10_46-b00)
Eclipse OpenJ9 VM (build 2.9, JRE 8 AIX ppc-64 Compressed References 20171031_000000 (JIT enabled, AOT enabled)
OpenJ9   - 68d6fdb
OMR      - 7c3d3d7
OpenJDK  - 27f5b8f based on jdk8u152-b03)

📝 OpenSSL support: If you built an OpenJDK with OpenJ9 that includes OpenSSL v1.1.x support, the following acknowledgements apply in accordance with the license terms:

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/).
This product includes cryptographic software written by Eric Young (eay@cryptsoft.com).

📘 Congratulations! 🎉

Windows

📒 The following instructions guide you through the process of building a Windows 64-bit OpenJDK V8 binary that contains Eclipse OpenJ9. This process can be used to build binaries for Windows.

1. Prepare your system

📒 You must install a number of software dependencies to create a suitable build environment on your system:

Cygwin for 64-bit versions of Windows, which provides a Unix-style command line interface. Install all packages in the Devel category. In the Archive category, install the packages zip and unzip. In the Utils category, install the cpio package. Install any further package dependencies that are identified by the installer. More information about using Cygwin can be found here.
Windows JDK 8, which is used as the boot JDK.
Windows SDK 7 Debugging tools.
Microsoft Visual Studio 2010 Professional.
Microsoft Visual Studio 2010 Service Pack 1
Freemarker V2.3.8
Freetype2 V2.3 or newer
LLVM/Clang 64bit
LLVM/Clang 32bit
NASM Assembler v2.13.03 or newer

Add the binary path of Clang to the PATH environment variable to override the older version of clang integrated in Cygwin. e.g.

export PATH="/cygdrive/c/LLVM/bin:$PATH" (in Cygwin for 64bit)
or
export PATH="/cygdrive/c/LLVM_32/bin:$PATH" (in Cygwin for 32bit)

Add the path to nasm.exe to the PATH environment variable to override the older version of NASM installed in Cygwin. e.g.

export PATH="/cygdrive/c/NASM:$PATH" (in Cygwin)

Update your LIB and INCLUDE environment variables to provide a path to the Windows debugging tools with the following commands:

set INCLUDE=C:\Program Files\Debugging Tools for Windows (x64)\sdk\inc;%INCLUDE%
set LIB=C:\Program Files\Debugging Tools for Windows (x64)\sdk\lib;%LIB%

Not all of the shared libraries that are included with Visual Studio 2010 are registered during installation. In particular, the msdia100.dll libraries must be registered manually. To do so, execute the following from a command prompt:

regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio 10.0\DIA SDK\bin\msdia100.dll"
regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio 10.0\DIA SDK\bin\amd64\msdia100.dll"

You can download Freemarker and Freetype manually or obtain them using the wget utility. If you choose to use wget, follow these steps:

Open a cygwin64 terminal and change to the /temp directory:

cd /cygdrive/c/temp

Run the following commands:

wget https://sourceforge.net/projects/freemarker/files/freemarker/2.3.8/freemarker-2.3.8.tar.gz/download -O freemarker.tgz
wget http://download.savannah.gnu.org/releases/freetype/freetype-2.5.3.tar.gz

To unpack the Freemarker and Freetype compressed files, run:

tar -xzf freemarker.tgz freemarker-2.3.8/lib/freemarker.jar --strip=2
tar --one-top-level=/cygdrive/c/temp/freetype --strip-components=1 -xzf freetype-2.5.3.tar.gz

Note: In order to build Windows 32-bit, Please enure the freetype version supports win 32-bit application (e.g. freetype-2.4.7 which includes the "win32" folder)

To build the Freetype dynamic and static libraries, open the Visual Studio Command Prompt (VS2010) (see C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Microsoft Visual Studio 2010\Visual Studio Tools) and run:

Win 64-bit

cd c:\temp
msbuild.exe C:/temp/freetype/builds/windows/vc2010/freetype.vcxproj /p:PlatformToolset=v100 /p:Configuration="Release Multithreaded" /p:Platform=x64 /p:ConfigurationType=DynamicLibrary /p:TargetName=freetype /p:OutDir="C:/temp/freetype/lib64/" /p:IntDir="C:/temp/freetype/obj64/" > freetype.log
msbuild.exe C:/temp/freetype/builds/windows/vc2010/freetype.vcxproj /p:PlatformToolset=v100 /p:Configuration="Release Multithreaded" /p:Platform=x64 /p:ConfigurationType=StaticLibrary /p:TargetName=freetype /p:OutDir="C:/temp/freetype/lib64/" /p:IntDir="C:/temp/freetype/obj64/" >> freetype.log

Win 32-bit

cd c:\temp
msbuild.exe C:/temp/freetype/builds/windows/vc2010/freetype.vcxproj /p:PlatformToolset=v100 /p:Configuration="Release Multithreaded" /p:PlatformTarget=x86 /p:ConfigurationType=DynamicLibrary /p:TargetName=freetype /p:OutDir="C:/temp/freetype/lib32/" /p:IntDir="C:/temp/freetype/obj32/" > freetype.log
msbuild.exe C:/temp/freetype/builds/windows/vc2010/freetype.vcxproj /p:PlatformToolset=v100 /p:Configuration="Release Multithreaded" /p:PlatformTarget=x86 /p:ConfigurationType=StaticLibrary /p:TargetName=freetype /p:OutDir="C:/temp/freetype/lib32/" /p:IntDir="C:/temp/freetype/obj32/" >> freetype.log

📝 Check the freetype.log for errors.

2. Get the source

📒 First you need to clone the Extensions for OpenJDK for OpenJ9 project. This repository is a git mirror of OpenJDK without the HotSpot JVM, but with an openj9 branch that contains a few necessary patches.

Run the following command in the Cygwin terminal:

git clone https://github.com/ibmruntimes/openj9-openjdk-jdk8.git

Cloning this repository can take a while because OpenJDK is a large project! When the process is complete, change directory into the cloned repository:

cd openj9-openjdk-jdk8

Now fetch additional sources from the Eclipse OpenJ9 project and its clone of Eclipse OMR:

bash get_source.sh

📝 OpenSSL support: If you want to build an OpenJDK with OpenJ9 binary with OpenSSL support and you do not have a built version of OpenSSL v1.1.x available locally, you must obtain a prebuilt OpenSSL v1.1.x binary.

3. Configure

📒 When you have all the source files that you need, run the configure script, which detects how to build in the current build environment.

Win 64-bit

bash configure --disable-ccache \
               --with-boot-jdk=/cygdrive/c/<path to_jdk8> \
               --with-freemarker-jar=/cygdrive/c/temp/freemarker.jar \
               --with-freetype-include=/cygdrive/c/temp/freetype/include \
               --with-freetype-lib=/cygdrive/c/temp/freetype/lib64

Win 32-bit

bash configure --disable-ccache \
               --with-boot-jdk=/cygdrive/c/<path_to_jdk8> \
               --with-freemarker-jar=/cygdrive/c/temp/freemarker.jar \
               --with-freetype-include=/cygdrive/c/temp/freetype/include \
               --with-freetype-lib=/cygdrive/c/temp/freetype/lib32  \
               --with-target-bits=32

📝 Modify the paths for freemarker and freetype if you manually downloaded and unpacked these dependencies into different directories.

📝 Non-compressed references support: If you require a heap size greater than 57GB, enable a noncompressedrefs build with the --with-noncompressedrefs option during this step.

📝 OpenSSL support: If you want to build an OpenJDK that includes OpenSSL, you must specify --with-openssl=path_to_library, where path_to_library specifies the path to the prebuilt OpenSSL library that you obtained in 2. Get the source. If you want to include the OpenSSL cryptographic library in the OpenJDK binary, you must also include --enable-openssl-bundling.

4. build

📒 Now you're ready to build OpenJDK with OpenJ9:

make all

⚠️ If you just type make, rather than make all your build will be incomplete, because the default make target is exploded-image. If you want to specify make instead of make all, you must add --default-make-target=images when you run the configure script.

Two Java builds are produced: a full developer kit (jdk) and a runtime environment (jre)

Win 64-bit

build/windows-x86_64-normal-server-release/images/j2sdk-image
build/windows-x86_64-normal-server-release/images/j2re-image

Win 32-bit

build/windows-x86-normal-server-release/images/j2sdk-image
build/windows-x86-normal-server-release/images/j2re-image

5. Test

📒 For a simple test, try running the java -version command. Change to the /j2sdk-image directory:

Win 64-bit

cd build/windows-x86_64-normal-server-release/images/j2sdk-image

Run:

./bin/java -version

Here is some sample output:

openjdk version "1.8.0_172-internal"
OpenJDK Runtime Environment (build 1.8.0_172-internal-administrator_2018_05_07_15_35-b00)
Eclipse OpenJ9 VM (build master-9329b7b9, JRE 1.8.0 Windows 7 amd64-64-Bit Compressed References 20180507_000000 (JIT enabled, AOT enabled)
OpenJ9   - 9329b7b9
OMR      - 884959f4
JCL      - 7f27c537a8 based on jdk8u172-b11)

Win 32-bit

cd build/windows-x86-normal-server-release/images/j2sdk-image

Run:

./jre/bin/java -version

Here is some sample output:

openjdk version "1.8.0_172-internal"
OpenJDK Runtime Environment (build 1.8.0_172-internal-administrator_2018_05_11_07_22-b00)
Eclipse OpenJ9 VM (build master-9f924a1a, JRE 1.8.0 Windows 7 x86-32-Bit 20180511_000000 (JIT enabled, AOT enabled)
OpenJ9   - 9f924a1a
OMR      - e5db96ba
JCL      - 7f27c537a8 based on jdk8u172-b11)

📝 OpenSSL support: If you built an OpenJDK with OpenJ9 that includes OpenSSL v1.1.x support, the following acknowledgements apply in accordance with the license terms:

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/).
This product includes cryptographic software written by Eric Young (eay@cryptsoft.com).

📒 Congratulations! 🎉

macOS

🍎 The following instructions guide you through the process of building a macOS OpenJDK V8 binary that contains Eclipse OpenJ9. This process can be used to build binaries to run on macOS 10.9.0 or later.

1. Prepare your system

🍎 You must install a number of software dependencies to create a suitable build environment on your system (the specified versions are minimums):

Xcode 10.3 (requires an Apple account to log in).
macOS OpenJDK 8, which is used as the boot JDK.

The following dependencies can be installed by using Homebrew:

autoconf 2.6.9
bash 4.4.23
binutils 2.32
cmake 3.4
freetype 2.9.1
git 2.19.2
gnu-tar 1.3
nasm 2.13.03
pkg-config 0.29.2
wget 1.19.5

Freemarker V2.3.8 is also required, which can be obtained and installed with the following commands:

wget https://sourceforge.net/projects/freemarker/files/freemarker/2.3.8/freemarker-2.3.8.tar.gz/download -O freemarker.tgz
gtar -xzf freemarker.tgz freemarker-2.3.8/lib/freemarker.jar --strip-components=2
rm -f freemarker.tgz

Bash version 4 is required by the ./get_source.sh script that you will use in step 2, which is installed to /usr/local/bin/bash. To prevent problems during the build process, make Bash v4 your default shell by typing the following commands:

# Find the <CURRENT_SHELL> for <USERNAME>
dscl . -read <USERNAME> UserShell

# Change the shell to Bash version 4 for <USERNAME>
dscl . -change <USERNAME> UserShell <CURRENT_SHELL> /usr/local/bin/bash

# Verify that the shell has been changed
dscl . -read <USERNAME> UserShell

2. Get the source

🍎 First you need to clone the Extensions for OpenJDK for OpenJ9 project. This repository is a git mirror of OpenJDK without the HotSpot JVM, but with an openj9 branch that contains a few necessary patches.

Run the following command:

git clone https://github.com/ibmruntimes/openj9-openjdk-jdk8.git

Cloning this repository can take a while because OpenJDK is a large project! When the process is complete, change directory into the cloned repository:

cd openj9-openjdk-jdk8

Now fetch additional sources from the Eclipse OpenJ9 project and its clone of Eclipse OMR:

bash get_source.sh

📝 OpenSSL support: If you want to build an OpenJDK with OpenJ9 binary with OpenSSL support and you do not have a built version of OpenSSL v1.1.x available locally, you must obtain a prebuilt OpenSSL v1.1.x binary.

3. Configure

🍎 When you have all the source files that you need, run the configure script, which detects how to build in the current build environment.

bash configure \
    TAR=gtar \
    --with-boot-jdk=<path_to_boot_JDK8> \
    --with-freemarker-jar=<PATH_TO_FREEMARKER_JAR> \
    --with-freetype-include=/usr/local/include/freetype2 \
    --with-freetype-lib=/usr/local/lib \
    --with-toolchain-type=clang

📝 Non-compressed references support: If you require a heap size greater than 57GB, enable a noncompressedrefs build with the --with-noncompressedrefs option during this step.

📝 OpenSSL support: If you want to build an OpenJDK that includes OpenSSL, you must specify --with-openssl=path_to_library, where path_to_library specifies the path to the prebuilt OpenSSL library that you obtained in 2. Get the source. If you want to include the OpenSSL cryptographic library in the OpenJDK binary, you must also include --enable-openssl-bundling.

4. build

🍎 Now you're ready to build OpenJDK with OpenJ9.

make all

⚠️ If you just type make, rather than make all your build will be incomplete, because the default make target is exploded-image. If you want to specify make instead of make all, you must add --default-make-target=images when you run the configure script.

📝 Because make all does not provide sufficient details for debugging, a more verbose build can be produced by running the command make LOG=trace all 2>&1 | tee make_all.log.

Four Java builds are produced, which include two full developer kits (jdk) and two runtime environments (jre):

build/macosx-x86_64-normal-server-release/images/j2sdk-image
build/macosx-x86_64-normal-server-release/images/j2re-image
build/macosx-x86_64-normal-server-release/images/j2sdk-bundle
build/macosx-x86_64-normal-server-release/images/j2re-bundle

📝For running applications such as Eclipse, use the -bundle versions.

5. Test

🍎 For a simple test, try running the java -version command. Change to the j2re-image directory:

cd build/macosx-x86_64-normal-server-release/images/j2re-image

Run:

./bin/java -version

Here is some sample output:

openjdk version "1.8.0_192-internal"
OpenJDK Runtime Environment (build 1.8.0_192-internal-jenkins_2018_10_17_11_24-b00)
Eclipse OpenJ9 VM (build master-2c817c52c, JRE 1.8.0 Mac OS X amd64-64-Bit Compressed References 20181017_000000 (JIT enabled, AOT enabled)
OpenJ9   - 2c817c52c
OMR      - 4d96857a
JCL      - fcd436bf56 based on jdk8u192-b03)

📝 OpenSSL support: If you built an OpenJDK with OpenJ9 that includes OpenSSL v1.1.x support, the following acknowledgements apply in accordance with the license terms:

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/).
This product includes cryptographic software written by Eric Young (eay@cryptsoft.com).

📒 Congratulations! 🎉

ARM

📱

🚧 We haven't created a full build process for ARM yet? Watch this space!

AArch64

🚧 Build process for AArch64 (ARMv8 64-bit) Linux does not support OpenJDK V8 at the time of writing this.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Build_Instructions_V8.md

Build_Instructions_V8.md

Building OpenJDK Version 8 with OpenJ9

Linux

1. Prepare your system

Setting up your build environment with Docker 🐳

Setting up your build environment without Docker

2. Get the source

3. Configure

4. Build

5. Test

AIX

1. Prepare your system

2. Get the source

3. Configure

4. build

5. Test

Windows

1. Prepare your system

2. Get the source

3. Configure

4. build

5. Test

macOS

1. Prepare your system

2. Get the source

3. Configure

4. build

5. Test

ARM

AArch64

Files

Build_Instructions_V8.md

Latest commit

History

Build_Instructions_V8.md

File metadata and controls

Building OpenJDK Version 8 with OpenJ9

Linux

1. Prepare your system

Setting up your build environment with Docker 🐳

Setting up your build environment without Docker

2. Get the source

3. Configure

4. Build

5. Test

AIX

1. Prepare your system

2. Get the source

3. Configure

4. build

5. Test

Windows

1. Prepare your system

2. Get the source

3. Configure

4. build

5. Test

macOS

1. Prepare your system

2. Get the source

3. Configure

4. build

5. Test

ARM

AArch64