opensearch-docs-cn/_install-and-configure/install-dashboards/rpm.md

92 lines
3.9 KiB
Markdown
Raw Normal View History

---
layout: default
title: RPM
parent: Install OpenSearch Dashboards
nav_order: 31
redirect_from:
- /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](https://opensearch.org/downloads.html){:target='\_blank'}. The RPM package can be download for both **x64** and **arm64** architectures.
1. Import the public GPG key. This key verifies that your OpenSearch instance is signed.
```bash
sudo rpm --import https://artifacts.opensearch.org/publickeys/opensearch.pgp
```
1. From the command line interface (CLI), you can install the package with `rpm` or `yum`.
**x64**
```bash
# 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**
```bash
# 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
```
1. After the installation succeeds, enable OpenSearch Dashboards as a service.
```bash
sudo systemctl enable opensearch-dashboards
```
1. Start OpenSearch Dashboards.
```bash
sudo systemctl start opensearch-dashboards
```
1. Verify that OpenSearch Dashboards launched correctly.
```bash
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:
```bash
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
```
1. Verify that the repository was created successfully.
```bash
sudo yum repolist
```
1. Clean your YUM cache, to ensure a smooth installation:
```bash
sudo yum clean all
```
1. With the repository file downloaded, list all available versions of OpenSearch-Dashboards:
```bash
sudo yum list opensearch-dashboards --showduplicates
```
1. Choose the version of OpenSearch Dashboards you want to install:
- Unless otherwise indicated, the highest minor version of OpenSearch installs.
```bash
sudo yum install opensearch-dashboards
```
- To install a specific version of OpenSearch Dashboards:
```bash
sudo yum install 'opensearch-dashboards-{{site.opensearch_version}}'
```
1. During installation, the installer will present you with the GPG key fingerprint. Verify that the information 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.
1. Once complete, you can run OpenSearch Dashboards.
```bash
sudo systemctl start opensearch-dashboards
```