diff --git a/_opensearch/install/rpm.md b/_opensearch/install/rpm.md new file mode 100644 index 00000000..fd57955d --- /dev/null +++ b/_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-`.