Skip to content

Commit 529b968

Browse files
github-actions[bot]peterzhuamazonnatebower
committed
Add missing OPENSEARCH_INITIAL_ADMIN_PASSWORD for both apt/deb and yum/rpm (#7079)
* Add missing OPENSEARCH_INITIAL_ADMIN_PASSWORD for apt install on debian.md This page's install command when installing via rep package is missing `OPENSEARCH_INITIAL_ADMIN_PASSWORD` Signed-off-by: Drew Miranda <107503402+drewmiranda-gl@users.noreply.github.com> * More update on deb and rpm installation steps on 2.12 security changes Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Move 2.12 top Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * fix formatting Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * More tweaks Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * More tweaks 2 Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/debian.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/debian.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/debian.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/debian.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/debian.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/rpm.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/rpm.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/rpm.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/rpm.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/rpm.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/rpm.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/rpm.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Add more things Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Add more things Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> * Update _install-and-configure/install-opensearch/debian.md Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> --------- Signed-off-by: Drew Miranda <107503402+drewmiranda-gl@users.noreply.github.com> Signed-off-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Peter Zhu <zhujiaxi@amazon.com> Co-authored-by: Nathan Bower <nbower@amazon.com> (cherry picked from commit 4f2a458) Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent beea4c0 commit 529b968

2 files changed

Lines changed: 51 additions & 23 deletions

File tree

‎_install-and-configure/install-opensearch/debian.md‎

Lines changed: 21 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -37,21 +37,23 @@ This guide assumes that you are comfortable working from the Linux command line
3737
### Install OpenSearch from a package
3838

3939
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.
40-
1. From the CLI, install using `dpkg`.
40+
1. From the CLI, install the package using `dpkg`:
41+
42+
For new installations of OpenSearch 2.12 and later, you must define a custom admin password in order to set up a demo security configuration. Use one of the following commands to define a custom admin password:
4143
```bash
4244
# x64
43-
sudo dpkg -i opensearch-{{site.opensearch_version}}-linux-x64.deb
45+
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> dpkg -i opensearch-{{site.opensearch_version}}-linux-x64.deb
4446

4547
# arm64
46-
sudo dpkg -i opensearch-{{site.opensearch_version}}-linux-arm64.deb
48+
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> dpkg -i opensearch-{{site.opensearch_version}}-linux-arm64.deb
4749
```
48-
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:
50+
Use the following command for OpenSearch versions 2.11 and earlier:
4951
```bash
5052
# x64
51-
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> dpkg -i opensearch-{{site.opensearch_version}}-linux-x64.deb
53+
sudo dpkg -i opensearch-{{site.opensearch_version}}-linux-x64.deb
5254

5355
# arm64
54-
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> dpkg -i opensearch-{{site.opensearch_version}}-linux-arm64.deb
56+
sudo dpkg -i opensearch-{{site.opensearch_version}}-linux-arm64.deb
5557
```
5658

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

137139
1. Choose the version of OpenSearch you want to install:
138140
- Unless otherwise indicated, the latest available version of OpenSearch is installed.
141+
139142
```bash
143+
# For new installations of OpenSearch 2.12 and later, you must define a custom admin password in order to set up a demo security configuration.
144+
# Use one of the following commands to define a custom admin password:
145+
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> apt-get install opensearch
146+
147+
# Use the following command for OpenSearch versions 2.11 and earlier:
140148
sudo apt-get install opensearch
141149
```
142150
{% include copy.html %}
143151

144152
- To install a specific version of OpenSearch:
153+
145154
```bash
146155
# Specify the version manually using opensearch=<version>
156+
157+
# For new installations of OpenSearch 2.12 and later, you must define a custom admin password in order to set up a demo security configuration.
158+
# Use one of the following commands to define a custom admin password:
159+
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> apt-get install opensearch={{site.opensearch_version}}
160+
161+
# Use the following command for OpenSearch versions 2.11 and earlier:
147162
sudo apt-get install opensearch={{site.opensearch_version}}
148163
```
149164

‎_install-and-configure/install-opensearch/rpm.md‎

Lines changed: 30 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -44,36 +44,37 @@ This guide assumes that you are comfortable working from the Linux command line
4444
```
4545
{% include copy.html %}
4646

47-
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:
47+
1. From the CLI, you can install the package with `rpm` or `yum`:
4848

4949
```bash
50-
# Install the x64 package using yum.
50+
# For new installations of OpenSearch 2.12 and later, you must define a custom admin password in order to set up a demo security configuration.
51+
# Use one of the following commands to define a custom admin password:
52+
53+
## Install the x64 package using yum.
5154
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> yum install opensearch-{{site.opensearch_version}}-linux-x64.rpm
5255
53-
# Install the x64 package using rpm.
56+
## Install the x64 package using rpm.
5457
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> rpm -ivh opensearch-{{site.opensearch_version}}-linux-x64.rpm
5558
56-
# Install the arm64 package using yum.
57-
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> yum install opensearch-{{site.opensearch_version}}-linux-x64.rpm
59+
## Install the arm64 package using yum.
60+
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> yum install opensearch-{{site.opensearch_version}}-linux-arm64.rpm
5861
59-
# Install the arm64 package using rpm.
60-
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> rpm -ivh opensearch-{{site.opensearch_version}}-linux-x64.rpm
61-
```
62+
## Install the arm64 package using rpm.
63+
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> rpm -ivh opensearch-{{site.opensearch_version}}-linux-arm64.rpm
6264
63-
1. From the CLI, you can install the package with `rpm` or `yum`.
65+
# Use the following command for OpenSearch versions 2.11 and earlier:
6466
65-
```bash
66-
# Install the x64 package using yum.
67+
## Install the x64 package using yum.
6768
sudo yum install opensearch-{{site.opensearch_version}}-linux-x64.rpm
6869
69-
# Install the x64 package using rpm.
70+
## Install the x64 package using rpm.
7071
sudo rpm -ivh opensearch-{{site.opensearch_version}}-linux-x64.rpm
7172
72-
# Install the arm64 package using yum.
73-
sudo yum install opensearch-{{site.opensearch_version}}-linux-x64.rpm
73+
## Install the arm64 package using yum.
74+
sudo yum install opensearch-{{site.opensearch_version}}-linux-arm64.rpm
7475
75-
# Install the arm64 package using rpm.
76-
sudo rpm -ivh opensearch-{{site.opensearch_version}}-linux-x64.rpm
76+
## Install the arm64 package using rpm.
77+
sudo rpm -ivh opensearch-{{site.opensearch_version}}-linux-arm64.rpm
7778
```
7879

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

128-
1. Choose the version of OpenSearch you want to install:
129+
1. Choose the version of OpenSearch you want to install:
129130
- Unless otherwise indicated, the latest available version of OpenSearch is installed.
131+
130132
```bash
133+
# For OpenSearch versions 2.12 and later, a custom admin password is required in order to set up a demo security configuration for a new installation.
134+
# To set a custom admin password, use the following commands:
135+
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> yum install opensearch
136+
137+
# Use the following command for OpenSearch versions 2.11 and earlier:
131138
sudo yum install opensearch
132139
```
133140
{% include copy.html %}
134141

135142
- To install a specific version of OpenSearch:
143+
136144
```bash
145+
# For OpenSearch versions 2.12 and later, a custom admin password is required in order to set up a demo security configuration for a new installation.
146+
# To set a custom admin password, use the following commands:
147+
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> yum install 'opensearch-{{site.opensearch_version}}'
148+
149+
# Use the following command for OpenSearch versions 2.11 and earlier:
137150
sudo yum install 'opensearch-{{site.opensearch_version}}'
138151
```
139152
{% include copy.html %}

0 commit comments

Comments
 (0)