opensearch-docs-cn/_dashboards/install/rpm.md

3.8 KiB

layout title parent nav_order
default RPM Install OpenSearch Dashboards 31

{% 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