Skip to content

Latest commit

 

History

History
140 lines (96 loc) · 4.16 KB

deb.md

File metadata and controls

140 lines (96 loc) · 4.16 KB
Raw
layout title parent nav_order
default
Debian Package
Install and Configure
3

Debian package

Installing and running Open Distro for Elasticsearch from an Debian package is a more manual process than the Docker image. We recommend Ubuntu 16.04 or 18.04, but any Debian-based distribution that uses systemd should work.

RPM lets you install specific versions of Open Distro for Elasticsearch. You can install specific versions using Apt, but you have to manually install each dependency. {: .note }

These steps assume you're using Ubuntu 18.04.

  1. Install Java 11:

    sudo add-apt-repository ppa:openjdk-r/ppa
sudo apt update
sudo apt install openjdk-11-jdk

  2. Install unzip:

    sudo apt install unzip

  3. Download and add signing keys for the repositories:

    wget -qO - https://d3g5vo6xdbdb9a.cloudfront.net/GPG-KEY-opendistroforelasticsearch | sudo apt-key add -

  4. Add the repositories:

    echo "deb https://d3g5vo6xdbdb9a.cloudfront.net/apt stable main" | sudo tee -a   /etc/apt/sources.list.d/opendistroforelasticsearch.list

  5. Install Elasticsearch OSS:

    wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-oss-7.6.1-amd64.deb
sudo dpkg -i elasticsearch-oss-7.6.1-amd64.deb

  6. Install the latest version of Open Distro for Elasticsearch:

    sudo apt-get update
sudo apt install opendistroforelasticsearch

    If you don't want the latest version or encounter dependency errors, install the plugins individually:

    # List all available versions of a plugin
sudo apt list -a opendistro-alerting
# Install a specific version of a plugin
sudo apt install opendistro-alerting=1.2.0.0-1
sudo apt install opendistro-performance-analyzer=1.2.0.0-1
sudo apt install opendistro-job-scheduler=1.2.0.0-1
sudo apt install opendistro-security=1.2.0.0-0
sudo apt install opendistro-sql=1.2.0.0-1

    For compatibility by Elasticsearch version, see Plugin compatibility.

  7. To start Open Distro for Elasticsearch:

    sudo systemctl start elasticsearch.service

  8. Send requests to the server to verify that Elasticsearch is up and running:

    curl -XGET https://localhost:9200 -u admin:admin --insecure
curl -XGET https://localhost:9200/_cat/nodes?v -u admin:admin --insecure
curl -XGET https://localhost:9200/_cat/plugins?v -u admin:admin --insecure

  9. For instructions on installing and running Kibana, see Kibana.

  10. To check the status of the service:

    systemctl status elasticsearch.service

  11. To stop Open Distro for Elasticsearch:

    sudo systemctl stop elasticsearch.service

Configuration

To run Open Distro for Elasticsearch when the system starts:

sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable elasticsearch.service

You can also modify the values in /etc/default/elasticsearch (JAVA_HOME, most notably), /etc/elasticsearch/elasticsearch.yml, and /etc/elasticsearch/jvm.options (to set the heap size, most notably). To learn more, see Elasticsearch configuration and Important Settings on the Docker page.

Where are the files?

The Debian package installs files to the following locations:

File type Location
Elasticsearch home, management scripts, and plugins /usr/share/elasticsearch/
Configuration files /etc/elasticsearch
Environment variables /etc/default/elasticsearch
Logs /var/log/elasticsearch
Shard data /var/lib/elasticsearch

Notes on Debian

If you are using Debian rather than Ubuntu, you likely need to make some modifications to the install process.

  1. When installing Java 11, rather than sudo add-apt-repository ppa:openjdk-r/ppa, run:

    sudo echo 'deb http://deb.debian.org/debian stretch-backports main' > /etc/apt/sources.list.d/backports.list

  2. Before installing Open Distro for Elasticsearch, run:

    apt install apt-transport-https