...

• Elasticsearch версии 8.9.1 (другие версии не совместимы и не поддерживают требуемый плагин).

• Настроенный экземпляр Elasticsearch (устанавливается клиентом любым удобным способом: напрямую на Linux, через Docker, и т.д.).

• Доступ к Elasticsearch по HTTP(S).

• API-ключ (если используется безопасный доступ).
  
  

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

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

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

Шаги:

1. Остановите контейнер Elasticsearch:
   

   Code Block
   language bash theme Confluence title bash
   docker stop <имя_или_id_контейнера>

2. Скопируйте архив с плагином (elasticsearch-analysis-morphology-8.9.1.zip) в контейнер

   Code Block
   language bash theme Confluence title bash
   docker cp elasticsearch-analysis-morphology-8.9.1.zip <имя_или_id_контейнера>:/tmp

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

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

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

   Code Block
   language bash theme Confluence title bash
   docker start <имя_или_id_контейнера>

5. Проверьте установку:

   Code Block
   language bash theme Confluence title bash
   curl http://localhost:9200/_cat/plugins

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

Шаги:

1. Скачайте архив с плагином (elasticsearch-analysis-morphology-8.9.1.zip) на сервер.

2. Перейдите в директорию Elasticsearch
   
   
3. Установите плагин:

   Code Block
   language bash theme Confluence title bash
   bin/elasticsearch-plugin install file:///tmp/elasticsearch-analysis-morphology-8.9.1.zip

   (замените /tmp/elasticsearch-analysis-morphology-8.9.1.zip на актуальный путь к архиву)
   
   
4. Перезапустите службу Elasticsearch:
   

   Code Block
   language bash theme Confluence title bash
   systemctl restart elasticsearch.service

5. Проверьте установку:

   Code Block
   language bash theme Confluence title bash
   curl http://localhost:9200/_cat/plugins

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

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

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

...

./bin/knowledgebase.sh migrate

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

./bin/knowledgebase migration
./bin/knowledgebase.sh start

...