Установка Elasticsearch с помощью RPM

Мы подписываем все наши пакеты с помощью ключа Elasticsearch Signing Key (PGP-ключ D88E42B4, доступный на https://pgp.mit.edu) с отпечатком:

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4

Загрузите и установите открытый ключ подписи:

rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

Создайте файл под названием elasticsearch.repo в директории /etc/yum.repos.d/ для дистрибутивов на основе RedHat или в директории /etc/zypp/repos.d/ для дистрибутивов на основе OpenSuSE, содержащий:

[elasticsearch]
name=Elasticsearch repository for 7.x packages
baseurl=https://artifacts.elastic.co/packages/7.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=0
autorefresh=1
type=rpm-md

И ваш репозиторий готов к использованию. Теперь вы можете установить Elasticsearch с помощью одной из следующих команд:

sudo yum install --enablerepo=elasticsearch elasticsearch 
sudo dnf install --enablerepo=elasticsearch elasticsearch 
sudo zypper modifyrepo --enable elasticsearch && \
  sudo zypper install elasticsearch; \
  sudo zypper modifyrepo --disable elasticsearch 

RPM для Elasticsearch версии 7.17.28 можно загрузить с сайта и установить следующим образом:

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.28-x86_64.rpm
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.28-x86_64.rpm.sha512
shasum -a 512 -c elasticsearch-7.17.28-x86_64.rpm.sha512 
sudo rpm --install elasticsearch-7.17.28-x86_64.rpm

Elasticsearch не запускается автоматически после установки. Способ запуска и остановки Elasticsearch зависит от того, использует ли ваша система SysV init или systemd (используется более новыми дистрибутивами). Вы можете определить, какой из них используется, выполнив эту команду:

ps -p 1

Используйте команду chkconfig для настройки Elasticsearch на автоматический запуск при загрузке системы:

sudo chkconfig --add elasticsearch

Elasticsearch можно запустить и остановить с помощью команды service:

sudo -i service elasticsearch start
sudo -i service elasticsearch stop

Если Elasticsearch не удалось запустить по какой-либо причине, причина будет выведена в STDOUT. Лог-файлы можно найти в /var/log/elasticsearch/.

Чтобы настроить Elasticsearch на автоматический запуск при загрузке системы, выполните следующие команды:

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

Elasticsearch можно запустить и остановить следующим образом:

sudo systemctl start elasticsearch.service
sudo systemctl stop elasticsearch.service

Эти команды не предоставляют обратной связи о том, успешно ли был запущен Elasticsearch. Вместо этого эта информация будет записана в лог-файлы, расположенные в /var/log/elasticsearch/.

Если вы защитили свой хранилище ключей Elasticsearch паролем, вам нужно будет предоставить systemd с паролем хранилища ключей с помощью локального файла и переменных окружения systemd. Этот локальный файл должен быть защищен во время своего существования и может быть безопасно удален после запуска Elasticsearch.

echo "keystore_password" > /path/to/my_pwd_file.tmp
chmod 600 /path/to/my_pwd_file.tmp
sudo systemctl set-environment ES_KEYSTORE_PASSPHRASE_FILE=/path/to/my_pwd_file.tmp
sudo systemctl start elasticsearch.service

По умолчанию служба Elasticsearch не регистрирует информацию в журнале systemd. Чтобы включить ведение журнала journalctl, параметр --quiet должен быть удален из командной строки ExecStart в файле elasticsearch.service.

Когда ведение журнала systemd включено, информация о регистрации доступна с помощью команд journalctl:

Чтобы просмотреть журнал:

sudo journalctl -f

Чтобы получить список записей журнала для службы elasticsearch:

sudo journalctl --unit elasticsearch

Чтобы получить список записей журнала для службы elasticsearch, начиная с определенного времени:

sudo journalctl --unit elasticsearch --since  "2016-10-30 18:17:16"

См. man journalctl или https://www.freedesktop.org/software/systemd/man/journalctl.html для получения дополнительных командных параметров.

[2022-01-31T01:22:31,077][INFO ][o.e.n.Node               ] [instance-0000000123] starting ...
...
[2022-01-31T01:37:15,077][INFO ][o.e.n.Node               ] [instance-0000000123] stopping ...

Jan 31 01:22:30 debian systemd[1]: Starting Elasticsearch...
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Start operation timed out. Terminating.
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Main process exited, code=killed, status=15/TERM
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Failed with result 'timeout'.
Jan 31 01:37:15 debian systemd[1]: Failed to start Elasticsearch.

Вы можете проверить, что ваш узел Elasticsearch работает, отправив HTTP-запрос на порт 9200 на localhost:

GET /

который должен вернуть ответ примерно такого вида:

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "7.17.28",
    "build_flavor" : "default",
    "build_type" : "tar",
    "build_hash" : "f27399d",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "8.11.3",
    "minimum_wire_compatibility_version" : "1.2.3",
    "minimum_index_compatibility_version" : "1.2.3"
  },
  "tagline" : "You Know, for Search"
}

Директория /etc/elasticsearch содержит стандартную конфигурацию Elasticsearch во время выполнения. При установке пакета права владения этой директорией и всеми содержащимися файлами устанавливаются на root:elasticsearch.

Флаг setgid применяет групповые права доступа к директории /etc/elasticsearch, гарантируя, что Elasticsearch может читать все содержащиеся файлы и подкаталоги. Все файлы и подкаталоги наследуют права владения root:elasticsearch. Для выполнения команд из этой директории или любых поддиректорий, таких как инструмент elasticsearch-keystore, требуются права root:elasticsearch.

Elasticsearch по умолчанию загружает конфигурацию из файла /etc/elasticsearch/elasticsearch.yml. Формат этого конфигурационного файла описан в Настройка Elasticsearch.

RPM также содержит системный конфигурационный файл (/etc/sysconfig/elasticsearch), который позволяет настроить следующие параметры:

RPM размещает конфигурационные файлы, логи и директорию данных в соответствующих местах для систем на базе RPM: