90 lines
3.8 KiB
Markdown
90 lines
3.8 KiB
Markdown
|
---
|
||
|
layout: default
|
||
|
title: RPM
|
||
|
parent: Install OpenSearch Dashboards
|
||
|
nav_order: 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](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
|
||
|
```
|