From bbe7fffe6b0e619c63e1ea90901de8bfabac8588 Mon Sep 17 00:00:00 2001 From: dblock Date: Wed, 30 Mar 2022 15:45:51 -0400 Subject: [PATCH 1/3] Document 2.0 compatibility. Signed-off-by: dblock --- _opensearch/install/compatibility.md | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/_opensearch/install/compatibility.md b/_opensearch/install/compatibility.md index 189e5d535a..33be60d05e 100644 --- a/_opensearch/install/compatibility.md +++ b/_opensearch/install/compatibility.md @@ -5,15 +5,20 @@ parent: Install OpenSearch nav_order: 2 --- -# Operating system and JVM compatibility +# Operating System Compatibility -- We recommend installing OpenSearch on RHEL- or Debian-based Linux distributions that use [systemd](https://en.wikipedia.org/wiki/Systemd), such as CentOS, Amazon Linux 2, and Ubuntu (LTS). OpenSearch should work on many Linux distributions, but we only test a handful. -- The OpenSearch tarball ships with a compatible version of Java in the `jdk` directory. To find its version, run `./jdk/bin/java -version`. For example, the OpenSearch 1.0.0 tarball ships with Java 15.0.1+9 (non-LTS), while OpenSearch 1.3.0 includes Java 11.0.14.1+1 (LTS). -- OpenSearch 1.0 to 1.2.4 is built and tested with Java 15, while OpenSearch 1.3.0 is built and tested with Java 8, 11 and 14. +We recommend installing OpenSearch on RHEL- or Debian-based Linux distributions that use [systemd](https://en.wikipedia.org/wiki/Systemd), such as CentOS, Amazon Linux 2, and Ubuntu (LTS). OpenSearch should work on many Linux distributions, but we only test a handful. We recommend Red Hat Enterprise Linux 7 or 8, CentOS 7 or 8, Amazon Linux 2, Ubuntu 16.04, 18.04, or 20.04 for any version of OpenSearch. - To use a different Java installation, set the `OPENSEARCH_JAVA_HOME` or `JAVA_HOME` environment variable to the Java install location. We recommend Java 11 (LTS), but OpenSearch also works with Java 8. +# Java Compatibility -OpenSearch version | Compatible Java versions | Recommended operating systems -:--- | :--- | :--- -1.0 - 1.2.x | 11, 15 | Red Hat Enterprise Linux 7, 8; CentOS 7, 8; Amazon Linux 2; Ubuntu 16.04, 18.04, 20.04 -1.3.x | 8, 11, 14 | Red Hat Enterprise Linux 7, 8; CentOS 7, 8; Amazon Linux 2; Ubuntu 16.04, 18.04, 20.04 \ No newline at end of file +The OpenSearch ditribution for Linux ships with a compatible [Adoptium JDK](https://adoptium.net/) version of Java in the `jdk` directory. To find its version, run `./jdk/bin/java -version`. For example, the OpenSearch 1.0.0 tarball ships with Java 15.0.1+9 (non-LTS), OpenSearch 1.3.0 includes Java 11.0.14.1+1 (LTS), and OpenSearch 2.0.0 includes Java 17.0.2+8 (LTS). + +OpenSearch 1.0 to 1.2.4 is built and tested with Java 15, OpenSearch 1.3.0 is built and tested with Java 8, 11 and 14, and OpenSearch 2.0.0 is built and tested with Java 11 and 17. + +To use a different Java installation, set the `OPENSEARCH_JAVA_HOME` or `JAVA_HOME` environment variable to the Java install location. + +OpenSearch Version | Compatible Java Versions | Bundled Java Version +:---------- | :-------- | :----------- +1.0 - 1.2.x | 11, 15 | 15.0.1+9 +1.3.x | 8, 11, 14 | 11.0.14.1+1 +2.0.0 | 11, 17 | 17.0.2+8 From 46e219f4f64ba8cc5cd33afd5d1dcf2148f0b4b6 Mon Sep 17 00:00:00 2001 From: dblock Date: Mon, 4 Apr 2022 19:28:34 -0400 Subject: [PATCH 2/3] Simplfied the story around testing. Signed-off-by: dblock --- _opensearch/install/compatibility.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/_opensearch/install/compatibility.md b/_opensearch/install/compatibility.md index 33be60d05e..830ea11575 100644 --- a/_opensearch/install/compatibility.md +++ b/_opensearch/install/compatibility.md @@ -11,14 +11,12 @@ We recommend installing OpenSearch on RHEL- or Debian-based Linux distributions # Java Compatibility -The OpenSearch ditribution for Linux ships with a compatible [Adoptium JDK](https://adoptium.net/) version of Java in the `jdk` directory. To find its version, run `./jdk/bin/java -version`. For example, the OpenSearch 1.0.0 tarball ships with Java 15.0.1+9 (non-LTS), OpenSearch 1.3.0 includes Java 11.0.14.1+1 (LTS), and OpenSearch 2.0.0 includes Java 17.0.2+8 (LTS). - -OpenSearch 1.0 to 1.2.4 is built and tested with Java 15, OpenSearch 1.3.0 is built and tested with Java 8, 11 and 14, and OpenSearch 2.0.0 is built and tested with Java 11 and 17. - -To use a different Java installation, set the `OPENSEARCH_JAVA_HOME` or `JAVA_HOME` environment variable to the Java install location. +The OpenSearch distribution for Linux ships with a compatible [Adoptium JDK](https://adoptium.net/) version of Java in the `jdk` directory. To find the JDK version, run `./jdk/bin/java -version`. For example, the OpenSearch 1.0.0 tarball ships with Java 15.0.1+9 (non-LTS), OpenSearch 1.3.0 ships with Java 11.0.14.1+1 (LTS), and OpenSearch 2.0.0 ships with Java 17.0.2+8 (LTS). OpenSearch is tested with all compatible Java versions. OpenSearch Version | Compatible Java Versions | Bundled Java Version :---------- | :-------- | :----------- 1.0 - 1.2.x | 11, 15 | 15.0.1+9 1.3.x | 8, 11, 14 | 11.0.14.1+1 2.0.0 | 11, 17 | 17.0.2+8 + +To use a different Java installation, set the `OPENSEARCH_JAVA_HOME` or `JAVA_HOME` environment variable to the Java install location. From 0db361b051e956ad01c1fdb0a532fc57a24d5ad0 Mon Sep 17 00:00:00 2001 From: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Date: Thu, 26 May 2022 10:45:21 -0500 Subject: [PATCH 3/3] Update _opensearch/install/compatibility.md Commit quick edit. --- _opensearch/install/compatibility.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_opensearch/install/compatibility.md b/_opensearch/install/compatibility.md index 830ea11575..45e72e3a1a 100644 --- a/_opensearch/install/compatibility.md +++ b/_opensearch/install/compatibility.md @@ -7,7 +7,7 @@ nav_order: 2 # Operating System Compatibility -We recommend installing OpenSearch on RHEL- or Debian-based Linux distributions that use [systemd](https://en.wikipedia.org/wiki/Systemd), such as CentOS, Amazon Linux 2, and Ubuntu (LTS). OpenSearch should work on many Linux distributions, but we only test a handful. We recommend Red Hat Enterprise Linux 7 or 8, CentOS 7 or 8, Amazon Linux 2, Ubuntu 16.04, 18.04, or 20.04 for any version of OpenSearch. +We recommend installing OpenSearch on RHEL or Debian-based Linux distributions that use [systemd](https://en.wikipedia.org/wiki/Systemd), such as CentOS, Amazon Linux 2, and Ubuntu (LTS). OpenSearch should work on many Linux distributions, but we only test a handful. We recommend Red Hat Enterprise Linux 7 or 8, CentOS 7 or 8, Amazon Linux 2, Ubuntu 16.04, 18.04, or 20.04 for any version of OpenSearch. # Java Compatibility