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

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

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

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

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo gpg --dearmor -o /usr/share/keyrings/elasticsearch-keyring.gpg

Возможно, вам потребуется установить пакет apt-transport-https в Debian, прежде чем продолжить:

sudo apt-get install apt-transport-https

Сохраните определение репозитория в /etc/apt/sources.list.d/elastic-7.x.list:

echo "deb [signed-by=/usr/share/keyrings/elasticsearch-keyring.gpg] https://artifacts.elastic.co/packages/7.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic-7.x.list

Вы можете установить пакет Elasticsearch Debian с помощью:

sudo apt-get update && sudo apt-get install elasticsearch

Duplicate sources.list entry https://artifacts.elastic.co/packages/7.x/apt/ ...`

Пакет Debian для Elasticsearch v7.17.28 можно загрузить с веб-сайта и установить следующим образом:

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.28-amd64.deb
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.28-amd64.deb.sha512
shasum -a 512 -c elasticsearch-7.17.28-amd64.deb.sha512 
sudo dpkg -i elasticsearch-7.17.28-amd64.deb

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

ps -p 1

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

sudo update-rc.d elasticsearch defaults 95 10

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 пароль хранилища ключей с помощью локального файла и системных переменных среды. Этот локальный файл следует защитить, пока он существует, и его можно безопасно удалить после того, как 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.

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

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