Link Search Menu Expand Document Documentation Menu

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

    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

    sudo yum install opensearch-1.3.2-linux-x64.rpm
    sudo yum install opensearch-dashboards-1.3.2-linux-x64.rpm
    
    sudo rpm -ivh opensearch-1.3.2-linux-x64.rpm
    sudo rpm -ivh opensearch-dashboards-1.3.2-linux-x64.rpm
    

    arm64

    sudo yum install opensearch-1.3.2-linux-x64.rpm
    sudo yum install opensearch-dashboards-1.3.2-linux-arm64.rpm
    
    sudo rpm -ivh opensearch-1.3.2-linux-x64.rpm
    sudo rpm -ivh opensearch-dashboards-1.3.2-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:

    sudo curl -SL https://artifacts.opensearch.org/releases/bundle/opensearch/1.x/opensearch-1.x.repo -o /etc/yum.repos.d/opensearch-1.x.repo
    
    sudo curl -SL https://artifacts.opensearch.org/releases/bundle/opensearch-dashboards/1.x/opensearch-dashboards-1.x.repo -o /etc/yum.repos.d/opensearch-dashboards-1.x.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:

    sudo yum clean all
    
  3. With the repository file downloaded, list all available versions of OpenSearch:

    sudo yum list | grep opensearch
    
  4. Choose the version of OpenSearch you want to install:

    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:

    sudo yum install 'opensearch-1.3.2'
    
  5. During installation, the installer stops to see if the GPG key matches the OpenSearch project. Verify that the Fingerprint matches the following:

    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.

    sudo systemctl start opensearch.service
    sudo systemctl start opensearch-dashboards.service
    
  2. Send requests to the server to verify that OpenSearch is running:

    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:

    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:

sudo systemctl start opensearch-performance-analyzer.service

To stop the Performance Analyzer, enter:

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