rpm.md

layout	title	parent	nav_order	redirect_from
default	RPM	Installing OpenSearch Dashboards	31	/dashboards/install/rpm/

{% comment %} The following liquid syntax declares a variable, major_version_mask, which is transformed into "N.x" where "N" is the major version number. This is required for proper versioning references to the Yum repo. {% endcomment %} {% assign version_parts = site.opensearch_major_minor_version | split: "." %} {% assign major_version_mask = version_parts[0] | append: ".x" %}

Run OpenSearch Dashboards using RPM Package Manager (RPM)

OpenSearch Dashboards is the default visualization tool for data in OpenSearch. It also serves as a user interface for many of the OpenSearch plugins, including security, alerting, Index State Management, SQL, and more.

Install OpenSearch Dashboards from a package

1. Download the RPM package for the desired version directly from the OpenSearch downloads page{:target='_blank'}. The RPM package can be download for both x64 and arm64 architectures.
2. Import the public GPG key. This key verifies that your OpenSearch instance is signed.

   sudo rpm --import https://artifacts.opensearch.org/publickeys/opensearch.pgp

3. From the command line interface (CLI), you can install the package with rpm or yum. x64

   # Install the x64 package using yum.
   sudo yum install opensearch-dashboards-{{site.opensearch_version}}-linux-x64.rpm
   # Install the x64 package using rpm.
   sudo rpm -ivh opensearch-dashboards-{{site.opensearch_version}}-linux-x64.rpm

   arm64

   # Install the arm64 package using yum.
   sudo yum install opensearch-dashboards-{{site.opensearch_version}}-linux-arm64.rpm
   # Install the arm64 package using rpm.
   sudo rpm -ivh opensearch-dashboards-{{site.opensearch_version}}-linux-arm64.rpm

4. After the installation succeeds, enable OpenSearch Dashboards as a service.

   sudo systemctl enable opensearch-dashboards

5. Start OpenSearch Dashboards.

   sudo systemctl start opensearch-dashboards

6. Verify that OpenSearch Dashboards launched correctly.

   sudo systemctl status opensearch-dashboards

Install OpenSearch Dashboards from a local YUM repository

YUM, the primary package management tool for Red Hat-based operating systems, allows you to download and install the RPM package from the YUM repository library.

1. Create a local repository file for OpenSearch Dashboards:

   sudo curl -SL https://artifacts.opensearch.org/releases/bundle/opensearch-dashboards/{{major_version_mask}}/opensearch-dashboards-{{major_version_mask}}.repo -o /etc/yum.repos.d/opensearch-dashboards-{{major_version_mask}}.repo

2. Verify that the repository was created successfully.

   sudo yum repolist

3. Clean your YUM cache, to ensure a smooth installation:

   sudo yum clean all

4. With the repository file downloaded, list all available versions of OpenSearch-Dashboards:

   sudo yum list opensearch-dashboards --showduplicates

5. Choose the version of OpenSearch Dashboards you want to install:
   • Unless otherwise indicated, the highest minor version of OpenSearch installs.

   sudo yum install opensearch-dashboards

   • To install a specific version of OpenSearch Dashboards:

   sudo yum install 'opensearch-dashboards-{{site.opensearch_version}}'

6. During installation, the installer will present you with the GPG key fingerprint. Verify that the information matches the following:

   Fingerprint: c5b7 4989 65ef d1c2 924b a9d5 39d3 1987 9310 d3fc

   • If correct, enter yes or y. The OpenSearch installation continues.
7. Once complete, you can run OpenSearch Dashboards.

   sudo systemctl start opensearch-dashboards

Upgrade to a newer version

OpenSearch Dashboards instances installed using RPM or YUM can be easily upgraded to a newer version. We recommend using YUM, but you can also choose RPM.

Manual upgrade with RPM

Download the RPM package for the desired upgrade version directly from the OpenSearch Project downloads page{:target='_blank'}.

Navigate to the directory containing the distribution and run the following command:

rpm -Uvh opensearch-dashboards-{{site.opensearch_version}}-linux-x64.rpm

{% include copy.html %}

YUM

To upgrade to the latest version of OpenSearch Dashboards using YUM, run the following command:

sudo yum update opensearch-dashboards

{% include copy.html %}

You can also upgrade to a specific OpenSearch Dashboards version by providing the version number:

sudo yum update opensearch-dashboards-<version-number>

{% include copy.html %}

Automatically restart the service after a package upgrade

The OpenSearch Dashboards RPM package does not currently support automatically restarting the service after a package upgrade.