Merge pull request #612 from opensearch-project/fix-rpm-bug

Fix RPM 2.0 bug

_opensearch/install/rpm.md

@@ -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>`.