Обговорення:Встановлення Koha з репозитарію на ОС Debian - Історія редагувань

Dubyk: /* 5. Перемикання на Elasticsearch та побудова індексів */

2026-07-17T16:09:54Z

5. Перемикання на Elasticsearch та побудова індексів

← Попередня версія		Версія за 19:09, 17 липня 2026
Рядок 423:		Рядок 423:

	Служба Zebra (zebrasrv, індексувальний демон) на екземплярі, як і раніше, продовжує працювати у фоні навіть при увімкненому Elasticsearch — частина внутрішніх операцій Koha історично досі покладається на Zebra, тож вимикати її повністю не варто без окремого дослідження вашої версії Koha.		Служба Zebra (zebrasrv, індексувальний демон) на екземплярі, як і раніше, продовжує працювати у фоні навіть при увімкненому Elasticsearch — частина внутрішніх операцій Koha історично досі покладається на Zebra, тож вимикати її повністю не варто без окремого дослідження вашої версії Koha.


			==== 6. Практичне налаштування: лематизація analysis-ukrainian для вибраних полів ====
			Це розширення пункту 2: конкретний, перевірений у джерельному коді Koha 26.05.01 спосіб реально задіяти аналізатор ukrainian, без правок Perl-коду.

			'''Механізм перевизначення.''' У шаблоні koha-conf-site.xml.in закладено (закоментовано) три незалежні override-файли, кожен зчитується напряму в Koha/SearchEngine/Elasticsearch.pm через C4::Context->config(...):
			<!-- <elasticsearch_index_config>__KOHA_CONF_DIR__/searchengine/elasticsearch/index_config.yaml</elasticsearch_index_config> -->
			<!-- <elasticsearch_field_config>__KOHA_CONF_DIR__/searchengine/elasticsearch/field_config.yaml</elasticsearch_field_config> -->
			<!-- <elasticsearch_index_mappings>__KOHA_CONF_DIR__/searchengine/elasticsearch/mappings.yaml</elasticsearch_index_mappings> -->
			Для нашої задачі index_config.yaml чіпати не потрібно (аналізатори типу ukrainian реєструються самим ES-плагіном, а не в цьому файлі) — працюємо лише з field_config.yaml (типи полів) і mappings.yaml (яке поле яким типом індексується).

			'''Крок 1 — копіюємо типові файли собі''' (оригінали в /usr/share/koha перезаписуються при кожному оновленні пакунка koha-common, редагувати їх напряму не можна):
			sudo mkdir -p /etc/koha/sites/ukr_unimarc/searchengine/elasticsearch
			sudo cp /usr/share/koha/intranet/cgi-bin/admin/searchengine/elasticsearch/field_config.yaml \
			/usr/share/koha/intranet/cgi-bin/admin/searchengine/elasticsearch/mappings.yaml \
			/etc/koha/sites/ukr_unimarc/searchengine/elasticsearch/

			'''Крок 2 — у копії field_config.yaml додаємо новий тип поруч з "default"''', зберігаючи ті самі під-поля phrase/raw/ci_raw (вони й далі потрібні для точного пошуку, сортування й фільтрів — міняємо лише основний аналізатор):
			default_uk:
			type: text
			analyzer: ukrainian
			search_analyzer: ukrainian
			fields:
			phrase:
			type: text
			analyzer: analyzer_phrase
			search_analyzer: analyzer_phrase
			raw:
			type: keyword
			normalizer: nfkc_cf_normalizer
			ci_raw:
			type: keyword
			normalizer: icu_folding_normalizer

			'''Крок 3 — у копії mappings.yaml точково міняємо тип потрібних полів''' з default на default_uk. Файл величезний (у 26.05.01 — понад 4000 рядків), редагуємо конкретні блоки. Розумний мінімум для першого запуску — поля, де морфологічна варіативність пошукового запиту найбільше заважає читачам (заголовок, автор, предметні рубрики):
			title:
			label: title
			type: default_uk # було: default
			...
			Аналогічно знаходимо блоки author та su (предметні рубрики) і міняємо їм type. Інші поля (ідентифікатори, дати, stdno-подібні) не чіпаємо.

			'''Крок 4 — прописуємо шляхи в koha-conf.xml''' (розкоментовуємо, index_mappings не чіпаємо — лишаємо закоментованим, якщо не змінювали index_config.yaml):
			<elasticsearch_field_config>/etc/koha/sites/ukr_unimarc/searchengine/elasticsearch/field_config.yaml</elasticsearch_field_config>
			<elasticsearch_index_mappings>/etc/koha/sites/ukr_unimarc/searchengine/elasticsearch/mappings.yaml</elasticsearch_index_mappings>

			'''Крок 5 — застосовуємо й переіндексовуємо.''' Зміни мапінгу застосовуються лише через reset у веб-інтерфейсі (це прямо застережено коментарем у самому шаблоні koha-conf-site.xml.in: reset скидає й будь-які зміни, зроблені раніше через Search engine configuration UI):
			https://<staff-інтерфейс>/cgi-bin/koha/admin/searchengine/elasticsearch/mappings.pl?op=reset&i_know_what_i_am_doing=1&reset_fields=1
			Далі повний переіндекс:
			sudo koha-elasticsearch --rebuild -d -v ukr_unimarc

			''Не перевірено емпірично (у пісочниці немає робочого Elasticsearch): як саме аналізатор ukrainian обробляє не-українські токени (латиницею написані прізвища іноземних авторів, назви іншими мовами) — найімовірніше, пропускає без лематизації, але без реального тесту на змішаномовних записах стверджувати напевно не можу. Перевірте на тестовому екземплярі з реальними даними, перш ніж переносити на прод.''

			'''Чому не "і ICU, і лематизація одночасно" (multi-field з бустом у запиті).''' Архітектурно можна додати ukrainian ще одним під-полем (fields:) поруч із phrase/raw/ci_raw, зберігши analyzer_standard основним. Але для основного ключового пошуку Koha (Koha/SearchEngine/Elasticsearch/QueryBuilder.pm, sub build_query) будує query_string по базовому імені поля з його типовим analyzer/search_analyzer — довільні додаткові під-поля в цей запит автоматично не потрапляють. Суфікси .phrase/.raw/.ci_raw жорстко прописані в коді лише для конкретних сценаріїв (точні збіги, сортування, префіксний пошук). Щоб і новий .ukrainian-варіант реально брав участь у звичайному пошуку (з бустом поруч з основним полем), знадобиться правити сам QueryBuilder.pm — тобто повертаємось до проблеми, заради якої відмовлялись від Zebra: такий патч не переживає оновлення koha-common. Тому в цій інструкції — свідомий компроміс: конфігураційна заміна аналізатора на вибраних полях (Кроки 1–5), без патчів Perl-коду, ціною втрати ICU-фолдингу саме на цих полях.

	=== Zebra з підтримкою кирилиці (стара альтернатива) ===		=== Zebra з підтримкою кирилиці (стара альтернатива) ===

Dubyk: /* Альтернатива (legacy): Zebra з підтримкою кирилиці */

2026-07-16T16:03:19Z

Альтернатива (legacy): Zebra з підтримкою кирилиці

← Попередня версія		Версія за 19:03, 16 липня 2026
Рядок 424:		Рядок 424:
	Служба Zebra (zebrasrv, індексувальний демон) на екземплярі, як і раніше, продовжує працювати у фоні навіть при увімкненому Elasticsearch — частина внутрішніх операцій Koha історично досі покладається на Zebra, тож вимикати її повністю не варто без окремого дослідження вашої версії Koha.		Служба Zebra (zebrasrv, індексувальний демон) на екземплярі, як і раніше, продовжує працювати у фоні навіть при увімкненому Elasticsearch — частина внутрішніх операцій Koha історично досі покладається на Zebra, тож вимикати її повністю не варто без окремого дослідження вашої версії Koha.

	=== ~~Альтернатива (legacy):~~ Zebra з підтримкою кирилиці ===		=== Zebra з підтримкою кирилиці (стара альтернатива) ===
	Якщо з якихось причин потрібно залишитися на Zebra як основному рушії пошуку (наприклад, обмежені ресурси сервера — Elasticsearch помітно вимогливіший до RAM), нижче — перевірений роками спосіб підтримки кирилиці для Zebra. Без цього патчу пошук українською/кирилицею в Zebra або не працює, або дає некоректні результати.		Якщо з якихось причин потрібно залишитися на Zebra як основному рушії пошуку (наприклад, обмежені ресурси сервера — Elasticsearch помітно вимогливіший до RAM), нижче — перевірений роками спосіб підтримки кирилиці для Zebra. Без цього патчу пошук українською/кирилицею в Zebra або не працює, або дає некоректні результати.

Dubyk: /* Пошуковий рушій: Elasticsearch (рекомендовано) */

2026-07-16T16:02:26Z

Пошуковий рушій: Elasticsearch (рекомендовано)

Показати зміни

Dubyk: /* Вимкнення оновлення Koha */

2026-07-14T13:07:11Z

Вимкнення оновлення Koha

← Попередня версія		Версія за 16:07, 14 липня 2026
Рядок 567:		Рядок 567:

	== Вимкнення оновлення Koha ==		== Вимкнення оновлення Koha ==
	Для більш контрольованого оновлення пакунків Коха можна ~~тимчасово закоментувати~~ рядок ~~Suites (або весь~~ ~~блок)~~ у /etc/apt/sources.list.d/koha.sources, напр.:		Для більш контрольованого оновлення пакунків Коха можна додати рядок Enabled: no у /etc/apt/sources.list.d/koha.sources, напр.:
	Types: deb		Types: deb
	URIs: https://debian.koha-community.org/koha/		URIs: https://debian.koha-community.org/koha/
	# Suites: 26.05		Suites: 26.05
	Components: main		Components: main
	Signed-By: /etc/apt/keyrings/koha.asc		Signed-By: /etc/apt/keyrings/koha.asc
			Enabled: no
	Це дозволить легко оновлювати інші пакунки Debian, не зачіпаючи koha-common.		Це дозволить легко оновлювати інші пакунки Debian, не зачіпаючи koha-common.

Dubyk: /* Підключення репозитарію Koha */

2026-07-14T12:29:57Z

Підключення репозитарію Koha

← Попередня версія		Версія за 15:29, 14 липня 2026
Рядок 92:		Рядок 92:
	Components: main		Components: main
	Signed-By: /etc/apt/keyrings/koha.asc		Signed-By: /etc/apt/keyrings/koha.asc
			Enabled: yes
	EOF		EOF
	Щоб оновити список джерел пакетів для використання LTS-релізу 24.11:		Щоб оновити список джерел пакетів для використання LTS-релізу 24.11:
Рядок 100:		Рядок 101:
	Components: main		Components: main
	Signed-By: /etc/apt/keyrings/koha.asc		Signed-By: /etc/apt/keyrings/koha.asc
			Enabled: yes
	EOF		EOF
	Замість номера версії можна вказати символьну назву (stable, oldstable, oldoldstable) — Suites стане, напр., stable. Для продакшн-середовища це '''не рекомендовано''': при переході репозитарію на новий stable ви автоматично й без попереднього тестування отримаєте великий реліз з новими можливостями.		Замість номера версії можна вказати символьну назву (stable, oldstable, oldoldstable) — Suites стане, напр., stable. Для продакшн-середовища це '''не рекомендовано''': при переході репозитарію на новий stable ви автоматично й без попереднього тестування отримаєте великий реліз з новими можливостями.

Dubyk: /* 8. Початкова індексація */

2026-07-14T12:17:35Z

8. Початкова індексація

← Попередня версія		Версія за 15:17, 14 липня 2026
Рядок 421:		Рядок 421:
	==== 8. Початкова індексація ====		==== 8. Початкова індексація ====
	sudo koha-elasticsearch --rebuild -d ukr_unimarc		sudo koha-elasticsearch --rebuild -d ukr_unimarc


	Перевірка: пошук у каталозі за "*" (зірочка) має повертати результати (у Zebra зірочка так не працює — це ознака, що Elasticsearch справді використовується).		Перевірка: пошук у каталозі за "*" (зірочка) має повертати результати (у Zebra зірочка так не працює — це ознака, що Elasticsearch справді використовується).

Dubyk: /* 6. Перезапуск служб */

2026-07-14T12:17:26Z

6. Перезапуск служб

← Попередня версія		Версія за 15:17, 14 липня 2026
Рядок 412:		Рядок 412:
	sudo systemctl restart elasticsearch.service		sudo systemctl restart elasticsearch.service
	sudo systemctl restart koha-common.service		sudo systemctl restart koha-common.service


	Перевірка (з автентифікацією):		Перевірка (з автентифікацією):
	curl -k -u 'elastic:ВАШ_ПАРОЛЬ' https://localhost:9200		curl -k -u 'elastic:ВАШ_ПАРОЛЬ' https://localhost:9200

Dubyk: /* Створення екземпляра */

2026-07-14T12:16:50Z

Створення екземпляра

← Попередня версія		Версія за 15:16, 14 липня 2026
Рядок 225:		Рядок 225:

	sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc		sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc


	Вивід:		Вивід:
	Koha instance is empty, no staff user created.		Koha instance is empty, no staff user created.
	Starting Koha worker daemon for ukr_unimarc (default):.		Starting Koha worker daemon for ukr_unimarc (default):.
	Starting Koha indexing daemon for ukr_unimarc:.		Starting Koha indexing daemon for ukr_unimarc:.


	OPAC буде доступний на http://<IP-сервера>/, адмін-інтерфейс — на http://<IP-сервера>:8080/.		OPAC буде доступний на http://<IP-сервера>/, адмін-інтерфейс — на http://<IP-сервера>:8080/.

Dubyk: /* ports.conf */

2026-07-14T12:16:38Z

ports.conf

← Попередня версія		Версія за 15:16, 14 липня 2026
Рядок 219:		Рядок 219:
	sudo a2dissite 000-default		sudo a2dissite 000-default
	sudo systemctl restart apache2		sudo systemctl restart apache2


	''Якщо з якоїсь причини типова сторінка Apache на порту 80 усе ж потрібна — тоді трюк із портом 8008 лишається робочим альтернативним варіантом (перенесення VirtualHost 000-default на порт 8008).''		''Якщо з якоїсь причини типова сторінка Apache на порту 80 усе ж потрібна — тоді трюк із портом 8008 лишається робочим альтернативним варіантом (перенесення VirtualHost 000-default на порт 8008).''

Dubyk: /* ports.conf */

2026-07-14T12:16:28Z

ports.conf

← Попередня версія		Версія за 15:16, 14 липня 2026
Рядок 215:		Рядок 215:
	Порт 80 Apache вже слухає за замовчуванням, тож у /etc/apache2/ports.conf достатньо додати лише порт адмін-інтерфейсу:		Порт 80 Apache вже слухає за замовчуванням, тож у /etc/apache2/ports.conf достатньо додати лише порт адмін-інтерфейсу:
	Listen 8080		Listen 8080


	Типовий сайт-заглушка Apache (000-default) також слухає порт 80, і за відсутності збігу за ServerName саме він відповідатиме на прямі звернення за IP. Для чистого IP-доступу його варто вимкнути:		Типовий сайт-заглушка Apache (000-default) також слухає порт 80, і за відсутності збігу за ServerName саме він відповідатиме на прямі звернення за IP. Для чистого IP-доступу його варто вимкнути:
	sudo a2dissite 000-default		sudo a2dissite 000-default
Рядок 221:		Рядок 221:

	''Якщо з якоїсь причини типова сторінка Apache на порту 80 усе ж потрібна — тоді трюк із портом 8008 лишається робочим альтернативним варіантом (перенесення VirtualHost 000-default на порт 8008).''		''Якщо з якоїсь причини типова сторінка Apache на порту 80 усе ж потрібна — тоді трюк із портом 8008 лишається робочим альтернативним варіантом (перенесення VirtualHost 000-default на порт 8008).''


	===== Створення екземпляра =====		===== Створення екземпляра =====