Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updates the supported operating system section of install guide #4218

Merged
merged 8 commits into from
Jun 6, 2023

Conversation

hdhalter
Copy link
Contributor

@hdhalter hdhalter commented Jun 1, 2023

Description

Puts the operating system versions we support in a table for better readability.

Issues Resolved

Resolves #4217

Checklist

  • By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.
    For more information on following Developer Certificate of Origin and signing off your commits, please check here.

Signed-off-by: Heather Halter <[email protected]>
@hdhalter hdhalter changed the title updatedtable Updates the supported operating system section of install guide Jun 1, 2023
@hdhalter
Copy link
Contributor Author

hdhalter commented Jun 1, 2023

@peterzhuamazon and @nateynateynate - please review for accuracy. Thanks!

@hdhalter hdhalter self-assigned this Jun 1, 2023
@hdhalter hdhalter added the 3 - Tech review PR: Tech review in progress label Jun 1, 2023
Copy link
Member

@peterzhuamazon peterzhuamazon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @hdhalter , have some comments, thanks.

_install-and-configure/install-opensearch/index.md Outdated Show resolved Hide resolved
We recommend installing OpenSearch on Red Hat Enterprise Linux (RHEL) or Debian-based Linux distributions that use [systemd](https://en.wikipedia.org/wiki/Systemd), such as CentOS, Amazon Linux 2, or Ubuntu Long-Term Support (LTS). OpenSearch should work on most Linux distributions, but we only test a handful. We recommend RHEL 7 or 8, CentOS 7 or 8, Amazon Linux 2, or Ubuntu 16.04, 18.04, or 20.04 for any version of OpenSearch. OpenSearch also supports Windows Server 2019.
OpenSearch is compatible with Red Hat Enterprise Linux (RHEL) and Debian-based Linux distributions that use [systemd](https://en.wikipedia.org/wiki/Systemd), such as CentOS, Amazon Linux 2, or Ubuntu Long-Term Support (LTS). While OpenSearch should work on most Linux distributions, we only test a subset.

The following table lists the operating system versions that we support.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

that we support to that we currently support?

Copy link
Contributor Author

@hdhalter hdhalter Jun 1, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@peterzhuamazon - do you think we should backport this change all the way back to 1.3? Also, do you think I should link from the RPM page to this section/table?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are a few issues here:

  1. This does not only apply to RPM related OS, but apply to all OS that does not support sha1 key by default, so I think the download page would be a better idea.
  2. The download page yum/apt download link is not correctly link to rpm/deb page.
  3. DEB page is missing in the 1.3 section of documentation website installation pages.

Copy link
Member

@peterzhuamazon peterzhuamazon Jun 3, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And yes I think we should also backport to 1.3, due to eventually 1.3 and 2.x lines might have either different or same OS compatibilities that we dont know, and such a chart would help for sure.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, Peter. Updates to the following:

  • I added a link from the RPM page to the operating system compatibility table
  • I added redirects to the RPM and Debian pages so the "install" link on the Downloads page takes the user directly to those pages

Fanit is going to fix the issue with the parent link on the 1.3 version so we'll be able to backport easily to 1.3. Once she fixes that, I'll backport all installation files, including Debian. The 'copy' buttons should be appearing, as well.

I'll create an issue to fix the Downloads page:

  • Add a link to the "Operating System compatibility" chart on the install page

@@ -17,7 +17,17 @@ This section details how to install OpenSearch on your host, including which ope

## Operating system compatibility

We recommend installing OpenSearch on Red Hat Enterprise Linux (RHEL) or Debian-based Linux distributions that use [systemd](https://en.wikipedia.org/wiki/Systemd), such as CentOS, Amazon Linux 2, or Ubuntu Long-Term Support (LTS). OpenSearch should work on most Linux distributions, but we only test a handful. We recommend RHEL 7 or 8, CentOS 7 or 8, Amazon Linux 2, or Ubuntu 16.04, 18.04, or 20.04 for any version of OpenSearch. OpenSearch also supports Windows Server 2019.
OpenSearch is compatible with Red Hat Enterprise Linux (RHEL) and Debian-based Linux distributions that use [systemd](https://en.wikipedia.org/wiki/Systemd), such as CentOS, Amazon Linux 2, or Ubuntu Long-Term Support (LTS). While OpenSearch should work on most Linux distributions, we only test a subset.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OpenSearch is compatible to OpenSearch/OpenSearch-Dashboards are compatible?

hdhalter added 3 commits June 1, 2023 16:00
Signed-off-by: Heather Halter <[email protected]>
Signed-off-by: Heather Halter <[email protected]>
Signed-off-by: Heather Halter <[email protected]>
@hdhalter hdhalter added 4 - Doc review PR: Doc review in progress backport 2.7 PR: Backport label for 2.7 and removed 3 - Tech review PR: Tech review in progress labels Jun 2, 2023
@peterzhuamazon
Copy link
Member

peterzhuamazon commented Jun 3, 2023

Hi @hdhalter please see my reply to your comments.
Thanks.

@hdhalter hdhalter added 3 - Tech review PR: Tech review in progress and removed 4 - Doc review PR: Doc review in progress labels Jun 5, 2023
hdhalter added 3 commits June 5, 2023 16:30
Signed-off-by: Heather Halter <[email protected]>
Signed-off-by: Heather Halter <[email protected]>
Signed-off-by: Heather Halter <[email protected]>
@hdhalter hdhalter added 4 - Doc review PR: Doc review in progress backport 1.3 PR: Backport label for v1.3.x and removed 3 - Tech review PR: Tech review in progress labels Jun 5, 2023
Copy link
Collaborator

@kolchfa-aws kolchfa-aws left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

_install-and-configure/install-opensearch/index.md Outdated Show resolved Hide resolved
Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: Heather Halter <[email protected]>
@hdhalter hdhalter merged commit bfdd426 into main Jun 6, 2023
opensearch-trigger-bot bot pushed a commit that referenced this pull request Jun 6, 2023
* updatedtable

Signed-off-by: Heather Halter <[email protected]>

* addeddashboards

Signed-off-by: Heather Halter <[email protected]>

* addspaces

Signed-off-by: Heather Halter <[email protected]>

* removespaces

Signed-off-by: Heather Halter <[email protected]>

* changes to RPM file

Signed-off-by: Heather Halter <[email protected]>

* addedredirects

Signed-off-by: Heather Halter <[email protected]>

* fixedlink

Signed-off-by: Heather Halter <[email protected]>

* Update _install-and-configure/install-opensearch/index.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: Heather Halter <[email protected]>

---------

Signed-off-by: Heather Halter <[email protected]>
Signed-off-by: Heather Halter <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
(cherry picked from commit bfdd426)
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
opensearch-trigger-bot bot pushed a commit that referenced this pull request Jun 6, 2023
* updatedtable

Signed-off-by: Heather Halter <[email protected]>

* addeddashboards

Signed-off-by: Heather Halter <[email protected]>

* addspaces

Signed-off-by: Heather Halter <[email protected]>

* removespaces

Signed-off-by: Heather Halter <[email protected]>

* changes to RPM file

Signed-off-by: Heather Halter <[email protected]>

* addedredirects

Signed-off-by: Heather Halter <[email protected]>

* fixedlink

Signed-off-by: Heather Halter <[email protected]>

* Update _install-and-configure/install-opensearch/index.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: Heather Halter <[email protected]>

---------

Signed-off-by: Heather Halter <[email protected]>
Signed-off-by: Heather Halter <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
(cherry picked from commit bfdd426)
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
@hdhalter hdhalter added backport 2.8 PR: Backport label for 2.8 and removed backport 2.7 PR: Backport label for 2.7 labels Jun 6, 2023
opensearch-trigger-bot bot pushed a commit that referenced this pull request Jun 6, 2023
* updatedtable

Signed-off-by: Heather Halter <[email protected]>

* addeddashboards

Signed-off-by: Heather Halter <[email protected]>

* addspaces

Signed-off-by: Heather Halter <[email protected]>

* removespaces

Signed-off-by: Heather Halter <[email protected]>

* changes to RPM file

Signed-off-by: Heather Halter <[email protected]>

* addedredirects

Signed-off-by: Heather Halter <[email protected]>

* fixedlink

Signed-off-by: Heather Halter <[email protected]>

* Update _install-and-configure/install-opensearch/index.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: Heather Halter <[email protected]>

---------

Signed-off-by: Heather Halter <[email protected]>
Signed-off-by: Heather Halter <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
(cherry picked from commit bfdd426)
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
hdhalter pushed a commit that referenced this pull request Jun 6, 2023
… (#4264)

* updatedtable



* addeddashboards



* addspaces



* removespaces



* changes to RPM file



* addedredirects



* fixedlink



* Update _install-and-configure/install-opensearch/index.md




---------




(cherry picked from commit bfdd426)

Signed-off-by: Heather Halter <[email protected]>
Signed-off-by: Heather Halter <[email protected]>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: kolchfa-aws <[email protected]>
hdhalter pushed a commit that referenced this pull request Jun 7, 2023
… (#4262)

* updatedtable



* addeddashboards



* addspaces



* removespaces



* changes to RPM file



* addedredirects



* fixedlink



* Update _install-and-configure/install-opensearch/index.md




---------




(cherry picked from commit bfdd426)

Signed-off-by: Heather Halter <[email protected]>
Signed-off-by: Heather Halter <[email protected]>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: kolchfa-aws <[email protected]>
harshavamsi pushed a commit to harshavamsi/documentation-website that referenced this pull request Oct 31, 2023
…search-project#4218)

* updatedtable

Signed-off-by: Heather Halter <[email protected]>

* addeddashboards

Signed-off-by: Heather Halter <[email protected]>

* addspaces

Signed-off-by: Heather Halter <[email protected]>

* removespaces

Signed-off-by: Heather Halter <[email protected]>

* changes to RPM file

Signed-off-by: Heather Halter <[email protected]>

* addedredirects

Signed-off-by: Heather Halter <[email protected]>

* fixedlink

Signed-off-by: Heather Halter <[email protected]>

* Update _install-and-configure/install-opensearch/index.md

Co-authored-by: kolchfa-aws <[email protected]>
Signed-off-by: Heather Halter <[email protected]>

---------

Signed-off-by: Heather Halter <[email protected]>
Signed-off-by: Heather Halter <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
@hdhalter hdhalter deleted the opsysrequirements branch March 28, 2024 21:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
4 - Doc review PR: Doc review in progress backport 1.3 PR: Backport label for v1.3.x backport 2.8 PR: Backport label for 2.8
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[DOC]/install-and-configure/install-opensearch/rpm/#step-1-download-and-install-opensearch
3 participants