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

Add missing OPENSEARCH_INITIAL_ADMIN_PASSWORD for both apt/deb and yum/rpm #7079

Merged
merged 23 commits into from
May 6, 2024
Merged
Show file tree
Hide file tree
Changes from 8 commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
3a4ff09
Add missing OPENSEARCH_INITIAL_ADMIN_PASSWORD for apt install on deb…
drewmiranda-gl May 2, 2024
0ae9058
More update on deb and rpm installation steps on 2.12 security changes
peterzhuamazon May 3, 2024
d56ce2b
Merge remote-tracking branch 'upstream/main' into patch-1
peterzhuamazon May 3, 2024
64baec6
Move 2.12 top
peterzhuamazon May 3, 2024
6d40678
fix formatting
peterzhuamazon May 3, 2024
26f752b
More tweaks
peterzhuamazon May 3, 2024
58f811e
More tweaks 2
peterzhuamazon May 3, 2024
cad5372
Merge remote-tracking branch 'upstream/main' into patch-1
peterzhuamazon May 3, 2024
76c9202
Update _install-and-configure/install-opensearch/debian.md
peterzhuamazon May 6, 2024
78192a6
Update _install-and-configure/install-opensearch/debian.md
peterzhuamazon May 6, 2024
d20690b
Update _install-and-configure/install-opensearch/debian.md
peterzhuamazon May 6, 2024
eda32b2
Update _install-and-configure/install-opensearch/debian.md
peterzhuamazon May 6, 2024
28778da
Update _install-and-configure/install-opensearch/debian.md
peterzhuamazon May 6, 2024
38e115b
Update _install-and-configure/install-opensearch/rpm.md
peterzhuamazon May 6, 2024
8bed3ea
Update _install-and-configure/install-opensearch/rpm.md
peterzhuamazon May 6, 2024
4624174
Update _install-and-configure/install-opensearch/rpm.md
peterzhuamazon May 6, 2024
0d29e01
Update _install-and-configure/install-opensearch/rpm.md
peterzhuamazon May 6, 2024
279b489
Update _install-and-configure/install-opensearch/rpm.md
peterzhuamazon May 6, 2024
63a6855
Update _install-and-configure/install-opensearch/rpm.md
peterzhuamazon May 6, 2024
e7a073a
Update _install-and-configure/install-opensearch/rpm.md
peterzhuamazon May 6, 2024
35e85b5
Add more things
peterzhuamazon May 6, 2024
ae139f2
Add more things
peterzhuamazon May 6, 2024
e703f22
Update _install-and-configure/install-opensearch/debian.md
peterzhuamazon May 6, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 20 additions & 5 deletions _install-and-configure/install-opensearch/debian.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,20 +38,22 @@ This guide assumes that you are comfortable working from the Linux command line

1. Download the Debian package for the desired version directly from the [OpenSearch downloads page](https://opensearch.org/downloads.html){:target='\_blank'}. The Debian package can be downloaded for both **x64** and **arm64** architectures.
1. From the CLI, install using `dpkg`.

For new installations of OpenSearch 2.12 and later, you must define a custom admin password in order to set up a security demo configuration. Use one of the following commands to define a custom admin password:
peterzhuamazon marked this conversation as resolved.
Show resolved Hide resolved
```bash
# x64
sudo dpkg -i opensearch-{{site.opensearch_version}}-linux-x64.deb
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> dpkg -i opensearch-{{site.opensearch_version}}-linux-x64.deb

# arm64
sudo dpkg -i opensearch-{{site.opensearch_version}}-linux-arm64.deb
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> dpkg -i opensearch-{{site.opensearch_version}}-linux-arm64.deb
```
For OpenSearch 2.12 and greater, a custom admin password is required in order to set up a security demo configuration. To set a custom admin password, use one the following commands:
For OpenSearch versions before 2.12:
peterzhuamazon marked this conversation as resolved.
Show resolved Hide resolved
```bash
# x64
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> dpkg -i opensearch-{{site.opensearch_version}}-linux-x64.deb
sudo dpkg -i opensearch-{{site.opensearch_version}}-linux-x64.deb

# arm64
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> dpkg -i opensearch-{{site.opensearch_version}}-linux-arm64.deb
sudo dpkg -i opensearch-{{site.opensearch_version}}-linux-arm64.deb
```

1. After the installation succeeds, enable OpenSearch as a service.
Expand Down Expand Up @@ -136,14 +138,27 @@ APT, the primary package management tool for Debian–based operating systems, a

1. Choose the version of OpenSearch you want to install:
- Unless otherwise indicated, the latest available version of OpenSearch is installed.

```bash
# For new installations of OpenSearch 2.12 and later, you must define a custom admin password in order to set up a security demo configuration.
peterzhuamazon marked this conversation as resolved.
Show resolved Hide resolved
# Use one of the following commands to define a custom admin password:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Global: Please confirm proper formatting (Should there be so many # in the examples?).

sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> apt-get install opensearch

# For OpenSearch versions before 2.12:
sudo apt-get install opensearch
```
{% include copy.html %}

- To install a specific version of OpenSearch:

```bash
# Specify the version manually using opensearch=<version>

# For new installations of OpenSearch 2.12 and later, you must define a custom admin password in order to set up a security demo configuration.
peterzhuamazon marked this conversation as resolved.
Show resolved Hide resolved
# Use one of the following commands to define a custom admin password:
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> apt-get install opensearch={{site.opensearch_version}}

# For OpenSearch versions before 2.12:
peterzhuamazon marked this conversation as resolved.
Show resolved Hide resolved
sudo apt-get install opensearch={{site.opensearch_version}}
```

Expand Down
47 changes: 30 additions & 17 deletions _install-and-configure/install-opensearch/rpm.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,36 +44,37 @@ This guide assumes that you are comfortable working from the Linux command line
```
{% include copy.html %}

1. For OpenSearch 2.12 and greater, a custom admin password is required in order to set up a security demo configuration. To set a custom admin password, use one the following commands:
1. From the CLI, you can install the package with `rpm` or `yum`.
peterzhuamazon marked this conversation as resolved.
Show resolved Hide resolved

```bash
# Install the x64 package using yum.
# For new installations of OpenSearch 2.12 and later, you must define a custom admin password in order to set up a security demo configuration.
peterzhuamazon marked this conversation as resolved.
Show resolved Hide resolved
# Use one of the following commands to define a custom admin password:

## Install the x64 package using yum.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Here and below, should "rpm" and "yum" be in code font, as above?

sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> yum install opensearch-{{site.opensearch_version}}-linux-x64.rpm

# Install the x64 package using rpm.
## Install the x64 package using rpm.
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> rpm -ivh opensearch-{{site.opensearch_version}}-linux-x64.rpm

# Install the arm64 package using yum.
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> yum install opensearch-{{site.opensearch_version}}-linux-x64.rpm
## Install the arm64 package using yum.
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> yum install opensearch-{{site.opensearch_version}}-linux-arm64.rpm

# Install the arm64 package using rpm.
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> rpm -ivh opensearch-{{site.opensearch_version}}-linux-x64.rpm
```
## Install the arm64 package using rpm.
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> rpm -ivh opensearch-{{site.opensearch_version}}-linux-arm64.rpm

1. From the CLI, you can install the package with `rpm` or `yum`.
# For OpenSearch versions before 2.12:
peterzhuamazon marked this conversation as resolved.
Show resolved Hide resolved

```bash
# Install the x64 package using yum.
## Install the x64 package using yum.
sudo yum install opensearch-{{site.opensearch_version}}-linux-x64.rpm

# Install the x64 package using rpm.
## Install the x64 package using rpm.
sudo rpm -ivh opensearch-{{site.opensearch_version}}-linux-x64.rpm

# Install the arm64 package using yum.
sudo yum install opensearch-{{site.opensearch_version}}-linux-x64.rpm
## Install the arm64 package using yum.
sudo yum install opensearch-{{site.opensearch_version}}-linux-arm64.rpm

# Install the arm64 package using rpm.
sudo rpm -ivh opensearch-{{site.opensearch_version}}-linux-x64.rpm
## Install the arm64 package using rpm.
sudo rpm -ivh opensearch-{{site.opensearch_version}}-linux-arm64.rpm
```

1. After the installation succeeds, enable OpenSearch as a service.
Expand Down Expand Up @@ -125,15 +126,27 @@ YUM, the primary package management tool for Red Hat–based operating systems,
```
{% include copy.html %}

1. Choose the version of OpenSearch you want to install:
1. Choose the version of OpenSearch you want to install:
- Unless otherwise indicated, the latest available version of OpenSearch is installed.

```bash
# For OpenSearch 2.12 and greater, a custom admin password is required in order to set up a security demo configuration for new installation.
peterzhuamazon marked this conversation as resolved.
Show resolved Hide resolved
# To set a custom admin password, use the following commands:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Should "command" be singular?

sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> yum install opensearch

# For OpenSearch versions before 2.12:
peterzhuamazon marked this conversation as resolved.
Show resolved Hide resolved
sudo yum install opensearch
```
{% include copy.html %}

- To install a specific version of OpenSearch:

```bash
# For new installations of OpenSearch 2.12 and later, you must define a custom admin password in order to set up a security demo configuration.
peterzhuamazon marked this conversation as resolved.
Show resolved Hide resolved
# Use one of the following commands to define a custom admin password:
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> yum install 'opensearch-{{site.opensearch_version}}'

# For OpenSearch versions before 2.12:
peterzhuamazon marked this conversation as resolved.
Show resolved Hide resolved
sudo yum install 'opensearch-{{site.opensearch_version}}'
```
{% include copy.html %}
Expand Down
Loading