Migration Guide | Adoptium

Migration Guide

Migrating to Eclipse Temurin

If you are moving from Oracle JDK to OpenJDK from the Adoptium project, you’ll probably have a few key questions on your mind. Firstly, you’ll want to know what the differences are between Oracle JDK and Temurin and whether there are any steps you need to take to migrate. The answers to common questions around these choices are covered in the sections that follow.

Migrating from Oracle JDK

The following table illustrates the proprietary components that can be found in Oracle JDK 8 and the alternative technologies that are either planned or available to replace them. Click on the links to learn more about each component and any steps that might be necessary to adopt them.

[check] - Supported, [times] - Not Supported

Oracle JDK 8 proprietary component Alternative component OpenJDK 8 OpenJDK 11

Java Web Start

IcedTea-Web

[check]

[times]

JavaFX

OpenJFX

[times]

[check]

T2K font rendering engine

Freetype

[check]

[check]

Monotype Lucida fonts

Relicensed Lucida fonts

[times] (coming soon)

[times] (coming soon)

Ductus 2D renderer

Pisces/Marlin

[check] (Pisces)

[check] (Marlin)

Kodac Color Matching System (KCMS) library

LCMS

[check]

[check]

SNMP

Use JMX (or SNMP4J)

[check] (not bundled)

[check] (not bundled)

Sound drivers

Use Windows sound drivers

[check] (not bundled)

[check] (not bundled)

Java Flight Recorder (JFR)

Java Flight Recorder

[check]

[check]

Java Mission Control (JMC)

Use Eclipse Mission Control

[check]

[check]

IcedTea-Web

Java Web Start was deprecated by Oracle in Java SE 8 and removed in Java SE 9. IcedTea-Web can provide equivalent functionality for Temurin 8 users.

IcedTea-Web is available to download from the Iced-Tea Web project page in Linux, Windows, macOS and Portable package formats.

Use IcedTea-Web in the same way as Java Web Start. For more information, see Developing a Java Web Start application and Deploying a Java Web Start application. Whilst IcedTea-Web is written to operate in the same way as Java Web Start there are a few known differences, which are raised as issues in the GitHub project. Work is ongoing to minimize or eliminate these differences.

IcedTea-Web 1.8.x and 2.0.x are compatible with Temurin 8 builds. We know that software which is based on IcedTea-Web supports the execution of OpenJDK 11 based JNLP applications but IcedTea-Web does not contain any tests to check OpenJDK 11 support and we do not bundle it with Temurin 11 builds.

OpenJFX

Back in 2017, JavaFX was decoupled from the Oracle JDK and contributed to the OpenJDK community. The OpenJFX community is focused on OpenJFX 11+ and provides binaries that you can use with Temurin.

OpenJFX 8 is no longer being actively maintained. If you need this capability, we recommend upgrading to OpenJFX 11.

Freetype font rendering library

OpenJDK uses the open source FreeType font rendering library instead of the proprietary T2K font library.

Relicensed Lucida fonts

The Lucida fonts that are available in Oracle JDK 8 have a proprietary 3rd party license. Adoptium intend to provide relicensed Lucida fonts. Work is ongoing to minimize any display issues when these fonts are rendered by Freetype.

Pisces and Marlin

Oracle JDK 8 uses a proprietary 2D graphics renderer called Ductus, whereas OpenJDK uses an open-source renderer called Pisces. From OpenJDK 9, the Marlin renderer is in use. Work is planned at Adoptium to either backport Marlin to OpenJDK 8 and/or minimize any display issues between the two.

LCMS

OpenJDK uses the Little Color Matching System (LCMS) open source open source library instead of the proprietary Kodac CMS library.

JMX

The proprietary SNMP package shipped with Oracle JDK 8 is not present in OpenJDK. Use JMX as an alternative, or SNMP4J. These packages are not bundled with the Temurin binaries.

Windows sound drivers

Oracle JDK provides native sound drivers for Java 8 on Windows, which are not present in OpenJDK. Use the sound drivers that are available with Microsoft Windows instead.

Java Flight Recorder

Java Flight Recorder (JFR) was decoupled from the Oracle JDK and contributed to the OpenJDK community. JFR is included in all versions of Temurin.

Eclipse Mission Control

The Eclipse Mission Control project provides a download JMC which is available from the Download Page.


Contributors

  • gdams
  •  karianna
  •  SueChaplain
  •  hendrikebbers
  •  sxa555
  •  ParkerM
  •  jiekang
  •  HanSolo
  •  MBoegers
Help us make these docs great!
All Adoptium docs are open source. See something that's wrong or unclear?
Edit this page