Fix RPM 2.0 bug
Signed-off-by: Naarcha-AWS <naarcha@amazon.com>
This commit is contained in:
Naarcha-AWS
parent
de82c913c5
commit
035acb0755
|
|
@ -0,0 +1,157 @@
|
|||
---
|
||||
layout: default
|
||||
title: RPM
|
||||
parent: Install OpenSearch
|
||||
nav_order: 51
|
||||
---
|
||||
|
||||
# RPM
|
||||
|
||||
The RPM Package Manager (RPM) installation provides everything you need to run OpenSearch inside Red Hat or Red Hat-based Linux Distributions.
|
||||
|
||||
RPM supports CentOS 7 and 8, and Amazon Linux 2. If you have your own Java installation and set `JAVA_HOME` in your terminal application, macOS works, as well.
|
||||
|
||||
There are two methods for installing OpenSearch on RPM:
|
||||
|
||||
## Manual method
|
||||
|
||||
|
||||
1. Download the RPM package directly from the [OpenSearch downloads page](https://opensearch.org/downloads.html){:target='\_blank'}. The RPM package can be download both as `x64` and `arm64`.
|
||||
|
||||
2. Import the public GPG key. This key verifies that the your OpenSearch instance is signed.
|
||||
|
||||
```bash
|
||||
sudo rpm --import https://artifacts.opensearch.org/publickeys/opensearch.pgp
|
||||
```
|
||||
|
||||
3. On your host, use `sudo yum install` or `sudo rpm -ivh` to install the package.
|
||||
|
||||
**x64**
|
||||
|
||||
```bash
|
||||
sudo yum install opensearch-{{site.opensearch_version}}-linux-x64.rpm
|
||||
sudo yum install opensearch-dashboards-{{site.opensearch_version}}-linux-x64.rpm
|
||||
```
|
||||
|
||||
```bash
|
||||
sudo rpm -ivh opensearch-{{site.opensearch_version}}-linux-x64.rpm
|
||||
sudo rpm -ivh opensearch-dashboards-{{site.opensearch_version}}-linux-x64.rpm
|
||||
```
|
||||
|
||||
**arm64**
|
||||
|
||||
```bash
|
||||
sudo yum install opensearch-{{site.opensearch_version}}-linux-x64.rpm
|
||||
sudo yum install opensearch-dashboards-{{site.opensearch_version}}-linux-arm64.rpm
|
||||
```
|
||||
|
||||
```bash
|
||||
sudo rpm -ivh opensearch-{{site.opensearch_version}}-linux-x64.rpm
|
||||
sudo rpm -ivh opensearch-dashboards-{{site.opensearch_version}}-linux-arm64.rpm
|
||||
```
|
||||
|
||||
Once complete, you can run OpenSearch inside your distribution.
|
||||
|
||||
## YUM method
|
||||
|
||||
YUM, an RPM package management tool, allows you to pull the RPM package from the YUM repository library.
|
||||
|
||||
1. Create a repository file for both OpenSearch and OpenSearch Dashboards:
|
||||
|
||||
```bash
|
||||
sudo curl -SL https://artifacts.opensearch.org/releases/bundle/opensearch/2.x/opensearch-{{site.opensearch_version}}.repo -o /etc/yum.repos.d/{{site.opensearch_version}}.repo
|
||||
```
|
||||
|
||||
```bash
|
||||
sudo curl -SL https://artifacts.opensearch.org/releases/bundle/opensearch-dashboards/{{site.opensearch_version}}/opensearch-dashboards-{{site.opensearch_version}}.repo -o /etc/yum.repos.d/{{site.opensearch_version}}.repo
|
||||
```
|
||||
|
||||
To verify that the repos appear in your repo list, use `sudo yum repolist`.
|
||||
|
||||
2. Clean your YUM cache, to ensure a smooth installation:
|
||||
|
||||
```bash
|
||||
sudo yum clean all
|
||||
```
|
||||
|
||||
3. With the repository file downloaded, list all available versions of OpenSearch:
|
||||
|
||||
```bash
|
||||
sudo yum list | grep opensearch
|
||||
```
|
||||
|
||||
4. Choose the version of OpenSearch you want to install:
|
||||
|
||||
```bash
|
||||
sudo yum install opensearch
|
||||
sudo yum install opensearch-dashboards
|
||||
```
|
||||
|
||||
Unless otherwise indicated, the highest minor version of OpenSearch installs.
|
||||
|
||||
To install a specific version of OpenSearch:
|
||||
|
||||
```bash
|
||||
sudo yum install 'opensearch-{{site.opensearch_version}}'
|
||||
```
|
||||
|
||||
5. During installation, the installer stops to see if the GPG key matches the OpenSearch project. Verify that the `Fingerprint` matches the following:
|
||||
|
||||
```bash
|
||||
Fingerprint: c5b7 4989 65ef d1c2 924b a9d5 39d3 1987 9310 d3fc
|
||||
```
|
||||
|
||||
If correct, enter `yes` or `y`. The OpenSearch installation continues.
|
||||
|
||||
Once complete, you can run OpenSearch inside your distribution.
|
||||
|
||||
## Run OpenSearch
|
||||
|
||||
1. Run OpenSearch and OpenSearch Dashboards using `systemctl`.
|
||||
|
||||
```bash
|
||||
sudo systemctl start opensearch.service
|
||||
sudo systemctl start opensearch-dashboards.service
|
||||
```
|
||||
|
||||
2. Send requests to the server to verify that OpenSearch is running:
|
||||
|
||||
```bash
|
||||
curl -XGET https://localhost:9200 -u 'admin:admin' --insecure
|
||||
curl -XGET https://localhost:9200/_cat/config?v -u 'admin:admin' --insecure
|
||||
```
|
||||
|
||||
3. To stop running OpenSearch, enter:
|
||||
|
||||
```bash
|
||||
sudo systemctl stop opensearch.service
|
||||
sudo systemctl stop opensearch-dashboards.service
|
||||
```
|
||||
|
||||
|
||||
## *(Optional)* Set up Performance Analyzer
|
||||
|
||||
When enabled, the Performance Analyzer plugin collects data related to the performance of your OpenSearch instance. To start the Performance Analyzer plugin, enter:
|
||||
|
||||
```bash
|
||||
sudo systemctl start opensearch-performance-analyzer.service
|
||||
```
|
||||
|
||||
To stop the Performance Analyzer, enter:
|
||||
|
||||
```bash
|
||||
sudo systemctl stop opensearch-performance-analyzer.service
|
||||
```
|
||||
|
||||
## Upgrade RPM
|
||||
|
||||
You can upgrade your RPM OpenSearch instance both manually and through YUM.
|
||||
|
||||
|
||||
### Manual
|
||||
|
||||
Download the new version of OpenSearch you want to use, and then use `rmp -Uvh` to upgrade.
|
||||
|
||||
### YUM
|
||||
|
||||
To upgrade to the latest version of OpenSearch with YUM, use `sudo yum update`. You can also upgrade to a specific OpenSearch version by using `sudo yum update opensearch-<version-number>`.
|
||||
Loading…
Reference in New Issue