Требования

Elasticsearch версии 8.9.1 (другие версии не совместимы и не поддерживают требуемый плагин).
Настроенный экземпляр Elasticsearch (устанавливается клиентом любым удобным способом: напрямую на Linux, через Docker, и т.д.).
Доступ к Elasticsearch по HTTP(S).
API-ключ (если используется безопасный доступ).

1. Подготовка. Настройка конфигурации Elasticsearch 8.9.1 (минимальный конфиг для тестового сервера с отключенными настройками безопасности).

После установки нам необходимо перейти в файл конфигурации elasticsearch.yml и указать минимальные нобходимые параметры для работы без API ключа (который далее можно не указывать в конфигурации knowledgebase). ДАННЫЕ ПАРАМЕТРЫ НЕОБХОДИМЫ ДЛЯ ТЕСТИРОВАНИЯ В localhost на сервере LINUX

.../elasticsearch.yml:

cluster.name: test-cluster
node.name: node-1
network.host: 0.0.0.0
http.port: 9200

discovery.type: single-node

# Отключаем настройки безопасности
xpack.security.enabled: false
xpack.security.transport.ssl.enabled: false
xpack.security.http.ssl.enabled: false

После сохранения конфига перезапускаем сервис elasticsearch.service и проверяем статус - должен быть Active: active (running)

2. Подготовка. Установка плагина для Elasticsearch

Плагин analysis-morphology предназначен для обработки текста на русском языке в Elasticsearch.

Установка в Docker-контейнере

Шаги:

Остановите контейнер Elasticsearch:
docker stop <имя_или_id_контейнера>
Скопируйте архив с плагином (elasticsearch-analysis-morphology-8.9.1.zip) в контейнер
docker cp elasticsearch-analysis-morphology-8.9.1.zip <имя_или_id_контейнера>:/tmp

Выполните команду установки внутри контейнера:

docker exec -it <имя_или_id_контейнера> bash -c "bin/elasticsearch-plugin install file:/tmp/elasticsearch-analysis-morphology-8.9.1.zip"

Перезапустите контейнер :

docker start <имя_или_id_контейнера>

Проверьте установку:
curl http://localhost:9200/_cat/plugins

Установка на Linux (без Docker)

Шаги:

Скачайте архив с плагином (elasticsearch-analysis-morphology-8.9.1.zip) на сервер.
Перейдите в директорию Elasticsearch
Установите плагин:
bin/elasticsearch-plugin install file:///tmp/elasticsearch-analysis-morphology-8.9.1.zip
(замените /tmp/elasticsearch-analysis-morphology-8.9.1.zip на актуальный путь к архиву)
Перезапустите службу Elasticsearch:
systemctl restart elasticsearch.service
Проверьте установку:
curl http://localhost:9200/_cat/plugins

3. Настройка подключения в IQWiki

1. Укажите параметры подключения к Elasticsearch в конфигурационном файле IQWiki:

#ElasticSearch
elastic_search:
  adresses:    
	- http://<адрес или домен>:<порт>
  api_key: "<ваш API-ключ>"  # опционально, если используется авторизация

2. Запустите скрипты миграции базы данных (вторая БД для Базы Знаний):

./bin/knowledgebase migrate

Ошибка может быть следующего вида:

025/05/15 17:00:08     WARN    postgres:pgx    Using pgx driver
2025/05/15 17:00:08     ERROR   elasticsearch client    Error creating ElasticSearch client: ElasticSearch config is empty      {id=b17fe5aa-0261-4b60-b448-155cff1f0a43}
2025/05/15 17:00:08     WARN    migrations      Migrating...
2025/05/15 17:00:08     WARN    migrations      Reading migrations from "migrations/postgres"
2025/05/15 17:00:08     WARN    migrations      Applied 0 migration(s) in 6ms

2025/05/15 17:00:08     WARN    service migrations      Migrating services...   {id=4e40c0c7-fa57-4225-8877-314dc368d5a8}
2025/05/15 17:00:08     WARN    iq-knowledge-base       Starting...     {id=df6b4dea-95d0-49e6-bb9a-ce4920b554fb}
2025/05/15 17:00:08     WARN    iq-knowledge-base       Started {id=df6b4dea-95d0-49e6-bb9a-ce4920b554fb}
2025/05/15 17:03:57     ERROR   elasticsearch client    Error searching documents: dial tcp 127.0.0.1:9200: connect: connection refused {id=fd5fe8ff-7e53-4942-9882-814bc3da6d82, ip=127.0.0.1, ua=Go-http>
2025/05/15 17:03:57     ERROR   httpd2  Internal server error, err=dial tcp 127.0.0.1:9200: connect: connection refused {id=0fe0d6f0-4bf5-4940-9b1a-e626faa40009, ip=127.0.0.1, ua=Go-http-client/1.1}
2025/05/15 17:05:02     ERROR   elasticsearch client    Error searching documents: dial tcp 127.0.0.1:9200: connect: connection refused {id=efc2c505-4dce-4a56-ab60-86e9394dc009, ip=127.0.0.1, ua=Go-http>
2025/05/15 17:05:02     ERROR   httpd2  Internal server error, err=dial tcp 127.0.0.1:9200: connect: connection refused {id=285249ae-f1e0-40a2-9ac3-0a9846f62516, ip=127.0.0.1, ua=Go-http-client/1.1}
2025/05/15 17:05:26     WARN    iq-knowledge-base       Stopping...     {id=df6b4dea-95d0-49e6-bb9a-ce4920b554fb}
2025/05/15 17:05:26     WARN    iq-knowledge-base       Stopped {id=df6b4dea-95d0-49e6-bb9a-ce4920b554fb}
2025/05/15 17:05:29     WARN    postgres:pgx    Using pgx driver
2025/05/15 17:05:29     ERROR   elasticsearch client    Error creating ElasticSearch client: ElasticSearch config is empty      {id=4046a743-a3a7-4263-b488-241717c6bc1f}
2025/05/15 17:05:29     ERROR   elasticsearch client    Error checking indice existence the index: dial tcp 127.0.0.1:9200: connect: connection refused {id=f9358cee-6fb2-45e1-9e46-235739044e12}
panic: reflect: Call using zero Value argument

Тогда нам необходимо проверить:
1) Корректность подключения к elasticsearch в конфигурации дистрибутива Базы Знаний (в конфиге БЗ ./config/config.yaml), если ОК идем далее.
2) Корректность конфигурации elasticsearch (elasticsearch.yml). Возможно имеется не убитый процесс elastic, нужно проверить через команду:

ps aux | grep elasticsearch

И если процессов нет, проверить, что конфигурация из пункта 1.1 корректно записалась, после перезапустить сервис elastic.search

3. Запустите IQWiki:

./bin/knowledgebase.sh start

4. Проверка доступности Elasticsearch

Для проверки доступности сервера используйте команду:

curl -X GET "http://<адрес или домен>:<порт>"

Если включена авторизация, добавьте API-ключ:

curl -X GET "http://<адрес или домен>:<порт>" -H "Authorization: ApiKey <ваш API-ключ>"