Установить систему Elasticsearch

Перед установкой ознакомьтесь с требованиями системы Elasticsearch в разделе по ссылке.

В данном разделе приведена инструкция по настройке Elasticsearch на Windows, при установке на Linux необходимо отредактировать пути к словарям Hunspell на соответствующие операционной системе Linux.

Систему полнотекстового поиска Elasticsearch нужно устанавливать в следующих случаях:

Планируется использовать функцию полнотекстового поиска по содержимому карточек.
Будет использоваться СУБД PostgreSQL.

Если планируется использовать СУБД Microsoft SQL, можно также использовать Elasticsearch или встроенную функцию полнотекстового поиска Microsoft SQL.

Elasticsearch может быть установлен на любой компьютер организации, который удовлетворяет требованиям данной системы полнотекстового поиска.

Загрузите систему Elasticsearch с сайта Elasticsearch или по данной ссылке и установите на компьютер. При установке не изменяйте настройки по умолчанию.

Рекомендуемая версия: Elasticsearch 7.14.0. Работоспособность с более высокими версиями не тестировалась.
Скачайте вручную и установите компонент "Ingest Attachment Processor" (позволяет индексировать файлы карточек) для Elasticsearch версии 7.14.0 с сайта Elasticsearch или по данной ссылке.
Создайте папку hunspell с подпапками en_US и ru_RU в директории C:\ProgramData\Elastic\Elasticsearch\config.

Сохраните словари Hunspell для Elasticsearch версии 7.14.0 в папки на компьютере, созданные на предыдущем шаге. Скачать словари можно по ссылкам ниже.

Словари необходимы для индексации с учетом морфологии.

Откройте указанные ниже файлы в браузере:
Вызовите контекстное меню в окне браузера и выберите пункт Сохранить как…

Рисунок 1. Сохранить как для файла "ru_RU.aff"

В открывшемся окне проводника проверьте путь до папки и имя файла, затем нажмите Сохранить.

Путь до папки:

C:\ProgramData\Elastic\Elasticsearch\config\hunspell\ru_RU для файлов ru_RU.dic и ru_RU.aff

C:\ProgramData\Elastic\Elasticsearch\config\hunspell\en_US для файлов en_US.dic и en_US.aff.

Расширение файлов должно быть .dic и .aff, тип файла должен быть Все файлы.

Не выбирайте тип файла Текстовый документ и не указывайте в имени файла расширение .txt.

Рисунок 2. Сохранение файла "ru_RU.dic"

Перезапустите Elasticsearch.

От имени администратора выполните в консоли "C:\Program Files\Elastic\Elasticsearch\bin\Elasticsearch-plugin.bat" install file:///%%path-to-ingest-attachment-7-14-0.zip%%.

%%path-to-ingest-attachment-7-14-0.zip%% необходимо заменить на путь загрузки компонента.

Если система Elasticsearch установлена отдельно от сервера Docsvision, настройте прослушивание публичного адреса.

По умолчанию Elasticsearch прослушивает только локальный адрес localhost, делая невозможным подключение сервиса полнотекстового индексирования Docsvision.

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

Откройте конфигурационный файл Elasticsearch: C:\ProgramData\Elastic\Elasticsearch\config\Elasticsearch.yml.
Добавьте в конец файла строку:
```
network.host: ${HOSTNAME}
```

Сохраните изменения.

Если не установлены дополнительные меры ограничения, данные полнотекстового индексирования станут публичными.

Перезапустите службу Elasticsearch.
В конфигурационный файл Elasticsearch добавьте следующую строку:
```
discovery.type: single-node
```
Добавлять строку необходимо в следующих случаях:
- Если информация о системе Elasticsearch не отображается.
- Если возникают ошибки подключения к серверу службы Elasticsearch.
- Если система Elasticsearch не работает.

Проверьте доступность системы Elasticsearch.

Откройте в веб-браузере (на компьютере с Elasticsearch, если прослушивается только локальный адрес, или на любом другом компьютере, если прослушивается публичный адрес) страницу http://Elasticsearch-address:9200.

Должна отобразиться информация о системе Elasticsearch:

{
  "name" : "elastic.company.com",
  "cluster_name" : "Elasticsearch",
  "cluster_uuid" : "H9LHsBYIQMeEZsCytXOIbQ",
  "version" : {
    "number" : "5.5.0",
    "build_hash" : "260387d",
    "build_date" : "2017-06-30T23:16:05.735Z",
    "build_snapshot" : false,
    "lucene_version" : "6.6.0"
  },
  "tagline" : "You Know, for Search"
}

Журнал работы системы располагается в папке C:\ProgramData\Elastic\Elasticsearch\logs.

Включение функции полнотекстового поиска в Docsvision рассмотрено в пункте Настройка полнотекстового поиска.

Настройте Elasticsearch согласно инструкции в разделе Подключить полнотекстовый поиск Elasticsearch.