ndimiduk commented on a change in pull request #1844:
URL: https://github.com/apache/hbase/pull/1844#discussion_r434919844
##
File path: src/main/asciidoc/_chapters/configuration.adoc
##
@@ -97,55 +97,76 @@ This section lists required services and some required
system configuration.
[[java]]
.Java
-The following table summarizes the recommendation of the HBase community wrt
deploying on various
-Java versions. A icon:check-circle[role="green"] symbol is meant to indicate a
base level of
+The following table summarizes the recommendations of the HBase community with
respect to deploying
+on various Java versions. The icon:check-circle[role="green"] symbol indicates
a base level of
testing and willingness to help diagnose and address issues you might run
into. Similarly, an entry
-of icon:exclamation-circle[role="yellow"] or icon:times-circle[role="red"]
generally means that
-should you run into an issue the community is likely to ask you to change the
Java environment
-before proceeding to help. In some cases, specific guidance on limitations
(e.g. whether compiling
-/ unit tests work, specific operational issues, etc) will also be noted.
+of icon:exclamation-circle[role="yellow"] means that, should you run into an
issue, the community
+is likely to ask you to change the Java environment rather than proceeding to
help on that Java
+version. This applies categorically to Non-LTS releases (see below). The
+icon:times-circle[role="red"] means that support has been dropped for this
version or has been
+attempted and is known to not work. For combinations of newer JDK with older
HBase releases, it's
+likely that there are known compatibility issues that cannot be addressed
under our compatibility
+guarantees, making that combination impossible. In some cases, specific
guidance on limitations
+(e.g. whether compiling / unit tests work, specific operational issues, etc)
will also be noted.
+
+.Long-Term Support JDKs are Recommended
+[WARNING]
+
+HBase recommends downstream users rely on JDK releases that are marked as
Long-Term Supported
+(LTS), either from the OpenJDK project or vendors. At the time of this
writing, the following JDK
+releases are NOT LTS releases and are NOT supported by the Apache HBase
community: JDK9, JDK10,
+JDK12, JDK13, and JDK14. Community discussion around this decision is recorded
on
+link:https://issues.apache.org/jira/browse/HBASE-20264[HBASE-20264].
+
-.Long Term Support JDKs are recommended
+.HotSpot vs. OpenJ9
[TIP]
-HBase recommends downstream users rely on JDK releases that are marked as Long
Term Supported (LTS)
-either from the OpenJDK project or vendors. As of March 2018 that means Java 8
is the only
-applicable version and that the next likely version to see testing will be
Java 11 near Q3 2018.
+At this time, all testing performed by the Apache HBase project runs on the
HotSpot variant of the
+JVM. When selecting your JDK distribution, please take this into consideration.
.Java support by release line
-[cols="6*^.^", options="header"]
+[cols="4*^.^", options="header"]
|===
-|HBase Version
-|JDK 7
-|JDK 8
-|JDK 9 (Non-LTS)
-|JDK 10 (Non-LTS)
-|JDK 11
-
-|2.1+
+|Java Version
+|HBase 1.3+
+|HBase 2.1+
+|HBase 2.3+
+
+|JDK6
+|icon:times-circle[role="red"]
|icon:times-circle[role="red"]
+|icon:times-circle[role="red"]
+
+|JDK7
+|icon:check-circle[role="green"]
+|icon:times-circle[role="red"]
+|icon:times-circle[role="red"]
+
+|JDK8
|icon:check-circle[role="green"]
Review comment:
We're talking about runtime support here. You're right though, the
language is not clear. Let me take another swing.
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org