From 1215ae4c969a8f601310426befaee0c7f1ba2176 Mon Sep 17 00:00:00 2001 From: Peter Zhu Date: Mon, 3 Jun 2024 19:26:43 -0400 Subject: [PATCH 1/8] Adding OS matrix changelog and remove CentOS7 as it is approaching EOL Signed-off-by: Peter Zhu --- _install-and-configure/install-opensearch/index.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/_install-and-configure/install-opensearch/index.md b/_install-and-configure/install-opensearch/index.md index 2615383ce1..806015cb19 100644 --- a/_install-and-configure/install-opensearch/index.md +++ b/_install-and-configure/install-opensearch/index.md @@ -23,7 +23,6 @@ The following table lists the operating system versions that we are currently te OS | Version :---------- | :-------- -CentOS | 7 Rocky Linux | 8 Alma Linux | 8 Amazon Linux | 2/2023 @@ -31,6 +30,17 @@ Ubuntu | 20.04 Windows Server | 2019 +### Change Log ## + +
+ +| Date | Issue | PR | Details | +|:-----------|:-------|:-------|:--------------------------| +| 2024-06-03 | [opensearch-build Issue 4379](https://github.com/opensearch-project/documentation-website/issues/4379) | [PR 7285](https://github.com/opensearch-project/documentation-website/pull/7285) | Remove CentOS7 as it if approaching [EOL](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/) | +| 2024-03-08 | [opensearch-build Issue 4573](https://github.com/opensearch-project/opensearch-build/issues/4573) | [PR 6637](https://github.com/opensearch-project/documentation-website/pull/6637) | Remove CentOS8, add Almalinux8/Rockylinux8, remove Ubuntu 16.04/18.04 as we currently only test on 20.04 | +| 2023-06-06 | [documentation-website Issue 4217](https://github.com/opensearch-project/documentation-website/issues/4217) | [PR 4218](https://github.com/opensearch-project/documentation-website/pull/4218) | Support Matrix Creation | + + ## File system recommendations Avoid using a network file system for node storage in a production workflow. Using a network file system for node storage can cause performance issues in your cluster due to factors such as network conditions (like latency or limited throughput) or read/write speeds. You should use solid-state drives (SSDs) installed on the host for node storage where possible. From 0af45a3439881be52c262758581caed6fb548479 Mon Sep 17 00:00:00 2001 From: Archer Date: Tue, 23 Jul 2024 12:44:52 -0500 Subject: [PATCH 2/8] Add new compatibility page Signed-off-by: Archer --- .../install-opensearch/index.md | 27 ++-------------- _install-and-configure/os-comp.md | 32 +++++++++++++++++++ 2 files changed, 34 insertions(+), 25 deletions(-) create mode 100644 _install-and-configure/os-comp.md diff --git a/_install-and-configure/install-opensearch/index.md b/_install-and-configure/install-opensearch/index.md index ae01239013..701a34782c 100644 --- a/_install-and-configure/install-opensearch/index.md +++ b/_install-and-configure/install-opensearch/index.md @@ -13,32 +13,9 @@ redirect_from: # Installing OpenSearch -This section details how to install OpenSearch on your host, including which operating systems are [compatible with OpenSearch](#operating-system-compatibility), which [ports to open](#network-requirements), and which [important settings](#important-settings) to configure on your host. +This section details how to install OpenSearch on your host, including which [ports to open](#network-requirements) and which [important settings](#important-settings) to configure on your host. -## Operating system compatibility - -OpenSearch and OpenSearch Dashboards are compatible with Red Hat Enterprise Linux (RHEL) and Debian-based Linux distributions that use [`systemd`](https://en.wikipedia.org/wiki/Systemd), such as Amazon Linux, and Ubuntu Long-Term Support (LTS). While OpenSearch and OpenSearch Dashboards should work on most Linux distributions, we only test a subset. - -The following table lists the operating system versions that we are currently testing on: - -OS | Version -:---------- | :-------- -Rocky Linux | 8 -Alma Linux | 8 -Amazon Linux | 2/2023 -Ubuntu | 20.04 -Windows Server | 2019 - - -### Change Log ## - -
- -| Date | Issue | PR | Details | -|:-----------|:-------|:-------|:--------------------------| -| 2024-06-03 | [opensearch-build Issue 4379](https://github.com/opensearch-project/documentation-website/issues/4379) | [PR 7285](https://github.com/opensearch-project/documentation-website/pull/7285) | Remove CentOS7 as it if approaching [EOL](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/) | -| 2024-03-08 | [opensearch-build Issue 4573](https://github.com/opensearch-project/opensearch-build/issues/4573) | [PR 6637](https://github.com/opensearch-project/documentation-website/pull/6637) | Remove CentOS8, add Almalinux8/Rockylinux8, remove Ubuntu 16.04/18.04 as we currently only test on 20.04 | -| 2023-06-06 | [documentation-website Issue 4217](https://github.com/opensearch-project/documentation-website/issues/4217) | [PR 4218](https://github.com/opensearch-project/documentation-website/pull/4218) | Support Matrix Creation | +For operating system compatibility, see [Compatiable operating systems]({{site.url}}{{site.baseurl}}/install-and-configure/os-comp/) ## File system recommendations diff --git a/_install-and-configure/os-comp.md b/_install-and-configure/os-comp.md new file mode 100644 index 0000000000..705b986beb --- /dev/null +++ b/_install-and-configure/os-comp.md @@ -0,0 +1,32 @@ +--- +layout: default +title: Compatible operating systems +nav_order: 12 +--- + +OpenSearch and OpenSearch Dashboards are compatible with Red Hat Enterprise Linux (RHEL) and Debian-based Linux distributions that use [`systemd`](https://en.wikipedia.org/wiki/Systemd), such as Amazon Linux, and Ubuntu Long-Term Support (LTS). While OpenSearch and OpenSearch Dashboards should work on most Linux distributions, we only test a subset. + +## Supported operating systems + +The following table lists the operating system versions that we are currently testing on: + +OS | Version +:---------- | :-------- +Rocky Linux | 8 +Alma Linux | 8 +Amazon Linux | 2/2023 +Ubuntu | 20.04 +Windows Server | 2019 + + +## Change log + +The following table details changes made to operating system compatibility. + +
+ +| Date | Issue | PR | Details | +|:-----------|:-------|:-------|:--------------------------| +| 2024-06-03 | [opensearch-build Issue 4379](https://github.com/opensearch-project/documentation-website/issues/4379) | [PR 7285](https://github.com/opensearch-project/documentation-website/pull/7285) | Remove CentOS7 as it if approaching [EOL](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/) | +| 2024-03-08 | [opensearch-build Issue 4573](https://github.com/opensearch-project/opensearch-build/issues/4573) | [PR 6637](https://github.com/opensearch-project/documentation-website/pull/6637) | Remove CentOS8, add Almalinux8/Rockylinux8, remove Ubuntu 16.04/18.04 as we currently only test on 20.04 | +| 2023-06-06 | [documentation-website Issue 4217](https://github.com/opensearch-project/documentation-website/issues/4217) | [PR 4218](https://github.com/opensearch-project/documentation-website/pull/4218) | Support Matrix Creation | \ No newline at end of file From 6be2a62656da882b18de3314bbf2abeb8fb824c2 Mon Sep 17 00:00:00 2001 From: Archer Date: Tue, 23 Jul 2024 12:51:20 -0500 Subject: [PATCH 3/8] Fix links Signed-off-by: Archer --- _install-and-configure/install-opensearch/rpm.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_install-and-configure/install-opensearch/rpm.md b/_install-and-configure/install-opensearch/rpm.md index 1810273fb1..85872b7c34 100644 --- a/_install-and-configure/install-opensearch/rpm.md +++ b/_install-and-configure/install-opensearch/rpm.md @@ -27,7 +27,7 @@ Generally speaking, installing OpenSearch from the RPM distribution can be broke 1. **Configure OpenSearch for your environment.** - Apply basic settings to OpenSearch and start using it in your environment. -The RPM distribution provides everything you need to run OpenSearch inside Red Hat or Red Hat–based Linux Distributions. For a list of supported operating systems, see [Operating system compatibility]({{site.url}}{{site.baseurl}}/install-and-configure/install-opensearch/index/#operating-system-compatibility). +The RPM distribution provides everything you need to run OpenSearch inside Red Hat or Red Hat–based Linux Distributions. For a list of supported operating systems, see [Operating system compatibility]({{site.url}}{{site.baseurl}}/install-and-configure/os-comp/). This guide assumes that you are comfortable working from the Linux command line interface (CLI). You should understand how to input commands, navigate between directories, and edit text files. Some example commands reference the `vi` text editor, but you may use any text editor available. {:.note} From 661cd7d1aaa2fcae6230d728f58c9f29d0ee3e7f Mon Sep 17 00:00:00 2001 From: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Date: Tue, 23 Jul 2024 13:25:27 -0500 Subject: [PATCH 4/8] Apply suggestions from code review Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> --- _install-and-configure/os-comp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_install-and-configure/os-comp.md b/_install-and-configure/os-comp.md index 705b986beb..0aaa1bc662 100644 --- a/_install-and-configure/os-comp.md +++ b/_install-and-configure/os-comp.md @@ -27,6 +27,6 @@ The following table details changes made to operating system compatibility. | Date | Issue | PR | Details | |:-----------|:-------|:-------|:--------------------------| -| 2024-06-03 | [opensearch-build Issue 4379](https://github.com/opensearch-project/documentation-website/issues/4379) | [PR 7285](https://github.com/opensearch-project/documentation-website/pull/7285) | Remove CentOS7 as it if approaching [EOL](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/) | +| 2024-07-23 | [opensearch-build Issue 4379](https://github.com/opensearch-project/documentation-website/issues/4379) | [PR 7821](https://github.com/opensearch-project/documentation-website/pull/7821) | Remove CentOS7 as it if approaching [EOL](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/) | | 2024-03-08 | [opensearch-build Issue 4573](https://github.com/opensearch-project/opensearch-build/issues/4573) | [PR 6637](https://github.com/opensearch-project/documentation-website/pull/6637) | Remove CentOS8, add Almalinux8/Rockylinux8, remove Ubuntu 16.04/18.04 as we currently only test on 20.04 | | 2023-06-06 | [documentation-website Issue 4217](https://github.com/opensearch-project/documentation-website/issues/4217) | [PR 4218](https://github.com/opensearch-project/documentation-website/pull/4218) | Support Matrix Creation | \ No newline at end of file From 9b79243ce0c9b801b36a8e6541537443e47263d8 Mon Sep 17 00:00:00 2001 From: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Date: Thu, 25 Jul 2024 13:32:19 -0500 Subject: [PATCH 5/8] Apply suggestions from code review Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> --- _install-and-configure/os-comp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_install-and-configure/os-comp.md b/_install-and-configure/os-comp.md index 0aaa1bc662..b2f538a51b 100644 --- a/_install-and-configure/os-comp.md +++ b/_install-and-configure/os-comp.md @@ -27,6 +27,6 @@ The following table details changes made to operating system compatibility. | Date | Issue | PR | Details | |:-----------|:-------|:-------|:--------------------------| -| 2024-07-23 | [opensearch-build Issue 4379](https://github.com/opensearch-project/documentation-website/issues/4379) | [PR 7821](https://github.com/opensearch-project/documentation-website/pull/7821) | Remove CentOS7 as it if approaching [EOL](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/) | +| 2024-07-23 | [opensearch-build Issue 4379](https://github.com/opensearch-project/opensearch-build/issues/4379) | [PR 7821](https://github.com/opensearch-project/documentation-website/pull/7821) | Remove CentOS7 as it if approaching [EOL](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/) | | 2024-03-08 | [opensearch-build Issue 4573](https://github.com/opensearch-project/opensearch-build/issues/4573) | [PR 6637](https://github.com/opensearch-project/documentation-website/pull/6637) | Remove CentOS8, add Almalinux8/Rockylinux8, remove Ubuntu 16.04/18.04 as we currently only test on 20.04 | | 2023-06-06 | [documentation-website Issue 4217](https://github.com/opensearch-project/documentation-website/issues/4217) | [PR 4218](https://github.com/opensearch-project/documentation-website/pull/4218) | Support Matrix Creation | \ No newline at end of file From 29b2fb4f18658e9aceca586512eb59b0d5d67193 Mon Sep 17 00:00:00 2001 From: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Date: Tue, 30 Jul 2024 14:02:58 -0500 Subject: [PATCH 6/8] Update _install-and-configure/install-opensearch/index.md Co-authored-by: Heather Halter Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> --- _install-and-configure/install-opensearch/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_install-and-configure/install-opensearch/index.md b/_install-and-configure/install-opensearch/index.md index 701a34782c..5fa09d83cf 100644 --- a/_install-and-configure/install-opensearch/index.md +++ b/_install-and-configure/install-opensearch/index.md @@ -15,7 +15,7 @@ redirect_from: This section details how to install OpenSearch on your host, including which [ports to open](#network-requirements) and which [important settings](#important-settings) to configure on your host. -For operating system compatibility, see [Compatiable operating systems]({{site.url}}{{site.baseurl}}/install-and-configure/os-comp/) +For operating system compatibility, see [Compatible operating systems]({{site.url}}{{site.baseurl}}/install-and-configure/os-comp/) ## File system recommendations From af08613be0cd2cb517cea76c314115f37b6a8572 Mon Sep 17 00:00:00 2001 From: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Date: Tue, 30 Jul 2024 14:25:07 -0500 Subject: [PATCH 7/8] Apply suggestions from code review Co-authored-by: Nathan Bower Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> --- _install-and-configure/install-opensearch/index.md | 2 +- _install-and-configure/os-comp.md | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/_install-and-configure/install-opensearch/index.md b/_install-and-configure/install-opensearch/index.md index 5fa09d83cf..70163bee7d 100644 --- a/_install-and-configure/install-opensearch/index.md +++ b/_install-and-configure/install-opensearch/index.md @@ -15,7 +15,7 @@ redirect_from: This section details how to install OpenSearch on your host, including which [ports to open](#network-requirements) and which [important settings](#important-settings) to configure on your host. -For operating system compatibility, see [Compatible operating systems]({{site.url}}{{site.baseurl}}/install-and-configure/os-comp/) +For operating system compatibility, see [Compatible operating systems]({{site.url}}{{site.baseurl}}/install-and-configure/os-comp/). ## File system recommendations diff --git a/_install-and-configure/os-comp.md b/_install-and-configure/os-comp.md index b2f538a51b..a62b82b7da 100644 --- a/_install-and-configure/os-comp.md +++ b/_install-and-configure/os-comp.md @@ -8,7 +8,7 @@ OpenSearch and OpenSearch Dashboards are compatible with Red Hat Enterprise Linu ## Supported operating systems -The following table lists the operating system versions that we are currently testing on: +The following table lists the operating system versions that we are currently testing: OS | Version :---------- | :-------- @@ -21,12 +21,12 @@ Windows Server | 2019 ## Change log -The following table details changes made to operating system compatibility. +The following table lists changes made to operating system compatibility.
| Date | Issue | PR | Details | |:-----------|:-------|:-------|:--------------------------| -| 2024-07-23 | [opensearch-build Issue 4379](https://github.com/opensearch-project/opensearch-build/issues/4379) | [PR 7821](https://github.com/opensearch-project/documentation-website/pull/7821) | Remove CentOS7 as it if approaching [EOL](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/) | -| 2024-03-08 | [opensearch-build Issue 4573](https://github.com/opensearch-project/opensearch-build/issues/4573) | [PR 6637](https://github.com/opensearch-project/documentation-website/pull/6637) | Remove CentOS8, add Almalinux8/Rockylinux8, remove Ubuntu 16.04/18.04 as we currently only test on 20.04 | -| 2023-06-06 | [documentation-website Issue 4217](https://github.com/opensearch-project/documentation-website/issues/4217) | [PR 4218](https://github.com/opensearch-project/documentation-website/pull/4218) | Support Matrix Creation | \ No newline at end of file +| 2024-07-23 | [opensearch-build Issue 4379](https://github.com/opensearch-project/opensearch-build/issues/4379) | [PR 7821](https://github.com/opensearch-project/documentation-website/pull/7821) | Remove [CentOS7](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/). | +| 2024-03-08 | [opensearch-build Issue 4573](https://github.com/opensearch-project/opensearch-build/issues/4573) | [PR 6637](https://github.com/opensearch-project/documentation-website/pull/6637) | Remove CentOS8, add Almalinux8/Rockylinux8, and remove Ubuntu 16.04/18.04 because we currently only test on 20.04 | +| 2023-06-06 | [documentation-website Issue 4217](https://github.com/opensearch-project/documentation-website/issues/4217) | [PR 4218](https://github.com/opensearch-project/documentation-website/pull/4218) | Support matrix creation | \ No newline at end of file From 064c9ac9ca46cb5dde72ec9842363e4ded49891c Mon Sep 17 00:00:00 2001 From: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Date: Tue, 30 Jul 2024 14:31:39 -0500 Subject: [PATCH 8/8] Update _install-and-configure/install-opensearch/index.md Co-authored-by: Nathan Bower Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> --- _install-and-configure/install-opensearch/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_install-and-configure/install-opensearch/index.md b/_install-and-configure/install-opensearch/index.md index 70163bee7d..e1d63927b0 100644 --- a/_install-and-configure/install-opensearch/index.md +++ b/_install-and-configure/install-opensearch/index.md @@ -13,7 +13,7 @@ redirect_from: # Installing OpenSearch -This section details how to install OpenSearch on your host, including which [ports to open](#network-requirements) and which [important settings](#important-settings) to configure on your host. +This section provides information about how to install OpenSearch on your host, including which [ports to open](#network-requirements) and which [important settings](#important-settings) to configure on your host. For operating system compatibility, see [Compatible operating systems]({{site.url}}{{site.baseurl}}/install-and-configure/os-comp/).