Установка Elasticsearch с .zip на Windows
Elasticsearch можно установить на Windows с помощью архива Windows .zip. В нём есть команда elasticsearch-service.bat, которая настроит Elasticsearch для работы в качестве службы.
Этот пакет содержит как бесплатные, так и подписные функции. Начните 30-дневную пробную версию, чтобы опробовать все функции.
На Windows функция машинного обучения Elasticsearch требует библиотеку Microsoft Universal C Runtime. Она включена в Windows 10, Windows Server 2016 и более поздние версии Windows. Для более старых версий Windows её можно установить через Windows Update или с отдельного скачивания. Если вы не можете установить библиотеку Microsoft Universal C Runtime, вы по-прежнему можете использовать остальную часть Elasticsearch, если отключите функцию машинного обучения.
Самую последнюю стабильную версию Elasticsearch можно найти на странице Загрузка Elasticsearch. Другие версии можно найти на странице Предыдущие версии.
Elasticsearch включает в себя встроенную версию OpenJDK от разработчиков JDK (GPLv2+CE). Чтобы использовать свою версию Java, см. требования к версии JVM
Загрузка и установка пакета .zip
Загрузите архив .zip для Elasticsearch v7.17.28 от: https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.28-windows-x86_64.zip
Распакуйте его с помощью вашего любимого инструмента для распаковки архивов. Это создаст папку под названием elasticsearch-7.17.28, которую мы будем называть %ES_HOME%. В окне терминала, cd в каталог %ES_HOME%, например:
cd c:\elasticsearch-7.17.28
Включение автоматического создания системных индексов
Некоторые коммерческие функции автоматически создают индексы в Elasticsearch. По умолчанию Elasticsearch настроен на разрешение автоматического создания индексов, и дополнительные шаги не требуются. Однако, если вы отключили автоматическое создание индексов в Elasticsearch, вам необходимо настроить action.auto_create_index в elasticsearch.yml, чтобы разрешить коммерческим функциям создавать следующие индексы:
action.auto_create_index: .monitoring*,.watches,.triggered_watches,.watcher-history*,.ml*
Если вы используете Logstash или Beats, вам, скорее всего, потребуются дополнительные имена индексов в настройке action.auto_create_index, а точное значение будет зависеть от вашей локальной конфигурации. Если вы не уверены в правильном значении для вашей среды, вы можете установить значение в *, что позволит автоматически создавать все индексы.
Запуск Elasticsearch из командной строки
Elasticsearch можно запустить из командной строки следующим образом:
.\bin\elasticsearch.bat
Если вы защитили хранилище ключей Elasticsearch паролем, вам будет предложено ввести пароль хранилища ключей. Подробнее см. Безопасные настройки.
По умолчанию Elasticsearch выводит свои журналы в консоль (STDOUT) и в файл <cluster
name>.log в каталоге журналов logs. Elasticsearch регистрирует некоторую информацию во время запуска, но как только он завершит инициализацию, он продолжит работу в фоновом режиме и не будет регистрировать ничего дальше, пока не произойдёт событие, достойное записи. Во время работы Elasticsearch вы можете взаимодействовать с ним через его HTTP-интерфейс, который по умолчанию находится на порту 9200. Чтобы остановить Elasticsearch, нажмите Ctrl-C.
Настройка Elasticsearch в командной строке
Elasticsearch загружает свою конфигурацию из файла %ES_HOME%\config\elasticsearch.yml по умолчанию. Формат этого файла конфигурации описан в Настройка Elasticsearch.
Любые настройки, которые можно указать в файле конфигурации, также можно указать в командной строке, используя синтаксис -E следующим образом:
.\bin\elasticsearch.bat -Ecluster.name=my_cluster -Enode.name=node_1
Значения, содержащие пробелы, должны быть заключены в кавычки. Например, -Epath.logs="C:\My Logs\logs".
Как правило, любые настройки кластера (например, cluster.name) должны быть добавлены в файл конфигурации elasticsearch.yml, а любые узловые настройки, такие как node.name, могут быть указаны в командной строке.
Проверка работы 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"
} Установка Elasticsearch в качестве службы на Windows
Elasticsearch можно установить в качестве службы, чтобы она работала в фоновом режиме или запускалась автоматически при загрузке системы без какого-либо взаимодействия пользователя. Это можно сделать с помощью скрипта elasticsearch-service.bat в папке bin\, который позволяет устанавливать, удалять, управлять или настраивать службу, а также потенциально запускать и останавливать службу, все из командной строки.
c:\elasticsearch-7.17.28\bin>elasticsearch-service.bat Usage: elasticsearch-service.bat install|remove|start|stop|manager [SERVICE_ID]
Скрипт требует одного параметра (команда для выполнения) и необязательного, указывающего идентификатор службы (полезно при установке нескольких служб Elasticsearch).
Доступные команды:
| | Установка Elasticsearch в качестве службы |
| | Удаление установленной службы Elasticsearch (и остановка службы, если она запущена) |
| | Запуск службы Elasticsearch (если она установлена) |
| | Остановка службы Elasticsearch (если она запущена) |
| | Запуск графического интерфейса для управления установленной службой |
Имя службы и значение ES_JAVA_HOME будут доступны во время установки:
c:\elasticsearch-7.17.28\bin>elasticsearch-service.bat install Installing service : "elasticsearch-service-x64" Using ES_JAVA_HOME (64-bit): "c:\jvm\jdk1.8" The service 'elasticsearch-service-x64' has been installed.
Хотя для службы Elasticsearch можно использовать JRE, из-за использования клиентской виртуальной машины (по сравнению с серверной JVM, которая обеспечивает лучшую производительность для долго выполняемых приложений) его использование не рекомендуется, и будет выведено предупреждение.
Переменная среды системы ES_JAVA_HOME должна быть установлена в путь к установке JDK, который вы хотите использовать для службы. Если вы обновите JDK, вам не нужно переустанавливать службу, но вы должны установить значение переменной среды системы ES_JAVA_HOME в путь к новой установке JDK. Однако обновление через типы JVM (например, JRE и SE) не поддерживается и требует переустановки службы.
Настройка параметров службы
Службу Elasticsearch можно настроить перед установкой, задав следующие переменные среды (либо с помощью команды set из командной строки, либо через графический интерфейс System Properties->Environment Variables).
| | Уникальный идентификатор службы. Полезно при установке нескольких экземпляров на одном компьютере. По умолчанию |
| | Пользователь, от имени которого нужно запустить, по умолчанию локальный системный аккаунт. |
| | Пароль для пользователя, указанного в |
| | Имя службы. По умолчанию |
| | Описание службы. По умолчанию |
| | Директория установки желаемой JVM для запуска службы. |
| | Каталог журнала службы, по умолчанию |
| | Директория файла конфигурации (которая должна содержать файлы |
| | Любые дополнительные системные свойства JVM, которые вы хотите применить. |
| | Режим запуска службы. Может быть |
| | Таймаут в секундах, который procrun ожидает, чтобы служба завершилась корректно. По умолчанию |
В основе elasticsearch-service.bat лежит проект Apache Commons Daemon, который устанавливает службу. Переменные среды, заданные до установки службы, копируются и будут использоваться во время жизненного цикла службы. Это означает, что любые изменения, внесенные в них после установки, не будут учтены, пока служба не будет переустановлена.
По умолчанию Elasticsearch автоматически настраивает размер кучи JVM на основе ролей узла узла и общего объема памяти. Мы рекомендуем этот размер по умолчанию для большинства производственных сред. При необходимости вы можете переопределить размер по умолчанию, вручную задав размер кучи.
При первой установке Elasticsearch в качестве службы на Windows или при запуске Elasticsearch из командной строки можно вручную установить размер кучи JVM. Чтобы изменить размер кучи для уже установленной службы, используйте диспетчер служб: bin\elasticsearch-service.bat manager.
Служба автоматически настраивает отдельную временную директорию для использования Elasticsearch во время работы. Эта временная директория настроена как поддиректория временной директории пользователя, выполняющего установку. Если служба будет работать от имени другого пользователя, вы можете настроить расположение временной директории, которую должна использовать служба, задав переменную среды ES_TMPDIR в нужном расположении перед выполнением установки службы.
- Использование графического интерфейса менеджера
- Также можно настроить службу после её установки, используя графический интерфейс менеджера (
elasticsearch-service-mgr.exe), который предоставляет информацию об установленной службе, включая её состояние, тип запуска, JVM, настройки запуска и остановки и многое другое. Просто вызвавelasticsearch-service.bat managerиз командной строки, откроется окно менеджера:
Большинство изменений (например, настройки JVM), внесённых через графический интерфейс менеджера, потребуют перезапуска службы, чтобы они вступили в силу.
Схема расположения папок архива .zip
Пакет .zip полностью самодостаточен. Все файлы и папки, по умолчанию, находятся внутри %ES_HOME% — папки, созданной при распаковке архива.
Это очень удобно, так как вам не нужно создавать какие-либо папки, чтобы начать использовать Elasticsearch, а удаление Elasticsearch так же просто, как и удаление папки %ES_HOME%. Тем не менее, рекомендуется изменить расположение папок конфигурации, данных и логов, чтобы не удалить важные данные впоследствии.
| Тип | Описание | Расположение по умолчанию | Настройка |
|---|---|---|---|
home | Основной каталог Elasticsearch или | Папка, созданная при распаковке архива | |
bin | Скрипты бинарных файлов, включая |
| |
conf | Файлы конфигурации, включая |
| |
data | Расположение файлов данных каждого индекса/фрагмента, выделенного на узле. |
|
|
logs | Расположение файлов журналов. |
|
|
plugins | Расположение файлов плагинов. Каждый плагин будет находиться в подкаталоге. |
| |
repo | Расположения репозиториев общей файловой системы. Может содержать несколько расположений. Репозиторий файловой системы может быть помещён в любой подкаталог любой указанной здесь папки. | Не настроено |
|
Следующие шаги
Теперь у вас есть тестовая среда Elasticsearch. Перед началом серьёзной разработки или переходом в производство с Elasticsearch необходимо выполнить дополнительные настройки:
- Узнайте, как настроить Elasticsearch.
- Настройте важные настройки Elasticsearch.
- Настройте важные системные настройки.
© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/zip-windows.html