Changes/Java8

From FedoraProject

< Changes(Difference between revisions)
Jump to: navigation, search
(Add tracker bug)
(Update page with latest information and packaging changes and decisions.)
Line 22: Line 22:
 
== Current status ==
 
== Current status ==
 
* Targeted release: [[Releases/21 | Fedora 21 ]]  
 
* Targeted release: [[Releases/21 | Fedora 21 ]]  
* Last updated: 2014-03-19
+
* Last updated: 2014-04-28
 
<!-- After the change proposal is accepted by FESCo, tracking bug is created in Bugzilla and linked to this page  
 
<!-- After the change proposal is accepted by FESCo, tracking bug is created in Bugzilla and linked to this page  
 
Bugzilla states meaning as usual:
 
Bugzilla states meaning as usual:
Line 36: Line 36:
 
<!-- Expand on the summary, if appropriate.  A couple sentences suffices to explain the goal, but the more details you can provide the better. -->
 
<!-- Expand on the summary, if appropriate.  A couple sentences suffices to explain the goal, but the more details you can provide the better. -->
  
The current default Java 7 runtime in Fedora is OpenJDK 7. The latest version of OpenJDK, 8, was released on 18 March 2014. Given that Fedora 21 will not be released before August, it makes sense to include the latest version of OpenJDK in Fedora 21.
+
The current default Java 7 runtime in Fedora is OpenJDK 7. The latest version of OpenJDK, 8, was released on 18 March 2014. Given that Fedora 21 will not be released before October 2014, it makes sense to include the latest version of OpenJDK in Fedora 21.
  
 
OpenJDK 8 is a significant update to Java. It brings in significant new features to the Java language, including lambdas, a new javascript engine and lots of new library features. A [http://openjdk.java.net/projects/jdk8/features complete list of features] is available.
 
OpenJDK 8 is a significant update to Java. It brings in significant new features to the Java language, including lambdas, a new javascript engine and lots of new library features. A [http://openjdk.java.net/projects/jdk8/features complete list of features] is available.
Line 44: Line 44:
 
* Packages that rely on non-public OpenJDK API may fail to build/run.
 
* Packages that rely on non-public OpenJDK API may fail to build/run.
  
A complete [http://www.oracle.com/technetwork/java/javase/8-compatibility-guide-2156366.html list of incompatibilities is available]. The incompatibilities are source and behavioural only.
+
A complete [http://www.oracle.com/technetwork/java/javase/8-compatibility-guide-2156366.html list of incompatibilities is available].
  
It may be a good idea to mass rebuild Java packages against OpenJDK 8 to spot any source incompatibilities earlier. This is not required.
+
Scratch and side-builds will be done (against OpenJDK 8) for most Java packages to spot any source incompatibilities earlier.
  
 
== Benefit to Fedora ==
 
== Benefit to Fedora ==
Line 53: Line 53:
 
Shipping the latest version of OpenJDK works towards the Fedora goal of "First". OpenJDK 8 brings significant new features to the Java language and libraries and platform. Soon, programmers will want to use these Java features and Fedora should provide them. Sooner or later, upstream projects will start to require Java 8.  
 
Shipping the latest version of OpenJDK works towards the Fedora goal of "First". OpenJDK 8 brings significant new features to the Java language and libraries and platform. Soon, programmers will want to use these Java features and Fedora should provide them. Sooner or later, upstream projects will start to require Java 8.  
  
If what happened with OpenJDK 6 is going to repeat, then development of OpenJDK 7 will stop before (or just around the time) Fedora 21 is End-of-Life'ed and security patches may not be backported to OpenJDK 7 (or if they are, they will be significantly delayed). If Fedora 21 ships with OpenJDK 7, this will leave users vulnerable to exploits.
+
Fedora 21 will probably End-of-life around early 2016 (around when F23 is released). OpenJDK 7 will publicly End-of-life [http://mail.openjdk.java.net/pipermail/jdk7u-dev/2014-January/008242.html in April 2015]. Security patches may not be backported to OpenJDK 7 (or if they are, they will be significantly delayed). If Fedora 21 ships with OpenJDK 7, this will leave users vulnerable to exploits.
  
 
== Scope ==
 
== Scope ==
Line 61: Line 61:
 
<!-- What work do the feature owners have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?-->
 
<!-- What work do the feature owners have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?-->
 
** Deprecate/Obsolete <code>java-1.7.0-openjdk</code>
 
** Deprecate/Obsolete <code>java-1.7.0-openjdk</code>
** Promote <code>java-1.8.0-openjdk</code> to a full java runtime status (fix provides in package)
+
** Promote <code>java-1.8.0-openjdk</code> to a full java runtime status (Done)
** In case of a mass rebuild, supply/apply patches to fix build against OpenJDK 8
+
** In case of a mass rebuild, supply/apply patches to fix build against OpenJDK 8 (WIP)
  
 
* Other developers:
 
* Other developers:
 
<!-- What work do other developers have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?-->
 
<!-- What work do other developers have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?-->
** <code>icedtea-web</code> maintainers will need to update <code>icedtea-web</code> to run against OpenJDK 8
+
** <code>icedtea-web</code> maintainers will need to update <code>icedtea-web</code> to run against OpenJDK 8 (TODO)
** Other java packagers will need to apply patches to their java package to ensure they can build against OpenJDK 8
+
** Other java packagers will need to apply patches to their java package to ensure they can build against OpenJDK 8 (WIP)
** Everyone will need to test packages to verify that they work against OpenJDK 8
+
** Everyone will need to test packages to verify that they work against OpenJDK 8 (WIP)
  
 
* Release engineering:
 
* Release engineering:
 
<!-- Does this feature require coordination with release engineering (e.g. changes to installer image generation or update package delivery)?  Is a mass rebuid required?  If a rel-eng ticket exists, add a link here.  -->
 
<!-- Does this feature require coordination with release engineering (e.g. changes to installer image generation or update package delivery)?  Is a mass rebuid required?  If a rel-eng ticket exists, add a link here.  -->
 
** Remove <code>java-1.7.0-openjdk</code>
 
** Remove <code>java-1.7.0-openjdk</code>
** Possibly mass-rebuild (?) all Java packages. This is not strictly required to make OpenJDK 8 the default Java runtime.
 
  
 
* Policies and guidelines:  
 
* Policies and guidelines:  
 
<!-- Do the packaging guidelines or other documents need to be updated for this feature?  If so, does it need to happen before or after the implementation is done?  If a FPC ticket exists, add a link here. -->
 
<!-- Do the packaging guidelines or other documents need to be updated for this feature?  If so, does it need to happen before or after the implementation is done?  If a FPC ticket exists, add a link here. -->
** Many <code>-javadoc</code> packages fail to build. The OpenJDK 8 maintainers and the Java SIG are working on identifying a solution. The solution may require [https://lists.fedoraproject.org/pipermail/devel/2014-March/196808.html guideline changes making <code>-javadoc</code> subpackages optional].
+
** N/A
  
 
== Upgrade/compatibility impact ==
 
== Upgrade/compatibility impact ==
Line 119: Line 118:
  
 
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 +
 +
The OpenJDK packages will need to be updated/removed:
 +
* java-1.7.0-openjdk
 +
* java-1.8.0-openjdk
 +
 +
OpenJDK 8 depends on various system libraries, but no new changes are required to other packages. In fact, a non-default version of <code>java-1.8.0-openjdk</code> is available on older Fedora releases too.
  
 
== Contingency Plan ==
 
== Contingency Plan ==
Line 126: Line 131:
 
** Leave OpenJDK 7 as the default Java SDK and runtime.
 
** Leave OpenJDK 7 as the default Java SDK and runtime.
 
** Ship OpenJDK 8 as a leaf package.
 
** Ship OpenJDK 8 as a leaf package.
** *If* a mass rebuild was done, rebuild Java packages against OpenJDK 7
+
** For packages that were rebuilt against OpenJDK 8, rebuild them against OpenJDK 7
 
* Contingency deadline: 2014-08-01
 
* Contingency deadline: 2014-08-01
 
* Blocks release? No
 
* Blocks release? No

Revision as of 21:31, 28 April 2014

Contents

Java 8

Summary

Make Java 8 (provided by OpenJDK 8 which is java-1.8.0-openjdk) the default Java runtime. The current default Java runtime (Java 7, provided by OpenJDK 7, java-1.7.0-openjdk) will be obsoleted and removed.

This is essentially an upgrade to the latest Java and OpenJDK version.

Owner

  • Name: Omair Majid
  • Email: omajid@redhat.com
  • Release notes owner:

Current status

Detailed Description

The current default Java 7 runtime in Fedora is OpenJDK 7. The latest version of OpenJDK, 8, was released on 18 March 2014. Given that Fedora 21 will not be released before October 2014, it makes sense to include the latest version of OpenJDK in Fedora 21.

OpenJDK 8 is a significant update to Java. It brings in significant new features to the Java language, including lambdas, a new javascript engine and lots of new library features. A complete list of features is available.

OpenJDK 8 is a backwards compatible update. Theoretically everything that worked against OpenJDK 7 should continue working against OpenJDK 8. There are a few exceptions:

  • OpenJDK8 is much more strict when it comes to building javadocs. Many -javadoc package in Fedora fail to build. Those that are built should continue working just fine.
  • Packages that rely on non-public OpenJDK API may fail to build/run.

A complete list of incompatibilities is available.

Scratch and side-builds will be done (against OpenJDK 8) for most Java packages to spot any source incompatibilities earlier.

Benefit to Fedora

Shipping the latest version of OpenJDK works towards the Fedora goal of "First". OpenJDK 8 brings significant new features to the Java language and libraries and platform. Soon, programmers will want to use these Java features and Fedora should provide them. Sooner or later, upstream projects will start to require Java 8.

Fedora 21 will probably End-of-life around early 2016 (around when F23 is released). OpenJDK 7 will publicly End-of-life in April 2015. Security patches may not be backported to OpenJDK 7 (or if they are, they will be significantly delayed). If Fedora 21 ships with OpenJDK 7, this will leave users vulnerable to exploits.

Scope

  • Proposal owners:
    • Deprecate/Obsolete java-1.7.0-openjdk
    • Promote java-1.8.0-openjdk to a full java runtime status (Done)
    • In case of a mass rebuild, supply/apply patches to fix build against OpenJDK 8 (WIP)
  • Other developers:
    • icedtea-web maintainers will need to update icedtea-web to run against OpenJDK 8 (TODO)
    • Other java packagers will need to apply patches to their java package to ensure they can build against OpenJDK 8 (WIP)
    • Everyone will need to test packages to verify that they work against OpenJDK 8 (WIP)
  • Release engineering:
    • Remove java-1.7.0-openjdk
  • Policies and guidelines:
    • N/A

Upgrade/compatibility impact

Upgrades from previous Fedora versions should be seamless. java-1.8.0-openjdk will replace (Obsoletes and Provides) java-1.7.0-openjdk.

OpenJDK 8 is a backwards compatible update. Code that worked against OpenJDK 7 should continue to run against OpenJDK 8. Code compiled against OpenJDK 8 will not run against OpenJDK 7 by default (separate compiler flags are needed to generate OpenJDK 7-compatible bytecode).

Customizations of OpenJDK 7 will be lost with an update to OpenJDK 8.

How To Test

This is a software only change. The results should be consistent across all architectures (i686, x86_64, armv7, aarch64) and hardware.

0. What special hardware / data / etc. is needed (if any)? Answer: None

1. How do I prepare my system to test this change? What packages need to be installed, config files edited, etc.? Answer: Install any Java package (ant,maven, eclipse are good candidates).

2. What specific actions do I perform to check that the change is working like it's supposed to? Answer: Run the java package you installed in step 1.

3. What are the expected results of those actions? Answer: java-1.8.0-openjdk (or java-1.8.0-openjdk-headless) should be installed as a dependency. The Java application you installed should work like it does normally.

User Experience

This change to the Java runtime should be mostly invisible to a user.

Java developers will notice that a newer version of Java is packaged. Java applications will run on top of the latest Java runtime.

Dependencies

The OpenJDK packages will need to be updated/removed:

  • java-1.7.0-openjdk
  • java-1.8.0-openjdk

OpenJDK 8 depends on various system libraries, but no new changes are required to other packages. In fact, a non-default version of java-1.8.0-openjdk is available on older Fedora releases too.

Contingency Plan

  • Contingency mechanism:
    • Leave OpenJDK 7 as the default Java SDK and runtime.
    • Ship OpenJDK 8 as a leaf package.
    • For packages that were rebuilt against OpenJDK 8, rebuild them against OpenJDK 7
  • Contingency deadline: 2014-08-01
  • Blocks release? No
  • Blocks product? TODO

Documentation

Release Notes

  • Java 8 Release notes
  • User customizations made to java-1.7.0-openjdk (specifically, to files under /usr/lib/jvm/java-1.7.0*/*) will not be carried across to java-1.8.0-openjdk.