-
Notifications
You must be signed in to change notification settings - Fork 706
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #16391 from Sreekala-Gopakumar/36ReleaseNoteDraft
Draft 0.36.0 release notes
- Loading branch information
Showing
2 changed files
with
117 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,116 @@ | ||
| <!-- | ||
| * Copyright (c) 2022, 2022 IBM Corp. and others | ||
| * | ||
| * This program and the accompanying materials are made | ||
| * available under the terms of the Eclipse Public License 2.0 | ||
| * which accompanies this distribution and is available at | ||
| * https://www.eclipse.org/legal/epl-2.0/ or the Apache | ||
| * License, Version 2.0 which accompanies this distribution and | ||
| * is available at https://www.apache.org/licenses/LICENSE-2.0. | ||
| * | ||
| * This Source Code may also be made available under the | ||
| * following Secondary Licenses when the conditions for such | ||
| * availability set forth in the Eclipse Public License, v. 2.0 | ||
| * are satisfied: GNU General Public License, version 2 with | ||
| * the GNU Classpath Exception [1] and GNU General Public | ||
| * License, version 2 with the OpenJDK Assembly Exception [2]. | ||
| * | ||
| * [1] https://www.gnu.org/software/classpath/license.html | ||
| * [2] https://openjdk.org/legal/assembly-exception.html | ||
| * | ||
| * SPDX-License-Identifier: EPL-2.0 OR Apache-2.0 OR GPL-2.0 WITH | ||
| * Classpath-exception-2.0 OR LicenseRef-GPL-2.0 WITH Assembly-exception | ||
| --> | ||
|
|
||
| # Eclipse OpenJ9 version 0.36.0 release notes | ||
|
|
||
| These release notes support the [Eclipse OpenJ9 0.36.0 release plan](https://projects.eclipse.org/projects/technology.openj9/releases/0.36.0/plan). | ||
|
|
||
| ## Supported environments | ||
|
|
||
| OpenJ9 release 0.36.0 supports OpenJDK 8, 11, 17. | ||
|
|
||
| All releases are tested against the OpenJ9 functional verification (FV) test suite, the OpenJDK test suites, and additional tests provided by Adoptium. | ||
|
|
||
| To learn more about support for OpenJ9 releases, including OpenJDK levels and platform support, see [Supported environments](https://eclipse.org/openj9/docs/openj9_support/index.html). | ||
|
|
||
| ## Notable changes in this release | ||
|
|
||
| The following table covers notable changes in v0.36.0. Further information about these changes can be found in the [user documentation](https://www.eclipse.org/openj9/docs/version0.36/). | ||
|
|
||
| <table cellpadding="4" cellspacing="0" summary="" width="100%" rules="all" frame="border" border="1"><thead align="left"> | ||
| <tr> | ||
| <th valign="bottom">Issue number</th> | ||
| <th valign="bottom">Description</th> | ||
| <th valign="bottom">Version / Platform</th> | ||
| <th valign="bottom">Impact</th> | ||
| </tr> | ||
| </thead> | ||
| <tbody> | ||
|
|
||
| <tr> | ||
| <td valign="top"><a href="https://github.com/eclipse-openj9/openj9/issues/15775">#15775</a></td> | ||
| <td valign="top">New <tt>-XX:JITServerAOTmx</tt> option added for specifying the maximum amount of memory that can be used by the JITServer AOT cache</td> | ||
| <td valign="top">All versions (Linux®)</td> | ||
| <td valign="top">The maximum amount of memory that all the AOT cache instances combined can use at the server is 300 MB, by default. You can change this value by using the <tt>-XX:JITServerAOTmx=<size></tt> option. When the cache size reaches the specified limit, new clients cannot create new AOT cache instances or add new compiled methods to the existing AOT cache instances.</td> | ||
| </tr> | ||
|
|
||
| <tr> | ||
| <td valign="top"><a href="https://github.com/eclipse-openj9/openj9/issues/16256">#16256</a></td> | ||
| <td valign="top">The location of the default directory for the shared cache and snapshot is changed to the <tt>.cache/javasharedresources</tt> in the user's home directory</td> | ||
| <td valign="top">All versions (AIX®, Linux, macOS®)</td> | ||
| <td valign="top">This change is for non-Windows™ and non-z/OS® platforms and applies only if <tt>-Xshareclasses:groupAccess</tt> is not used. If <tt>groupAccess</tt> is used, the directory that gets set remains as <tt>/tmp/javasharedresources/</tt>.</td> | ||
| </tr> | ||
|
|
||
| </tbody> | ||
| </table> | ||
|
|
||
| ## Known issues | ||
|
|
||
| The v0.36.0 release contains the following known issues and limitations: | ||
|
|
||
| <table cellpadding="4" cellspacing="0" summary="" width="100%" rules="all" frame="border" border="1"> | ||
| <thead align="left"> | ||
| <tr> | ||
| <th valign="bottom">Issue number</th> | ||
| <th valign="bottom">Description</th> | ||
| <th valign="bottom">Platform</th> | ||
| <th valign="bottom">Impact</th> | ||
| <th valign="bottom">Workaround</th> | ||
| </tr> | ||
| </thead> | ||
|
|
||
| <tbody> | ||
| <tr> | ||
| <td valign="top"><a href="https://github.com/eclipse-openj9/openj9/issues/15011">#15011</a></td> | ||
| <td valign="top">The default stack size is modified for the main thread</td> | ||
| <td valign="top">All</td> | ||
| <td valign="top">The main thread stack size was 1 MB in releases prior to 0.32. In the 0.32 release and later it's modified to a smaller | ||
| platform-dependent value, the same value as the <tt>-Xmso</tt> setting. The 0.33 release increases the default <tt>-Xmso</tt> stack size | ||
| on x64 platforms, but builds with OpenJDK 17 and later also require more stack space to run. These changes might result in a | ||
| <tt>java.lang.StackOverflowError: operating system stack overflow</tt>.</td> | ||
| <td valign="top">Use <tt>-Xmso</tt> to set the default stack size. See the default value by using <tt>-verbose:sizes</tt>.</td> | ||
| </tr> | ||
|
|
||
| <tr> | ||
| <td valign="top"><a href="https://github.com/eclipse-openj9/openj9/issues/13767">#13767</a></td> | ||
| <td valign="top">Compressed references mode is not available</td> | ||
| <td valign="top">Apple silicon macOS</td> | ||
| <td valign="top">You can use only the large heap (non-compressed references) mode.</td> | ||
| <td valign="top">None</td> | ||
| </tr> | ||
|
|
||
| <tr> | ||
| <td valign="top"><a href="https://github.com/eclipse-openj9/openj9/issues/14803">#14803</a></td> | ||
| <td valign="top">Using the <tt>-XX:+ShowHiddenFrames</tt> option in an OpenJ9 release that is built with OpenJDK 18 and later causes errors due to underlying problems in OpenJDK</td> | ||
| <td valign="top">All platforms</td> | ||
| <td valign="top">Wrong exception might be thrown when using the Reflection API.</td> | ||
| <td valign="top">Avoid using the <tt>-XX:+ShowHiddenFrames</tt> option with OpenJDK 18 and later.</td> | ||
| </tr> | ||
|
|
||
| </tbody> | ||
| </table> | ||
|
|
||
| ## Other changes | ||
|
|
||
| A full commit history for this release is available at [Eclipse OpenJ9 v0.36.0](https://github.com/eclipse-openj9/openj9/releases/tag/openj9-0.36.0). |