Koha Ukraine Wiki - Внесок користувача [uk]

Штрих-кодування

2026-03-23T11:47:51Z

Dubyk: /* Варіанти отримання штрихкодів */

'''[https://uk.wikipedia.org/wiki/%D0%A8%D1%82%D1%80%D0%B8%D1%85-%D0%BA%D0%BE%D0%B4 Штрих-код]''' ''(Вікіпедія)'' — один із способів ідентифікації. В контексті АБІС Koha сприймається як унікальний код, який визначає екземпляр книги, користувача.

[[File:barcodes_scan.jpeg|thumbnail|right|]]

== Способи кодування ==
'''Лінійні коди (штрих-код)'''
:Штрих-код — найпростіший спосіб кодування інформації, при якому дані записуються в ширину.

'''Двовимірні коди (QR-код)'''
:[https://uk.wikipedia.org/wiki/QR-%D0%BA%D0%BE%D0%B4 QR-код] ''(Вікіпедія)'' — код, при якому дані записуються в ширину і висоту.

'''Радіомітки (RFID)'''
:Дані записуються на [https://uk.wikipedia.org/wiki/%D0%A0%D0%B0%D0%B4%D1%96%D0%BE%D1%87%D0%B0%D1%81%D1%82%D0%BE%D1%82%D0%BD%D0%B0_%D1%96%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D1%96%D0%BA%D0%B0%D1%86%D1%96%D1%8F RFID-радіомітку] ''(Вікіпедія)''.
Докладнішу інформацію можна знайти у [[Koha та RFID]].

== Вибір структури коду ==
Оскільки штрихкод як ідентифікатор не повинен повторюватися, слід подумати як цього домогтися. Краще, щоб випадкове зчитування будь-якого іншого штрихкоду не співпало з одним з кодів в наявної колекції (в тому числі з кодом читача). Домогтися цього можна додавши на початку коду унікальні символи.

Бібліотека повинна мати свій код [https://ru.wikipedia.org/wiki/International_Standard_Identifier_for_Libraries_and_Related_Organizations '''ISIL'''] ''(Вікіпедія)'' або [http://www.loc.gov/marc/organizations/ '''MARC Code for Organizations''']<ref>Списком кодів MARC Code for Organizations керує Бібліотека конгресу</ref>, який необхідно вказувати в полі [https://unimarc.org.ua/wiki/801#b 801$b]. Останній простіше отримати (час очікування 1 місяць), і крім MARC Org Code, бібліотека отримує і цифровий ID. Його-то і можна використовувати в штрих-коді, тому як краще, щоб в коді не було літер<ref>Сканер штрих-кодів при підключенні до комп’ютера визначається як клавіатура. Вміст штрихкоду з буквами буде різним у залежності від поточної розкладки клавіатури. Щоб цього уникнути, букви не варто використовувати.</ref>.

Підсумковий штрихкод може мати вигляд 41683-00000001, де 41683 — ID в [http://www.loc.gov/marc/organizations/ бібліотеці Конгресу], дефіс - роздільник, 00000001 - унікальний номер примірника (кількість розрядів можна змінити).

== Вибір типу штрихкоду ==
[[Файл:Code 3 of 9.png|thumbnail|right|Слово «WIKIPEDIA» закодоване у Code 39]] Штрихкод типу [https://uk.wikipedia.org/wiki/Code_39 '''Code 39'''] ''(Вікіпедія)'' широко використовується в бібліотеках, є двонапрямлений, може містити символи ASCII, бути з контрольною сумою чи без, є доволі широким (що дає додаткову стійкість до пошкодження чи недоліків видруку). Усі популярні зчитувачі підтримують Code 39.

Також використовуються і інші тип штрихкодів: [https://ru.wikipedia.org/wiki/Code_128 Code 128C], [https://en.wikipedia.org/wiki/Interleaved_2_of_5 Code 2 of 5 interleaved], …

== Вибір зчитувача ==
[[Файл:LS2208.png|thumbnail|right|]] '''[https://uk.wikipedia.org/wiki/%D0%A1%D0%BA%D0%B0%D0%BD%D0%B5%D1%80_%D1%88%D1%82%D1%80%D0%B8%D1%85-%D0%BA%D0%BE%D0%B4%D1%83 Сканер штрих-коду]''' ''(Вікіпедія)'' — пристрій чи ПЗ, які зчитують штрих-коди, що нанесені на примірник книги чи читацький квиток, і передає цю інформацію на робочий комп'ютер чи мобільний пристрій. Деякі моделі зчитувачів можуть накопичувати і зберігати переліки штрихкодів для подальшої обробки (напр., при інвентаризації).

Популярні моделі сканерів для зчитування штрих-кодів:
* Zebra Motorola/Symbol LS2208 (LS2208-SR20007R-UR) / [https://rozetka.com.ua/ua/zebra_ls2208_sr20007r_ur/p6743350// Розетка]
: ''Характеристики: робота в ручному (з кнопкою для пересилання штрихкоду в комп’ютер) та стаціонарному (через стенд в комплекті) режимах, лазерна система зчитування, підключення до комп’ютера через USB, зчитування усіх популярних лінійних штрихкодів, 100 скан./сек., дальність сканування 280 мм, глибина поля сканування 0 мм - 430 мм, світлодіодна/звукова індикація читання, роздільна здатність 4.9 міл., кут сканування 30°, стійкий до зовнішніх впливів, повинен витримувати падіння з висоти 1.5 м.''

== Варіанти отримання штрихкодів ==

За способом генерування штрих-коду:
* генеруються у АБІС Koha (див. [https://koha-community.org/manual/25.11/uk/html/catalogingpreferences.html autobarcode]) і видруковуються з Koha ([https://koha-community.org/manual/25.11/uk/html/cataloging.html#creating-labels Label Creator]) або окремо, також по одному чи партією. У цьому випадку штрихкоди можуть бути ''„розумні“'', тобто містити окрім коду дані про книгу (напр. шифр, сиглу, назву і т.п.).
* незалежні від Koha, прив’язуються до примірника в системі після наклеювання. Зазвичай містять лише числові інкрементальні значення (можуть містити лого та назву бібліотеки) і друкуються самостійно або закупляються готові.

За способом видруку:
* готові закуплені штрихкоди
* видрук на спец-принтері
* видрук на наклейочному папері

=== Закупівля готових штрих-кодів ===
[[File:barcodes_bobine.png|thumbnail|right|]] Найпростіший варіант, не прив’язаний до АБІС та обладнання. Штрих-коди довговічні та можуть містити захисне покриття. З недоліків: ціна за 1 штрихкод.

Наклейка може проводитися без доступу до комп’ютера чи навіть до впровадження АБІС.

Де можна придбати:
* фірма „[http://miratex.com.ua Міратекс Груп]“, м. Київ, проспект Георгія Гонгадзе, 9, тел. моб. 063 722 14 60 (є у Viber), директор: Шнуров Віктор Михайлович
''… додавайте свої варіанти''

=== Видрук на спец-принтері===
[[File:Zebra_TLP_2824_Plus.jpg|thumbnail|right|]] Для друку шрих-кодів також використовуються спеціальні термотрансферні принтери для штрихових кодів (принтери для друку етикеток).

Штрих-коди видруковуються як по одному так і послідовністю.

Популярні варіанти:
* Принтер Zebra TLP2844; термотрансферна стрічка Zebra 5095 Resin 57mm x 74m; наклейки 43х25мм топ/semi (поліпропіленновий самоклеючий папір, покритий плівкою)
* Принтер Zebra TLP2824 Plus, …

=== Видрук на самоклеючому папері===
[[File:barcodel_labels_page.jpg|thumbnail|right|]] Етикетки на аркушах A4, що дозволяє видруковувати їх на лазерних та струйних друкарках. Краще вибирати наперед розмічені наклейки, напр. 24 на аркуші (3*8).

Для економії друку необхідно готувати партію штрихкодів для заповнення аркуша (напр. по 24). Штрихкоди чутливі до якості друку.

Видрук з АБІС Koha ([https://www.youtube.com/watch?v=Ay3MSLq0fjc відео]) або іншого спеціалізованого забезпечення, напр. LibreOffice Labels, …

Популярні варіанти:
* [https://rozetka.com.ua/ua/self_adhesive_labels/c2844942/61412=191927/ Розетка]
* LOMOND 2100215-70 (A4, 50 аркушів, 65 частин), етикетки 38х21.2мм
… інші варіанти

== Вибір місця наклеювання ==
Паперові чи полістерові етикетки не можна клеїти на обкладинку книги (вигорання на сонці та стирання).

Як правило, штрихкоди клеять на форзац книги.

== Технології наклеювання ==
Популярна практика обклеювання паралельно з ретроконверсією/інвентаризацією.

Вибирайте технологію, що дозволить до процесу наклеювання залучити менш кваліфікованих працівників.

== Примітки ==
<references/>

== Див. також ==
* [http://irbis.elnit.org/read.php?10,21661 Эффективная печать штрихкодов] /форум Ірбіс/

Штрих-кодування

2026-03-23T11:46:37Z

Dubyk: /* Варіанти отримання штрихкодів */

'''[https://uk.wikipedia.org/wiki/%D0%A8%D1%82%D1%80%D0%B8%D1%85-%D0%BA%D0%BE%D0%B4 Штрих-код]''' ''(Вікіпедія)'' — один із способів ідентифікації. В контексті АБІС Koha сприймається як унікальний код, який визначає екземпляр книги, користувача.

[[File:barcodes_scan.jpeg|thumbnail|right|]]

== Способи кодування ==
'''Лінійні коди (штрих-код)'''
:Штрих-код — найпростіший спосіб кодування інформації, при якому дані записуються в ширину.

'''Двовимірні коди (QR-код)'''
:[https://uk.wikipedia.org/wiki/QR-%D0%BA%D0%BE%D0%B4 QR-код] ''(Вікіпедія)'' — код, при якому дані записуються в ширину і висоту.

'''Радіомітки (RFID)'''
:Дані записуються на [https://uk.wikipedia.org/wiki/%D0%A0%D0%B0%D0%B4%D1%96%D0%BE%D1%87%D0%B0%D1%81%D1%82%D0%BE%D1%82%D0%BD%D0%B0_%D1%96%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D1%96%D0%BA%D0%B0%D1%86%D1%96%D1%8F RFID-радіомітку] ''(Вікіпедія)''.
Докладнішу інформацію можна знайти у [[Koha та RFID]].

== Вибір структури коду ==
Оскільки штрихкод як ідентифікатор не повинен повторюватися, слід подумати як цього домогтися. Краще, щоб випадкове зчитування будь-якого іншого штрихкоду не співпало з одним з кодів в наявної колекції (в тому числі з кодом читача). Домогтися цього можна додавши на початку коду унікальні символи.

Бібліотека повинна мати свій код [https://ru.wikipedia.org/wiki/International_Standard_Identifier_for_Libraries_and_Related_Organizations '''ISIL'''] ''(Вікіпедія)'' або [http://www.loc.gov/marc/organizations/ '''MARC Code for Organizations''']<ref>Списком кодів MARC Code for Organizations керує Бібліотека конгресу</ref>, який необхідно вказувати в полі [https://unimarc.org.ua/wiki/801#b 801$b]. Останній простіше отримати (час очікування 1 місяць), і крім MARC Org Code, бібліотека отримує і цифровий ID. Його-то і можна використовувати в штрих-коді, тому як краще, щоб в коді не було літер<ref>Сканер штрих-кодів при підключенні до комп’ютера визначається як клавіатура. Вміст штрихкоду з буквами буде різним у залежності від поточної розкладки клавіатури. Щоб цього уникнути, букви не варто використовувати.</ref>.

Підсумковий штрихкод може мати вигляд 41683-00000001, де 41683 — ID в [http://www.loc.gov/marc/organizations/ бібліотеці Конгресу], дефіс - роздільник, 00000001 - унікальний номер примірника (кількість розрядів можна змінити).

== Вибір типу штрихкоду ==
[[Файл:Code 3 of 9.png|thumbnail|right|Слово «WIKIPEDIA» закодоване у Code 39]] Штрихкод типу [https://uk.wikipedia.org/wiki/Code_39 '''Code 39'''] ''(Вікіпедія)'' широко використовується в бібліотеках, є двонапрямлений, може містити символи ASCII, бути з контрольною сумою чи без, є доволі широким (що дає додаткову стійкість до пошкодження чи недоліків видруку). Усі популярні зчитувачі підтримують Code 39.

Також використовуються і інші тип штрихкодів: [https://ru.wikipedia.org/wiki/Code_128 Code 128C], [https://en.wikipedia.org/wiki/Interleaved_2_of_5 Code 2 of 5 interleaved], …

== Вибір зчитувача ==
[[Файл:LS2208.png|thumbnail|right|]] '''[https://uk.wikipedia.org/wiki/%D0%A1%D0%BA%D0%B0%D0%BD%D0%B5%D1%80_%D1%88%D1%82%D1%80%D0%B8%D1%85-%D0%BA%D0%BE%D0%B4%D1%83 Сканер штрих-коду]''' ''(Вікіпедія)'' — пристрій чи ПЗ, які зчитують штрих-коди, що нанесені на примірник книги чи читацький квиток, і передає цю інформацію на робочий комп'ютер чи мобільний пристрій. Деякі моделі зчитувачів можуть накопичувати і зберігати переліки штрихкодів для подальшої обробки (напр., при інвентаризації).

Популярні моделі сканерів для зчитування штрих-кодів:
* Zebra Motorola/Symbol LS2208 (LS2208-SR20007R-UR) / [https://rozetka.com.ua/ua/zebra_ls2208_sr20007r_ur/p6743350// Розетка]
: ''Характеристики: робота в ручному (з кнопкою для пересилання штрихкоду в комп’ютер) та стаціонарному (через стенд в комплекті) режимах, лазерна система зчитування, підключення до комп’ютера через USB, зчитування усіх популярних лінійних штрихкодів, 100 скан./сек., дальність сканування 280 мм, глибина поля сканування 0 мм - 430 мм, світлодіодна/звукова індикація читання, роздільна здатність 4.9 міл., кут сканування 30°, стійкий до зовнішніх впливів, повинен витримувати падіння з висоти 1.5 м.''

== Варіанти отримання штрихкодів ==

За способом генерування штрих-коду:
* генеруються у АБІС Koha (див. [https://koha-community.org/manual/25.11/uk/html/catalogingpreferences.html autobarcode]) і видруковуються з Koha ([https://koha-community.org/manual/18.11/en/html/tools.html?highlight=barcodes#label-creator Label Creator]) або окремо, також по одному чи партією. У цьому випадку штрихкоди можуть бути ''„розумні“'', тобто містити окрім коду дані про книгу (напр. шифр, сиглу, назву і т.п.).
* незалежні від Koha, прив’язуються до примірника в системі після наклеювання. Зазвичай містять лише числові інкрементальні значення (можуть містити лого та назву бібліотеки) і друкуються самостійно або закупляються готові.

За способом видруку:
* готові закуплені штрихкоди
* видрук на спец-принтері
* видрук на наклейочному папері

=== Закупівля готових штрих-кодів ===
[[File:barcodes_bobine.png|thumbnail|right|]] Найпростіший варіант, не прив’язаний до АБІС та обладнання. Штрих-коди довговічні та можуть містити захисне покриття. З недоліків: ціна за 1 штрихкод.

Наклейка може проводитися без доступу до комп’ютера чи навіть до впровадження АБІС.

Де можна придбати:
* фірма „[http://miratex.com.ua Міратекс Груп]“, м. Київ, проспект Георгія Гонгадзе, 9, тел. моб. 063 722 14 60 (є у Viber), директор: Шнуров Віктор Михайлович
''… додавайте свої варіанти''

=== Видрук на спец-принтері===
[[File:Zebra_TLP_2824_Plus.jpg|thumbnail|right|]] Для друку шрих-кодів також використовуються спеціальні термотрансферні принтери для штрихових кодів (принтери для друку етикеток).

Штрих-коди видруковуються як по одному так і послідовністю.

Популярні варіанти:
* Принтер Zebra TLP2844; термотрансферна стрічка Zebra 5095 Resin 57mm x 74m; наклейки 43х25мм топ/semi (поліпропіленновий самоклеючий папір, покритий плівкою)
* Принтер Zebra TLP2824 Plus, …

=== Видрук на самоклеючому папері===
[[File:barcodel_labels_page.jpg|thumbnail|right|]] Етикетки на аркушах A4, що дозволяє видруковувати їх на лазерних та струйних друкарках. Краще вибирати наперед розмічені наклейки, напр. 24 на аркуші (3*8).

Для економії друку необхідно готувати партію штрихкодів для заповнення аркуша (напр. по 24). Штрихкоди чутливі до якості друку.

Видрук з АБІС Koha ([https://www.youtube.com/watch?v=Ay3MSLq0fjc відео]) або іншого спеціалізованого забезпечення, напр. LibreOffice Labels, …

Популярні варіанти:
* [https://rozetka.com.ua/ua/self_adhesive_labels/c2844942/61412=191927/ Розетка]
* LOMOND 2100215-70 (A4, 50 аркушів, 65 частин), етикетки 38х21.2мм
… інші варіанти

== Вибір місця наклеювання ==
Паперові чи полістерові етикетки не можна клеїти на обкладинку книги (вигорання на сонці та стирання).

Як правило, штрихкоди клеять на форзац книги.

== Технології наклеювання ==
Популярна практика обклеювання паралельно з ретроконверсією/інвентаризацією.

Вибирайте технологію, що дозволить до процесу наклеювання залучити менш кваліфікованих працівників.

== Примітки ==
<references/>

== Див. також ==
* [http://irbis.elnit.org/read.php?10,21661 Эффективная печать штрихкодов] /форум Ірбіс/

Штрих-кодування

2026-03-23T11:44:36Z

Dubyk: /* Вибір зчитувача */

'''[https://uk.wikipedia.org/wiki/%D0%A8%D1%82%D1%80%D0%B8%D1%85-%D0%BA%D0%BE%D0%B4 Штрих-код]''' ''(Вікіпедія)'' — один із способів ідентифікації. В контексті АБІС Koha сприймається як унікальний код, який визначає екземпляр книги, користувача.

[[File:barcodes_scan.jpeg|thumbnail|right|]]

== Способи кодування ==
'''Лінійні коди (штрих-код)'''
:Штрих-код — найпростіший спосіб кодування інформації, при якому дані записуються в ширину.

'''Двовимірні коди (QR-код)'''
:[https://uk.wikipedia.org/wiki/QR-%D0%BA%D0%BE%D0%B4 QR-код] ''(Вікіпедія)'' — код, при якому дані записуються в ширину і висоту.

'''Радіомітки (RFID)'''
:Дані записуються на [https://uk.wikipedia.org/wiki/%D0%A0%D0%B0%D0%B4%D1%96%D0%BE%D1%87%D0%B0%D1%81%D1%82%D0%BE%D1%82%D0%BD%D0%B0_%D1%96%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D1%96%D0%BA%D0%B0%D1%86%D1%96%D1%8F RFID-радіомітку] ''(Вікіпедія)''.
Докладнішу інформацію можна знайти у [[Koha та RFID]].

== Вибір структури коду ==
Оскільки штрихкод як ідентифікатор не повинен повторюватися, слід подумати як цього домогтися. Краще, щоб випадкове зчитування будь-якого іншого штрихкоду не співпало з одним з кодів в наявної колекції (в тому числі з кодом читача). Домогтися цього можна додавши на початку коду унікальні символи.

Бібліотека повинна мати свій код [https://ru.wikipedia.org/wiki/International_Standard_Identifier_for_Libraries_and_Related_Organizations '''ISIL'''] ''(Вікіпедія)'' або [http://www.loc.gov/marc/organizations/ '''MARC Code for Organizations''']<ref>Списком кодів MARC Code for Organizations керує Бібліотека конгресу</ref>, який необхідно вказувати в полі [https://unimarc.org.ua/wiki/801#b 801$b]. Останній простіше отримати (час очікування 1 місяць), і крім MARC Org Code, бібліотека отримує і цифровий ID. Його-то і можна використовувати в штрих-коді, тому як краще, щоб в коді не було літер<ref>Сканер штрих-кодів при підключенні до комп’ютера визначається як клавіатура. Вміст штрихкоду з буквами буде різним у залежності від поточної розкладки клавіатури. Щоб цього уникнути, букви не варто використовувати.</ref>.

Підсумковий штрихкод може мати вигляд 41683-00000001, де 41683 — ID в [http://www.loc.gov/marc/organizations/ бібліотеці Конгресу], дефіс - роздільник, 00000001 - унікальний номер примірника (кількість розрядів можна змінити).

== Вибір типу штрихкоду ==
[[Файл:Code 3 of 9.png|thumbnail|right|Слово «WIKIPEDIA» закодоване у Code 39]] Штрихкод типу [https://uk.wikipedia.org/wiki/Code_39 '''Code 39'''] ''(Вікіпедія)'' широко використовується в бібліотеках, є двонапрямлений, може містити символи ASCII, бути з контрольною сумою чи без, є доволі широким (що дає додаткову стійкість до пошкодження чи недоліків видруку). Усі популярні зчитувачі підтримують Code 39.

Також використовуються і інші тип штрихкодів: [https://ru.wikipedia.org/wiki/Code_128 Code 128C], [https://en.wikipedia.org/wiki/Interleaved_2_of_5 Code 2 of 5 interleaved], …

== Вибір зчитувача ==
[[Файл:LS2208.png|thumbnail|right|]] '''[https://uk.wikipedia.org/wiki/%D0%A1%D0%BA%D0%B0%D0%BD%D0%B5%D1%80_%D1%88%D1%82%D1%80%D0%B8%D1%85-%D0%BA%D0%BE%D0%B4%D1%83 Сканер штрих-коду]''' ''(Вікіпедія)'' — пристрій чи ПЗ, які зчитують штрих-коди, що нанесені на примірник книги чи читацький квиток, і передає цю інформацію на робочий комп'ютер чи мобільний пристрій. Деякі моделі зчитувачів можуть накопичувати і зберігати переліки штрихкодів для подальшої обробки (напр., при інвентаризації).

Популярні моделі сканерів для зчитування штрих-кодів:
* Zebra Motorola/Symbol LS2208 (LS2208-SR20007R-UR) / [https://rozetka.com.ua/ua/zebra_ls2208_sr20007r_ur/p6743350// Розетка]
: ''Характеристики: робота в ручному (з кнопкою для пересилання штрихкоду в комп’ютер) та стаціонарному (через стенд в комплекті) режимах, лазерна система зчитування, підключення до комп’ютера через USB, зчитування усіх популярних лінійних штрихкодів, 100 скан./сек., дальність сканування 280 мм, глибина поля сканування 0 мм - 430 мм, світлодіодна/звукова індикація читання, роздільна здатність 4.9 міл., кут сканування 30°, стійкий до зовнішніх впливів, повинен витримувати падіння з висоти 1.5 м.''

== Варіанти отримання штрихкодів ==

За способом генерування штрих-коду:
* генеруються у АБІС Koha (див. [https://koha-community.org/manual/18.11/en/html/systempreferences.html?highlight=barcodes#autobarcode autobarcode]) і видруковуються з Koha ([https://koha-community.org/manual/18.11/en/html/tools.html?highlight=barcodes#label-creator Label Creator]) або окремо, також по одному чи партією. У цьому випадку штрихкоди можуть бути ''„розумні“'', тобто містити окрім коду дані про книгу (напр. шифр, сиглу, назву і т.п.).
* незалежні від Koha, прив’язуються до примірника в системі після наклеювання. Зазвичай містять лише числові інкрементальні значення (можуть містити лого та назву бібліотеки) і друкуються самостійно або закупляються готові.

За способом видруку:
* готові закуплені штрихкоди
* видрук на спец-принтері
* видрук на наклейочному папері

=== Закупівля готових штрих-кодів ===
[[File:barcodes_bobine.png|thumbnail|right|]] Найпростіший варіант, не прив’язаний до АБІС та обладнання. Штрих-коди довговічні та можуть містити захисне покриття. З недоліків: ціна за 1 штрихкод.

Наклейка може проводитися без доступу до комп’ютера чи навіть до впровадження АБІС.

Де можна придбати:
* фірма „[http://miratex.com.ua Міратекс Груп]“, м. Київ, проспект Георгія Гонгадзе, 9, тел. моб. 063 722 14 60 (є у Viber), директор: Шнуров Віктор Михайлович
''… додавайте свої варіанти''

=== Видрук на спец-принтері===
[[File:Zebra_TLP_2824_Plus.jpg|thumbnail|right|]] Для друку шрих-кодів також використовуються спеціальні термотрансферні принтери для штрихових кодів (принтери для друку етикеток).

Штрих-коди видруковуються як по одному так і послідовністю.

Популярні варіанти:
* Принтер Zebra TLP2844; термотрансферна стрічка Zebra 5095 Resin 57mm x 74m; наклейки 43х25мм топ/semi (поліпропіленновий самоклеючий папір, покритий плівкою)
* Принтер Zebra TLP2824 Plus, …

=== Видрук на самоклеючому папері===
[[File:barcodel_labels_page.jpg|thumbnail|right|]] Етикетки на аркушах A4, що дозволяє видруковувати їх на лазерних та струйних друкарках. Краще вибирати наперед розмічені наклейки, напр. 24 на аркуші (3*8).

Для економії друку необхідно готувати партію штрихкодів для заповнення аркуша (напр. по 24). Штрихкоди чутливі до якості друку.

Видрук з АБІС Koha ([https://www.youtube.com/watch?v=Ay3MSLq0fjc відео]) або іншого спеціалізованого забезпечення, напр. LibreOffice Labels, …

Популярні варіанти:
* [https://rozetka.com.ua/ua/self_adhesive_labels/c2844942/61412=191927/ Розетка]
* LOMOND 2100215-70 (A4, 50 аркушів, 65 частин), етикетки 38х21.2мм
… інші варіанти

== Вибір місця наклеювання ==
Паперові чи полістерові етикетки не можна клеїти на обкладинку книги (вигорання на сонці та стирання).

Як правило, штрихкоди клеять на форзац книги.

== Технології наклеювання ==
Популярна практика обклеювання паралельно з ретроконверсією/інвентаризацією.

Вибирайте технологію, що дозволить до процесу наклеювання залучити менш кваліфікованих працівників.

== Примітки ==
<references/>

== Див. також ==
* [http://irbis.elnit.org/read.php?10,21661 Эффективная печать штрихкодов] /форум Ірбіс/

Вибір сервера для АБІС Koha

2026-03-23T11:31:29Z

Dubyk: /* VPS в Україні */

АБІС Koha розрахована на встановлення на сервері з операційною системою Linux Debian. Колись були збірки під Windows, але зараз немає.

Найпоширеніший варіант — це сервер (фізичний чи віртуальний), до якого бібліотекарі і читачі мають доступ через інтернет. Операційна система користувача немає значення (Windows, Linux, Mac, Android) оскільки Koha працює як веб-сайт. Для книговидачі потрібен зчитувач штрикодів (пристрій чи програма).

Варіанти зі серверами:

==Віртуальний сервер==

Може бути платний (абонплата), зазвичай за кордоном дешевше. Часто вузи, міські адміністрації, фірми мають платформи з віртуальними серверами. Інколи з кимось з них можна домовитися про невеликий віртуальний сервер на безоплатній (чи мінімально платній) співпраці.

Плюси/мінуси у віртуального сервера:
* вже є реальна IP,
* врахована плата за електрику та інтернет,
* часто є вбудоване резервування,
* немає стартового внеску але є місячна абонплата.

Для АБІС Koha не підходить звичайний [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D1%85%D0%BE%D1%81%D1%82%D0%B8%D0%BD%D0%B3 віртуальний веб-хостинг], потрібен [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D0%B2%D0%B8%D0%B4%D1%96%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80 ''віртуальний приватний сервер'' (VPS) / ''віртуальний виділений сервер'' (VDS)] з можливістю встановлення [https://uk.wikipedia.org/wiki/Debian Linux Debian] актуальної версії (зараз '''Debian 9''', незабаром 10).

Краще вибирати варіанти з [https://uk.wikipedia.org/wiki/SSD SSD].

Добре щоб був захист від хакерських атак ([https://uk.wikipedia.org/wiki/DoS-%D0%B0%D1%82%D0%B0%D0%BA%D0%B0 DDOS], …).

Запитуйте про резервне копіювання (може входити у тариф чи бути за додаткову плату).

Підтримка може бути 24/7 чи лише у робочий час (дізнавайтеся про обсяг підтримки у тарифі та додатково).

Типи віртуалізації: [https://uk.wikipedia.org/wiki/Kernel-based_Virtual_Machine KVM] (апаратна вірт.), [https://uk.wikipedia.org/wiki/Xen XEN], [https://uk.wikipedia.org/wiki/VMware VMware], [https://uk.wikipedia.org/wiki/OpenVZ OpenVZ].

Добре, щоб була панель для управління VPS-сервером (хоча б для перезавантаження).

Запитуйте дані про рівень сервісу, % працездатності, [https://uk.wikipedia.org/wiki/%D0%A3%D0%B3%D0%BE%D0%B4%D0%B0_%D0%BF%D1%80%D0%BE_%D1%80%D1%96%D0%B2%D0%B5%D0%BD%D1%8C_%D0%BF%D0%BE%D1%81%D0%BB%D1%83%D0%B3 угоду про рівень послуг (SLA)].

Найнаймінімальніший варіант для Koha: 4 Gb RAM, 60 Gb SDD, 2 CPU.

=== VPS в Україні ===
Розрахунок у гривнях.
* [https://uahosting.com.ua/vps.php UAhosting], 100mbps; 20Tb/м.; SSD; KVM, DDOS-захист; панель; бекапи+30%; 9-18/1-5; сервери в Україні та Німеччині; офіси: Київ, Львів.
* [https://uh.ua/ua/ssdvps.html Український хостинг], необм.траф.; SSD; 100mbps; ап.вірт.; [https://uh.ua/ua/uh/kontakty.html офіси]
* [https://hyperhost.ua/uk/vps-vds HyperHost], SSD; 24/7; OpenVZ; офіси: Київ, Вінниця.
* [https://www.ukraine.com.ua/vps/ Хостинг „Украина“], ап.вірт.XEN; SSD; 100mbps; ssh,vnc; [https://www.ukraine.com.ua/contacts/ контакти]
* [https://hostpro.ua/linux-vps.html HostPro], 24/7; KVM; 1 IP; SSD; бекапи 7 днів; офіс: Київ
* [https://deltahost.ua/ua/vps.html#/ DeltaHost]
* [https://gigacloud.ua/ GigaCloud], VMWare
* [https://realhost.pro/uk/vps/linux RealHost]
* [https://cityhost.ua/uk/vds/ CityHost]
* [https://gmhost.com.ua/service/ssd-vps#undefined GMhost]

...інші: [https://www.tophosting.in.ua/category/virtualnyj-server-vps-xosting-ukraina 2], [https://ru.hostings.info/hostings/country/ukraine 3], [http://tops.org.ua/uk/nedorohi-ukrayinski-vps-vds.html 4]

Приклади хмарних серверів:
* VPS 8G, 4 ядра, 8 GB, 70 GB, 10 Gbit/s, 10 TB/міс. https://www.ukraine.com.ua/vps/
* VPS 10G, 4 ядра, 10 GB, 80 GB, 10 Gbit/s, 15 TB/міс., https://www.ukraine.com.ua/vps/

=== VPS за кордоном ===
Розрахунок у $.
* [https://www.digitalocean.com/products/linux-distribution/debian/ Digital Ocean]

== Фізичний сервер==
=== Виділений фізичний сервер===
Виділений сервер (dedicated server) — вид хостингу, який надає клієнту оренду окремого фізичного обладнання.

Орендар може вибирати конфігурацію сервера, встановлювати будь-яку ОС, ПО, налаштовувати систему під свої потреби.

У вартість оренди входить первинне налаштування сервера, а також моніторинг навантаження і цілодобова техпідтримка обладнання.
У випадки виходу з ладу - все технічне обслуговування компанія бере на себе.

Виділені сервери в Україні:
* [https://hostpro.ua/ua/servers.html HostPro]
* [https://besthosting.ua/ua/priceservers.php BestHosting] (ТОВ „ОН-ЛАЙН“)
* [https://www.ukrnames.com/ukr/dedicated/ UkrNames]
* [https://deltahost.ua/ua/dedicated.html DeltaHost]
* [https://uahosting.com.ua/dedicated.php UAHosting]
* [https://uh.ua/ua/dedicated-servers/ UH.ua]
* [https://hyperhost.ua/uk/servers/in-ukraine HyperHost]
* [https://www.ukraine.com.ua/dedicated/ Хостинг «Украина»]
* [https://cityhost.ua/uk/server/ CityHost]
* [https://gmhost.com.ua/service/dedicated-servers#UAH GMHost]

=== Власний фізичний сервер===
Зазвичай це значно потужніше рішення.

Плюси/мінуси фізичного сервера:
* більша потужність,
* великі стартові витрати: це сам сервер, блок безперебійного живлення, мережева шафка і мережеве обладнання для підключення до інтернет,
* немає абонплати (окрім витрат на електрику і інтернет),
* про підключення до інтернету, виділення реальної IP потрібно буде подбати самому,
* цей сервер також можна буде використовувати і для інших цілей: веб-сайт бібліотеки, електронний архів, файловий сервер і т.п.

Деякі варіанти фізичних серверів:
* Сервер ARTLINE Business T17v26, https://rozetka.com.ua/ua/artline-t17v26/p396394269/
* Сервер ARTLINE Business R17v26, https://rozetka.com.ua/ua/artline-r17v26/p396394086/

''Примітки: можна розглядати і б/в варіант фізичного сервера, вони зазвичай дуже надійні (розраховані на круглодобову роботу впродовж років).''

==== Колокейшин ====
Це послуга розміщення сервера у провайдера.

=== Локальний комп’ютер-сервер===
Інколи, в малій відокремленій бібліотеці, коли немає потреби надавати доступ через Інтернет, використовують комп’ютер з Linux Debian і як сервер і як робочий комп’ютер бібліотекаря з графічним середовищем ([https://uk.wikipedia.org/wiki/GNOME Gnome], [https://uk.wikipedia.org/wiki/KDE KDE], …).

Однак Linux-фахівець, який інколи обслуговує цей комп’ютер, все ж потрібен.

== Див. також ==
* [https://lists.katipo.co.nz/public/koha/2016-December/046749.html MySQL database server, dedicated vs virtual]

Вибір сервера для АБІС Koha

2026-03-23T11:31:07Z

Dubyk: /* VPS в Україні */

АБІС Koha розрахована на встановлення на сервері з операційною системою Linux Debian. Колись були збірки під Windows, але зараз немає.

Найпоширеніший варіант — це сервер (фізичний чи віртуальний), до якого бібліотекарі і читачі мають доступ через інтернет. Операційна система користувача немає значення (Windows, Linux, Mac, Android) оскільки Koha працює як веб-сайт. Для книговидачі потрібен зчитувач штрикодів (пристрій чи програма).

Варіанти зі серверами:

==Віртуальний сервер==

Може бути платний (абонплата), зазвичай за кордоном дешевше. Часто вузи, міські адміністрації, фірми мають платформи з віртуальними серверами. Інколи з кимось з них можна домовитися про невеликий віртуальний сервер на безоплатній (чи мінімально платній) співпраці.

Плюси/мінуси у віртуального сервера:
* вже є реальна IP,
* врахована плата за електрику та інтернет,
* часто є вбудоване резервування,
* немає стартового внеску але є місячна абонплата.

Для АБІС Koha не підходить звичайний [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D1%85%D0%BE%D1%81%D1%82%D0%B8%D0%BD%D0%B3 віртуальний веб-хостинг], потрібен [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D0%B2%D0%B8%D0%B4%D1%96%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80 ''віртуальний приватний сервер'' (VPS) / ''віртуальний виділений сервер'' (VDS)] з можливістю встановлення [https://uk.wikipedia.org/wiki/Debian Linux Debian] актуальної версії (зараз '''Debian 9''', незабаром 10).

Краще вибирати варіанти з [https://uk.wikipedia.org/wiki/SSD SSD].

Добре щоб був захист від хакерських атак ([https://uk.wikipedia.org/wiki/DoS-%D0%B0%D1%82%D0%B0%D0%BA%D0%B0 DDOS], …).

Запитуйте про резервне копіювання (може входити у тариф чи бути за додаткову плату).

Підтримка може бути 24/7 чи лише у робочий час (дізнавайтеся про обсяг підтримки у тарифі та додатково).

Типи віртуалізації: [https://uk.wikipedia.org/wiki/Kernel-based_Virtual_Machine KVM] (апаратна вірт.), [https://uk.wikipedia.org/wiki/Xen XEN], [https://uk.wikipedia.org/wiki/VMware VMware], [https://uk.wikipedia.org/wiki/OpenVZ OpenVZ].

Добре, щоб була панель для управління VPS-сервером (хоча б для перезавантаження).

Запитуйте дані про рівень сервісу, % працездатності, [https://uk.wikipedia.org/wiki/%D0%A3%D0%B3%D0%BE%D0%B4%D0%B0_%D0%BF%D1%80%D0%BE_%D1%80%D1%96%D0%B2%D0%B5%D0%BD%D1%8C_%D0%BF%D0%BE%D1%81%D0%BB%D1%83%D0%B3 угоду про рівень послуг (SLA)].

Найнаймінімальніший варіант для Koha: 4 Gb RAM, 60 Gb SDD, 2 CPU.

=== VPS в Україні ===
Розрахунок у гривнях.
* [https://uahosting.com.ua/vps.php UAhosting], 100mbps; 20Tb/м.; SSD; KVM, DDOS-захист; панель; бекапи+30%; 9-18/1-5; сервери в Україні та Німеччині; офіси: Київ, Львів.
* [https://uh.ua/ua/ssdvps.html Український хостинг], необм.траф.; SSD; 100mbps; ап.вірт.; [https://uh.ua/ua/uh/kontakty.html офіси]
* [https://hyperhost.ua/uk/vps-vds HyperHost], SSD; 24/7; OpenVZ; офіси: Київ, Вінниця.
* [https://www.ukraine.com.ua/vps/ Хостинг „Украина“], ап.вірт.XEN; SSD; 100mbps; ssh,vnc; [https://www.ukraine.com.ua/contacts/ контакти]
* [https://hostpro.ua/linux-vps.html HostPro], 24/7; KVM; 1 IP; SSD; бекапи 7 днів; офіс: Київ
* [https://deltahost.ua/ua/vps.html#/ DeltaHost]
* [https://gigacloud.ua/ GigaCloud], VMWare
* [https://realhost.pro/uk/vps/linux RealHost]
* [https://cityhost.ua/uk/vds/ CityHost]
* [https://gmhost.com.ua/service/ssd-vps#undefined GMhost]

...інші: [https://toprated.hosting/vps-hosting/#tab-06 1], [https://www.tophosting.in.ua/category/virtualnyj-server-vps-xosting-ukraina 2], [https://ru.hostings.info/hostings/country/ukraine 3], [http://tops.org.ua/uk/nedorohi-ukrayinski-vps-vds.html 4]

Приклади хмарних серверів:
* VPS 8G, 4 ядра, 8 GB, 70 GB, 10 Gbit/s, 10 TB/міс. https://www.ukraine.com.ua/vps/
* VPS 10G, 4 ядра, 10 GB, 80 GB, 10 Gbit/s, 15 TB/міс., https://www.ukraine.com.ua/vps/

=== VPS за кордоном ===
Розрахунок у $.
* [https://www.digitalocean.com/products/linux-distribution/debian/ Digital Ocean]

== Фізичний сервер==
=== Виділений фізичний сервер===
Виділений сервер (dedicated server) — вид хостингу, який надає клієнту оренду окремого фізичного обладнання.

Орендар може вибирати конфігурацію сервера, встановлювати будь-яку ОС, ПО, налаштовувати систему під свої потреби.

У вартість оренди входить первинне налаштування сервера, а також моніторинг навантаження і цілодобова техпідтримка обладнання.
У випадки виходу з ладу - все технічне обслуговування компанія бере на себе.

Виділені сервери в Україні:
* [https://hostpro.ua/ua/servers.html HostPro]
* [https://besthosting.ua/ua/priceservers.php BestHosting] (ТОВ „ОН-ЛАЙН“)
* [https://www.ukrnames.com/ukr/dedicated/ UkrNames]
* [https://deltahost.ua/ua/dedicated.html DeltaHost]
* [https://uahosting.com.ua/dedicated.php UAHosting]
* [https://uh.ua/ua/dedicated-servers/ UH.ua]
* [https://hyperhost.ua/uk/servers/in-ukraine HyperHost]
* [https://www.ukraine.com.ua/dedicated/ Хостинг «Украина»]
* [https://cityhost.ua/uk/server/ CityHost]
* [https://gmhost.com.ua/service/dedicated-servers#UAH GMHost]

=== Власний фізичний сервер===
Зазвичай це значно потужніше рішення.

Плюси/мінуси фізичного сервера:
* більша потужність,
* великі стартові витрати: це сам сервер, блок безперебійного живлення, мережева шафка і мережеве обладнання для підключення до інтернет,
* немає абонплати (окрім витрат на електрику і інтернет),
* про підключення до інтернету, виділення реальної IP потрібно буде подбати самому,
* цей сервер також можна буде використовувати і для інших цілей: веб-сайт бібліотеки, електронний архів, файловий сервер і т.п.

Деякі варіанти фізичних серверів:
* Сервер ARTLINE Business T17v26, https://rozetka.com.ua/ua/artline-t17v26/p396394269/
* Сервер ARTLINE Business R17v26, https://rozetka.com.ua/ua/artline-r17v26/p396394086/

''Примітки: можна розглядати і б/в варіант фізичного сервера, вони зазвичай дуже надійні (розраховані на круглодобову роботу впродовж років).''

==== Колокейшин ====
Це послуга розміщення сервера у провайдера.

=== Локальний комп’ютер-сервер===
Інколи, в малій відокремленій бібліотеці, коли немає потреби надавати доступ через Інтернет, використовують комп’ютер з Linux Debian і як сервер і як робочий комп’ютер бібліотекаря з графічним середовищем ([https://uk.wikipedia.org/wiki/GNOME Gnome], [https://uk.wikipedia.org/wiki/KDE KDE], …).

Однак Linux-фахівець, який інколи обслуговує цей комп’ютер, все ж потрібен.

== Див. також ==
* [https://lists.katipo.co.nz/public/koha/2016-December/046749.html MySQL database server, dedicated vs virtual]

Вибір сервера для АБІС Koha

2026-03-23T11:30:48Z

Dubyk: /* VPS в Україні */

АБІС Koha розрахована на встановлення на сервері з операційною системою Linux Debian. Колись були збірки під Windows, але зараз немає.

Найпоширеніший варіант — це сервер (фізичний чи віртуальний), до якого бібліотекарі і читачі мають доступ через інтернет. Операційна система користувача немає значення (Windows, Linux, Mac, Android) оскільки Koha працює як веб-сайт. Для книговидачі потрібен зчитувач штрикодів (пристрій чи програма).

Варіанти зі серверами:

==Віртуальний сервер==

Може бути платний (абонплата), зазвичай за кордоном дешевше. Часто вузи, міські адміністрації, фірми мають платформи з віртуальними серверами. Інколи з кимось з них можна домовитися про невеликий віртуальний сервер на безоплатній (чи мінімально платній) співпраці.

Плюси/мінуси у віртуального сервера:
* вже є реальна IP,
* врахована плата за електрику та інтернет,
* часто є вбудоване резервування,
* немає стартового внеску але є місячна абонплата.

Для АБІС Koha не підходить звичайний [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D1%85%D0%BE%D1%81%D1%82%D0%B8%D0%BD%D0%B3 віртуальний веб-хостинг], потрібен [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D0%B2%D0%B8%D0%B4%D1%96%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80 ''віртуальний приватний сервер'' (VPS) / ''віртуальний виділений сервер'' (VDS)] з можливістю встановлення [https://uk.wikipedia.org/wiki/Debian Linux Debian] актуальної версії (зараз '''Debian 9''', незабаром 10).

Краще вибирати варіанти з [https://uk.wikipedia.org/wiki/SSD SSD].

Добре щоб був захист від хакерських атак ([https://uk.wikipedia.org/wiki/DoS-%D0%B0%D1%82%D0%B0%D0%BA%D0%B0 DDOS], …).

Запитуйте про резервне копіювання (може входити у тариф чи бути за додаткову плату).

Підтримка може бути 24/7 чи лише у робочий час (дізнавайтеся про обсяг підтримки у тарифі та додатково).

Типи віртуалізації: [https://uk.wikipedia.org/wiki/Kernel-based_Virtual_Machine KVM] (апаратна вірт.), [https://uk.wikipedia.org/wiki/Xen XEN], [https://uk.wikipedia.org/wiki/VMware VMware], [https://uk.wikipedia.org/wiki/OpenVZ OpenVZ].

Добре, щоб була панель для управління VPS-сервером (хоча б для перезавантаження).

Запитуйте дані про рівень сервісу, % працездатності, [https://uk.wikipedia.org/wiki/%D0%A3%D0%B3%D0%BE%D0%B4%D0%B0_%D0%BF%D1%80%D0%BE_%D1%80%D1%96%D0%B2%D0%B5%D0%BD%D1%8C_%D0%BF%D0%BE%D1%81%D0%BB%D1%83%D0%B3 угоду про рівень послуг (SLA)].

Найнаймінімальніший варіант для Koha: 4 Gb RAM, 60 Gb SDD, 2 CPU.

=== VPS в Україні ===
Розрахунок у гривнях.
* [https://uahosting.com.ua/vps.php UAhosting], 100mbps; 20Tb/м.; SSD; KVM, DDOS-захист; панель; бекапи+30%; 9-18/1-5; сервери в Україні та Німеччині; офіси: Київ, Львів.
* [https://uh.ua/ua/ssdvps.html Український хостинг], необм.траф.; SSD; 100mbps; ап.вірт.; [https://uh.ua/ua/uh/kontakty.html офіси]
* [https://hyperhost.ua/uk/vps-vds HyperHost], SSD; 24/7; OpenVZ; офіси: Київ, Вінниця.
* [https://www.ukraine.com.ua/vps/ Хостинг „Украина“], ап.вірт.XEN; SSD; 100mbps; ssh,vnc; [https://www.ukraine.com.ua/contacts/ контакти]
* [https://hostpro.ua/linux-vps.html HostPro], 24/7; KVM; 1 IP; SSD; бекапи 7 днів; офіс: Київ
* [https://deltahost.ua/ua/vps.html#/ DeltaHost]
* [https://gigacloud.ua/ GigaCloud], VMWare
* [https://realhost.pro/uk/vps/linux RealHost]
* [https://cityhost.ua/uk/vds/ CityHost]
* [https://gmhost.com.ua/service/ssd-vps#undefined GMhost]

...інші: [https://toprated.hosting/vps-hosting/#tab-06 1]б [https://www.tophosting.in.ua/category/virtualnyj-server-vps-xosting-ukraina 2], [https://ru.hostings.info/hostings/country/ukraine 3], [http://tops.org.ua/uk/nedorohi-ukrayinski-vps-vds.html 4]

Приклади хмарних серверів:
* VPS 8G, 4 ядра, 8 GB, 70 GB, 10 Gbit/s, 10 TB/міс. https://www.ukraine.com.ua/vps/
* VPS 10G, 4 ядра, 10 GB, 80 GB, 10 Gbit/s, 15 TB/міс., https://www.ukraine.com.ua/vps/

=== VPS за кордоном ===
Розрахунок у $.
* [https://www.digitalocean.com/products/linux-distribution/debian/ Digital Ocean]

== Фізичний сервер==
=== Виділений фізичний сервер===
Виділений сервер (dedicated server) — вид хостингу, який надає клієнту оренду окремого фізичного обладнання.

Орендар може вибирати конфігурацію сервера, встановлювати будь-яку ОС, ПО, налаштовувати систему під свої потреби.

У вартість оренди входить первинне налаштування сервера, а також моніторинг навантаження і цілодобова техпідтримка обладнання.
У випадки виходу з ладу - все технічне обслуговування компанія бере на себе.

Виділені сервери в Україні:
* [https://hostpro.ua/ua/servers.html HostPro]
* [https://besthosting.ua/ua/priceservers.php BestHosting] (ТОВ „ОН-ЛАЙН“)
* [https://www.ukrnames.com/ukr/dedicated/ UkrNames]
* [https://deltahost.ua/ua/dedicated.html DeltaHost]
* [https://uahosting.com.ua/dedicated.php UAHosting]
* [https://uh.ua/ua/dedicated-servers/ UH.ua]
* [https://hyperhost.ua/uk/servers/in-ukraine HyperHost]
* [https://www.ukraine.com.ua/dedicated/ Хостинг «Украина»]
* [https://cityhost.ua/uk/server/ CityHost]
* [https://gmhost.com.ua/service/dedicated-servers#UAH GMHost]

=== Власний фізичний сервер===
Зазвичай це значно потужніше рішення.

Плюси/мінуси фізичного сервера:
* більша потужність,
* великі стартові витрати: це сам сервер, блок безперебійного живлення, мережева шафка і мережеве обладнання для підключення до інтернет,
* немає абонплати (окрім витрат на електрику і інтернет),
* про підключення до інтернету, виділення реальної IP потрібно буде подбати самому,
* цей сервер також можна буде використовувати і для інших цілей: веб-сайт бібліотеки, електронний архів, файловий сервер і т.п.

Деякі варіанти фізичних серверів:
* Сервер ARTLINE Business T17v26, https://rozetka.com.ua/ua/artline-t17v26/p396394269/
* Сервер ARTLINE Business R17v26, https://rozetka.com.ua/ua/artline-r17v26/p396394086/

''Примітки: можна розглядати і б/в варіант фізичного сервера, вони зазвичай дуже надійні (розраховані на круглодобову роботу впродовж років).''

==== Колокейшин ====
Це послуга розміщення сервера у провайдера.

=== Локальний комп’ютер-сервер===
Інколи, в малій відокремленій бібліотеці, коли немає потреби надавати доступ через Інтернет, використовують комп’ютер з Linux Debian і як сервер і як робочий комп’ютер бібліотекаря з графічним середовищем ([https://uk.wikipedia.org/wiki/GNOME Gnome], [https://uk.wikipedia.org/wiki/KDE KDE], …).

Однак Linux-фахівець, який інколи обслуговує цей комп’ютер, все ж потрібен.

== Див. також ==
* [https://lists.katipo.co.nz/public/koha/2016-December/046749.html MySQL database server, dedicated vs virtual]

Вибір сервера для АБІС Koha

2026-03-23T11:29:43Z

Dubyk: /* Віртуальний сервер */

АБІС Koha розрахована на встановлення на сервері з операційною системою Linux Debian. Колись були збірки під Windows, але зараз немає.

Найпоширеніший варіант — це сервер (фізичний чи віртуальний), до якого бібліотекарі і читачі мають доступ через інтернет. Операційна система користувача немає значення (Windows, Linux, Mac, Android) оскільки Koha працює як веб-сайт. Для книговидачі потрібен зчитувач штрикодів (пристрій чи програма).

Варіанти зі серверами:

==Віртуальний сервер==

Може бути платний (абонплата), зазвичай за кордоном дешевше. Часто вузи, міські адміністрації, фірми мають платформи з віртуальними серверами. Інколи з кимось з них можна домовитися про невеликий віртуальний сервер на безоплатній (чи мінімально платній) співпраці.

Плюси/мінуси у віртуального сервера:
* вже є реальна IP,
* врахована плата за електрику та інтернет,
* часто є вбудоване резервування,
* немає стартового внеску але є місячна абонплата.

Для АБІС Koha не підходить звичайний [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D1%85%D0%BE%D1%81%D1%82%D0%B8%D0%BD%D0%B3 віртуальний веб-хостинг], потрібен [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D0%B2%D0%B8%D0%B4%D1%96%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80 ''віртуальний приватний сервер'' (VPS) / ''віртуальний виділений сервер'' (VDS)] з можливістю встановлення [https://uk.wikipedia.org/wiki/Debian Linux Debian] актуальної версії (зараз '''Debian 9''', незабаром 10).

Краще вибирати варіанти з [https://uk.wikipedia.org/wiki/SSD SSD].

Добре щоб був захист від хакерських атак ([https://uk.wikipedia.org/wiki/DoS-%D0%B0%D1%82%D0%B0%D0%BA%D0%B0 DDOS], …).

Запитуйте про резервне копіювання (може входити у тариф чи бути за додаткову плату).

Підтримка може бути 24/7 чи лише у робочий час (дізнавайтеся про обсяг підтримки у тарифі та додатково).

Типи віртуалізації: [https://uk.wikipedia.org/wiki/Kernel-based_Virtual_Machine KVM] (апаратна вірт.), [https://uk.wikipedia.org/wiki/Xen XEN], [https://uk.wikipedia.org/wiki/VMware VMware], [https://uk.wikipedia.org/wiki/OpenVZ OpenVZ].

Добре, щоб була панель для управління VPS-сервером (хоча б для перезавантаження).

Запитуйте дані про рівень сервісу, % працездатності, [https://uk.wikipedia.org/wiki/%D0%A3%D0%B3%D0%BE%D0%B4%D0%B0_%D0%BF%D1%80%D0%BE_%D1%80%D1%96%D0%B2%D0%B5%D0%BD%D1%8C_%D0%BF%D0%BE%D1%81%D0%BB%D1%83%D0%B3 угоду про рівень послуг (SLA)].

Найнаймінімальніший варіант для Koha: 4 Gb RAM, 60 Gb SDD, 2 CPU.

=== VPS в Україні ===
Розрахунок у гривнях.
* [https://uahosting.com.ua/vps.php UAhosting], 100mbps; 20Tb/м.; SSD; KVM, DDOS-захист; панель; бекапи+30%; 9-18/1-5; сервери в Україні та Німеччині; офіси: Київ, Львів.
* [https://uh.ua/ua/ssdvps.html Український хостинг], необм.траф.; SSD; 100mbps; ап.вірт.; [https://uh.ua/ua/uh/kontakty.html офіси]
* [https://hyperhost.ua/uk/vps-vds HyperHost], SSD; 24/7; OpenVZ; офіси: Київ, Вінниця.
* [https://www.ukraine.com.ua/vps/ Хостинг „Украина“], ап.вірт.XEN; SSD; 100mbps; ssh,vnc; [https://www.ukraine.com.ua/contacts/ контакти]
* [https://hostpro.ua/linux-vps.html HostPro], 24/7; KVM; 1 IP; SSD; бекапи 7 днів; офіс: Київ
* [https://deltahost.ua/ua/vps.html#/ DeltaHost]
* [https://gigacloud.ua/ GigaCloud], VMWare
* [https://realhost.pro/uk/vps/linux RealHost]
* [https://cityhost.ua/uk/vds/ CityHost]
* [https://gmhost.com.ua/service/ssd-vps#undefined GMhost]
* [https://ukrdc.net/ua/services/vps-windows-price.html Український Дата Центр]

...інші: [https://toprated.hosting/vps-hosting/#tab-06 1]б [https://www.tophosting.in.ua/category/virtualnyj-server-vps-xosting-ukraina 2], [https://ru.hostings.info/hostings/country/ukraine 3], [http://tops.org.ua/uk/nedorohi-ukrayinski-vps-vds.html 4]

Приклади хмарних серверів:
* VPS 8G, 4 ядра, 8 GB, 70 GB, 10 Gbit/s, 10 TB/міс. https://www.ukraine.com.ua/vps/
* VPS 10G, 4 ядра, 10 GB, 80 GB, 10 Gbit/s, 15 TB/міс., https://www.ukraine.com.ua/vps/

=== VPS за кордоном ===
Розрахунок у $.
* [https://www.digitalocean.com/products/linux-distribution/debian/ Digital Ocean]

== Фізичний сервер==
=== Виділений фізичний сервер===
Виділений сервер (dedicated server) — вид хостингу, який надає клієнту оренду окремого фізичного обладнання.

Орендар може вибирати конфігурацію сервера, встановлювати будь-яку ОС, ПО, налаштовувати систему під свої потреби.

У вартість оренди входить первинне налаштування сервера, а також моніторинг навантаження і цілодобова техпідтримка обладнання.
У випадки виходу з ладу - все технічне обслуговування компанія бере на себе.

Виділені сервери в Україні:
* [https://hostpro.ua/ua/servers.html HostPro]
* [https://besthosting.ua/ua/priceservers.php BestHosting] (ТОВ „ОН-ЛАЙН“)
* [https://www.ukrnames.com/ukr/dedicated/ UkrNames]
* [https://deltahost.ua/ua/dedicated.html DeltaHost]
* [https://uahosting.com.ua/dedicated.php UAHosting]
* [https://uh.ua/ua/dedicated-servers/ UH.ua]
* [https://hyperhost.ua/uk/servers/in-ukraine HyperHost]
* [https://www.ukraine.com.ua/dedicated/ Хостинг «Украина»]
* [https://cityhost.ua/uk/server/ CityHost]
* [https://gmhost.com.ua/service/dedicated-servers#UAH GMHost]

=== Власний фізичний сервер===
Зазвичай це значно потужніше рішення.

Плюси/мінуси фізичного сервера:
* більша потужність,
* великі стартові витрати: це сам сервер, блок безперебійного живлення, мережева шафка і мережеве обладнання для підключення до інтернет,
* немає абонплати (окрім витрат на електрику і інтернет),
* про підключення до інтернету, виділення реальної IP потрібно буде подбати самому,
* цей сервер також можна буде використовувати і для інших цілей: веб-сайт бібліотеки, електронний архів, файловий сервер і т.п.

Деякі варіанти фізичних серверів:
* Сервер ARTLINE Business T17v26, https://rozetka.com.ua/ua/artline-t17v26/p396394269/
* Сервер ARTLINE Business R17v26, https://rozetka.com.ua/ua/artline-r17v26/p396394086/

''Примітки: можна розглядати і б/в варіант фізичного сервера, вони зазвичай дуже надійні (розраховані на круглодобову роботу впродовж років).''

==== Колокейшин ====
Це послуга розміщення сервера у провайдера.

=== Локальний комп’ютер-сервер===
Інколи, в малій відокремленій бібліотеці, коли немає потреби надавати доступ через Інтернет, використовують комп’ютер з Linux Debian і як сервер і як робочий комп’ютер бібліотекаря з графічним середовищем ([https://uk.wikipedia.org/wiki/GNOME Gnome], [https://uk.wikipedia.org/wiki/KDE KDE], …).

Однак Linux-фахівець, який інколи обслуговує цей комп’ютер, все ж потрібен.

== Див. також ==
* [https://lists.katipo.co.nz/public/koha/2016-December/046749.html MySQL database server, dedicated vs virtual]

Вибір сервера для АБІС Koha

2026-03-23T11:27:45Z

Dubyk: /* Див. також */

АБІС Koha розрахована на встановлення на сервері з операційною системою Linux Debian. Колись були збірки під Windows, але зараз немає.

Найпоширеніший варіант — це сервер (фізичний чи віртуальний), до якого бібліотекарі і читачі мають доступ через інтернет. Операційна система користувача немає значення (Windows, Linux, Mac, Android) оскільки Koha працює як веб-сайт. Для книговидачі потрібен зчитувач штрикодів (пристрій чи програма).

Варіанти зі серверами:

==Віртуальний сервер==

Може бути платний (абонплата), зазвичай за кордоном дешевше. Часто вузи, міські адміністрації, фірми мають платформи з віртуальними серверами. Інколи з кимось з них можна домовитися про невеликий віртуальний сервер на безоплатній (чи мінімально платній) співпраці.

Плюси/мінуси у віртуального сервера:
* вже є реальна IP,
* врахована плата за електрику та інтернет,
* часто є вбудоване резервування,
* немає стартового внеску але є місячна абонплата.

Для АБІС Koha не підходить звичайний [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D1%85%D0%BE%D1%81%D1%82%D0%B8%D0%BD%D0%B3 віртуальний веб-хостинг], потрібен [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D0%B2%D0%B8%D0%B4%D1%96%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80 ''віртуальний приватний сервер'' (VPS) / ''віртуальний виділений сервер'' (VDS)] з можливістю встановлення [https://uk.wikipedia.org/wiki/Debian Linux Debian] актуальної версії (зараз '''Debian 9''', незабаром 10).

Краще вибирати варіанти з [https://uk.wikipedia.org/wiki/SSD SSD].

Добре щоб був захист від хакерських атак ([https://uk.wikipedia.org/wiki/DoS-%D0%B0%D1%82%D0%B0%D0%BA%D0%B0 DDOS], …).

Запитуйте про резервне копіювання (може входити у тариф чи бути за додаткову плату).

Підтримка може бути 24/7 чи лише у робочий час (дізнавайтеся про обсяг підтримки у тарифі та додатково).

Типи віртуалізації: [https://uk.wikipedia.org/wiki/Kernel-based_Virtual_Machine KVM] (апаратна вірт.), [https://uk.wikipedia.org/wiki/Xen XEN], [https://uk.wikipedia.org/wiki/VMware VMware], [https://uk.wikipedia.org/wiki/OpenVZ OpenVZ].

Добре, щоб була панель для управління VPS-сервером (хоча б для перезавантаження).

Запитуйте дані про рівень сервісу, % працездатності, [https://uk.wikipedia.org/wiki/%D0%A3%D0%B3%D0%BE%D0%B4%D0%B0_%D0%BF%D1%80%D0%BE_%D1%80%D1%96%D0%B2%D0%B5%D0%BD%D1%8C_%D0%BF%D0%BE%D1%81%D0%BB%D1%83%D0%B3 угоду про рівень послуг (SLA)].

Найнаймінімальніший варіант для Koha: 2 Gb RAM, 20 Gb HDD, 1 CPU.

=== VPS в Україні ===
Розрахунок у гривнях.
* [https://uahosting.com.ua/vps.php UAhosting], 100mbps; 20Tb/м.; SSD; KVM, DDOS-захист; панель; бекапи+30%; 9-18/1-5; сервери в Україні та Німеччині; офіси: Київ, Львів.
* [https://uh.ua/ua/ssdvps.html Український хостинг], необм.траф.; SSD; 100mbps; ап.вірт.; [https://uh.ua/ua/uh/kontakty.html офіси]
* [https://hyperhost.ua/uk/vps-vds HyperHost], SSD; 24/7; OpenVZ; офіси: Київ, Вінниця.
* [https://www.ukraine.com.ua/vps/ Хостинг „Украина“], ап.вірт.XEN; SSD; 100mbps; ssh,vnc; [https://www.ukraine.com.ua/contacts/ контакти]
* [https://hostpro.ua/linux-vps.html HostPro], 24/7; KVM; 1 IP; SSD; бекапи 7 днів; офіс: Київ
* [https://deltahost.ua/ua/vps.html#/ DeltaHost]
* [https://gigacloud.ua/ GigaCloud], VMWare
* [https://realhost.pro/uk/vps/linux RealHost]
* [https://cityhost.ua/uk/vds/ CityHost]
* [https://gmhost.com.ua/service/ssd-vps#undefined GMhost]
* [https://ukrdc.net/ua/services/vps-windows-price.html Український Дата Центр]

...інші: [https://toprated.hosting/vps-hosting/#tab-06 1]б [https://www.tophosting.in.ua/category/virtualnyj-server-vps-xosting-ukraina 2], [https://ru.hostings.info/hostings/country/ukraine 3], [http://tops.org.ua/uk/nedorohi-ukrayinski-vps-vds.html 4]

Приклади хмарних серверів:
* VPS 8G, 4 ядра, 8 GB, 70 GB, 10 Gbit/s, 10 TB/міс. https://www.ukraine.com.ua/vps/
* VPS 10G, 4 ядра, 10 GB, 80 GB, 10 Gbit/s, 15 TB/міс., https://www.ukraine.com.ua/vps/

=== VPS за кордоном ===
Розрахунок у $.
* [https://www.digitalocean.com/products/linux-distribution/debian/ Digital Ocean]

== Фізичний сервер==
=== Виділений фізичний сервер===
Виділений сервер (dedicated server) — вид хостингу, який надає клієнту оренду окремого фізичного обладнання.

Орендар може вибирати конфігурацію сервера, встановлювати будь-яку ОС, ПО, налаштовувати систему під свої потреби.

У вартість оренди входить первинне налаштування сервера, а також моніторинг навантаження і цілодобова техпідтримка обладнання.
У випадки виходу з ладу - все технічне обслуговування компанія бере на себе.

Виділені сервери в Україні:
* [https://hostpro.ua/ua/servers.html HostPro]
* [https://besthosting.ua/ua/priceservers.php BestHosting] (ТОВ „ОН-ЛАЙН“)
* [https://www.ukrnames.com/ukr/dedicated/ UkrNames]
* [https://deltahost.ua/ua/dedicated.html DeltaHost]
* [https://uahosting.com.ua/dedicated.php UAHosting]
* [https://uh.ua/ua/dedicated-servers/ UH.ua]
* [https://hyperhost.ua/uk/servers/in-ukraine HyperHost]
* [https://www.ukraine.com.ua/dedicated/ Хостинг «Украина»]
* [https://cityhost.ua/uk/server/ CityHost]
* [https://gmhost.com.ua/service/dedicated-servers#UAH GMHost]

=== Власний фізичний сервер===
Зазвичай це значно потужніше рішення.

Плюси/мінуси фізичного сервера:
* більша потужність,
* великі стартові витрати: це сам сервер, блок безперебійного живлення, мережева шафка і мережеве обладнання для підключення до інтернет,
* немає абонплати (окрім витрат на електрику і інтернет),
* про підключення до інтернету, виділення реальної IP потрібно буде подбати самому,
* цей сервер також можна буде використовувати і для інших цілей: веб-сайт бібліотеки, електронний архів, файловий сервер і т.п.

Деякі варіанти фізичних серверів:
* Сервер ARTLINE Business T17v26, https://rozetka.com.ua/ua/artline-t17v26/p396394269/
* Сервер ARTLINE Business R17v26, https://rozetka.com.ua/ua/artline-r17v26/p396394086/

''Примітки: можна розглядати і б/в варіант фізичного сервера, вони зазвичай дуже надійні (розраховані на круглодобову роботу впродовж років).''

==== Колокейшин ====
Це послуга розміщення сервера у провайдера.

=== Локальний комп’ютер-сервер===
Інколи, в малій відокремленій бібліотеці, коли немає потреби надавати доступ через Інтернет, використовують комп’ютер з Linux Debian і як сервер і як робочий комп’ютер бібліотекаря з графічним середовищем ([https://uk.wikipedia.org/wiki/GNOME Gnome], [https://uk.wikipedia.org/wiki/KDE KDE], …).

Однак Linux-фахівець, який інколи обслуговує цей комп’ютер, все ж потрібен.

== Див. також ==
* [https://lists.katipo.co.nz/public/koha/2016-December/046749.html MySQL database server, dedicated vs virtual]

Вибір сервера для АБІС Koha

2026-03-23T11:25:44Z

Dubyk: /* VPS в Україні */

АБІС Koha розрахована на встановлення на сервері з операційною системою Linux Debian. Колись були збірки під Windows, але зараз немає.

Найпоширеніший варіант — це сервер (фізичний чи віртуальний), до якого бібліотекарі і читачі мають доступ через інтернет. Операційна система користувача немає значення (Windows, Linux, Mac, Android) оскільки Koha працює як веб-сайт. Для книговидачі потрібен зчитувач штрикодів (пристрій чи програма).

Варіанти зі серверами:

==Віртуальний сервер==

Може бути платний (абонплата), зазвичай за кордоном дешевше. Часто вузи, міські адміністрації, фірми мають платформи з віртуальними серверами. Інколи з кимось з них можна домовитися про невеликий віртуальний сервер на безоплатній (чи мінімально платній) співпраці.

Плюси/мінуси у віртуального сервера:
* вже є реальна IP,
* врахована плата за електрику та інтернет,
* часто є вбудоване резервування,
* немає стартового внеску але є місячна абонплата.

Для АБІС Koha не підходить звичайний [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D1%85%D0%BE%D1%81%D1%82%D0%B8%D0%BD%D0%B3 віртуальний веб-хостинг], потрібен [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D0%B2%D0%B8%D0%B4%D1%96%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80 ''віртуальний приватний сервер'' (VPS) / ''віртуальний виділений сервер'' (VDS)] з можливістю встановлення [https://uk.wikipedia.org/wiki/Debian Linux Debian] актуальної версії (зараз '''Debian 9''', незабаром 10).

Краще вибирати варіанти з [https://uk.wikipedia.org/wiki/SSD SSD].

Добре щоб був захист від хакерських атак ([https://uk.wikipedia.org/wiki/DoS-%D0%B0%D1%82%D0%B0%D0%BA%D0%B0 DDOS], …).

Запитуйте про резервне копіювання (може входити у тариф чи бути за додаткову плату).

Підтримка може бути 24/7 чи лише у робочий час (дізнавайтеся про обсяг підтримки у тарифі та додатково).

Типи віртуалізації: [https://uk.wikipedia.org/wiki/Kernel-based_Virtual_Machine KVM] (апаратна вірт.), [https://uk.wikipedia.org/wiki/Xen XEN], [https://uk.wikipedia.org/wiki/VMware VMware], [https://uk.wikipedia.org/wiki/OpenVZ OpenVZ].

Добре, щоб була панель для управління VPS-сервером (хоча б для перезавантаження).

Запитуйте дані про рівень сервісу, % працездатності, [https://uk.wikipedia.org/wiki/%D0%A3%D0%B3%D0%BE%D0%B4%D0%B0_%D0%BF%D1%80%D0%BE_%D1%80%D1%96%D0%B2%D0%B5%D0%BD%D1%8C_%D0%BF%D0%BE%D1%81%D0%BB%D1%83%D0%B3 угоду про рівень послуг (SLA)].

Найнаймінімальніший варіант для Koha: 2 Gb RAM, 20 Gb HDD, 1 CPU.

=== VPS в Україні ===
Розрахунок у гривнях.
* [https://uahosting.com.ua/vps.php UAhosting], 100mbps; 20Tb/м.; SSD; KVM, DDOS-захист; панель; бекапи+30%; 9-18/1-5; сервери в Україні та Німеччині; офіси: Київ, Львів.
* [https://uh.ua/ua/ssdvps.html Український хостинг], необм.траф.; SSD; 100mbps; ап.вірт.; [https://uh.ua/ua/uh/kontakty.html офіси]
* [https://hyperhost.ua/uk/vps-vds HyperHost], SSD; 24/7; OpenVZ; офіси: Київ, Вінниця.
* [https://www.ukraine.com.ua/vps/ Хостинг „Украина“], ап.вірт.XEN; SSD; 100mbps; ssh,vnc; [https://www.ukraine.com.ua/contacts/ контакти]
* [https://hostpro.ua/linux-vps.html HostPro], 24/7; KVM; 1 IP; SSD; бекапи 7 днів; офіс: Київ
* [https://deltahost.ua/ua/vps.html#/ DeltaHost]
* [https://gigacloud.ua/ GigaCloud], VMWare
* [https://realhost.pro/uk/vps/linux RealHost]
* [https://cityhost.ua/uk/vds/ CityHost]
* [https://gmhost.com.ua/service/ssd-vps#undefined GMhost]
* [https://ukrdc.net/ua/services/vps-windows-price.html Український Дата Центр]

...інші: [https://toprated.hosting/vps-hosting/#tab-06 1]б [https://www.tophosting.in.ua/category/virtualnyj-server-vps-xosting-ukraina 2], [https://ru.hostings.info/hostings/country/ukraine 3], [http://tops.org.ua/uk/nedorohi-ukrayinski-vps-vds.html 4]

Приклади хмарних серверів:
* VPS 8G, 4 ядра, 8 GB, 70 GB, 10 Gbit/s, 10 TB/міс. https://www.ukraine.com.ua/vps/
* VPS 10G, 4 ядра, 10 GB, 80 GB, 10 Gbit/s, 15 TB/міс., https://www.ukraine.com.ua/vps/

=== VPS за кордоном ===
Розрахунок у $.
* [https://www.digitalocean.com/products/linux-distribution/debian/ Digital Ocean]

== Фізичний сервер==
=== Виділений фізичний сервер===
Виділений сервер (dedicated server) — вид хостингу, який надає клієнту оренду окремого фізичного обладнання.

Орендар може вибирати конфігурацію сервера, встановлювати будь-яку ОС, ПО, налаштовувати систему під свої потреби.

У вартість оренди входить первинне налаштування сервера, а також моніторинг навантаження і цілодобова техпідтримка обладнання.
У випадки виходу з ладу - все технічне обслуговування компанія бере на себе.

Виділені сервери в Україні:
* [https://hostpro.ua/ua/servers.html HostPro]
* [https://besthosting.ua/ua/priceservers.php BestHosting] (ТОВ „ОН-ЛАЙН“)
* [https://www.ukrnames.com/ukr/dedicated/ UkrNames]
* [https://deltahost.ua/ua/dedicated.html DeltaHost]
* [https://uahosting.com.ua/dedicated.php UAHosting]
* [https://uh.ua/ua/dedicated-servers/ UH.ua]
* [https://hyperhost.ua/uk/servers/in-ukraine HyperHost]
* [https://www.ukraine.com.ua/dedicated/ Хостинг «Украина»]
* [https://cityhost.ua/uk/server/ CityHost]
* [https://gmhost.com.ua/service/dedicated-servers#UAH GMHost]

=== Власний фізичний сервер===
Зазвичай це значно потужніше рішення.

Плюси/мінуси фізичного сервера:
* більша потужність,
* великі стартові витрати: це сам сервер, блок безперебійного живлення, мережева шафка і мережеве обладнання для підключення до інтернет,
* немає абонплати (окрім витрат на електрику і інтернет),
* про підключення до інтернету, виділення реальної IP потрібно буде подбати самому,
* цей сервер також можна буде використовувати і для інших цілей: веб-сайт бібліотеки, електронний архів, файловий сервер і т.п.

Деякі варіанти фізичних серверів:
* Сервер ARTLINE Business T17v26, https://rozetka.com.ua/ua/artline-t17v26/p396394269/
* Сервер ARTLINE Business R17v26, https://rozetka.com.ua/ua/artline-r17v26/p396394086/

''Примітки: можна розглядати і б/в варіант фізичного сервера, вони зазвичай дуже надійні (розраховані на круглодобову роботу впродовж років).''

==== Колокейшин ====
Це послуга розміщення сервера у провайдера.

=== Локальний комп’ютер-сервер===
Інколи, в малій відокремленій бібліотеці, коли немає потреби надавати доступ через Інтернет, використовують комп’ютер з Linux Debian і як сервер і як робочий комп’ютер бібліотекаря з графічним середовищем ([https://uk.wikipedia.org/wiki/GNOME Gnome], [https://uk.wikipedia.org/wiki/KDE KDE], …).

Однак Linux-фахівець, який інколи обслуговує цей комп’ютер, все ж потрібен.

== Див. також ==
* [http://koha.1045719.n5.nabble.com/MySQL-database-server-dedicated-vs-virtual-td5912533.html#a5913263 MySQL database server, dedicated vs virtual] (форум [http://koha.1045719.n5.nabble.com/ Nabble Koha])

Вибір сервера для АБІС Koha

2026-03-23T11:24:16Z

Dubyk: /* Власний фізичний сервер */

АБІС Koha розрахована на встановлення на сервері з операційною системою Linux Debian. Колись були збірки під Windows, але зараз немає.

Найпоширеніший варіант — це сервер (фізичний чи віртуальний), до якого бібліотекарі і читачі мають доступ через інтернет. Операційна система користувача немає значення (Windows, Linux, Mac, Android) оскільки Koha працює як веб-сайт. Для книговидачі потрібен зчитувач штрикодів (пристрій чи програма).

Варіанти зі серверами:

==Віртуальний сервер==

Може бути платний (абонплата), зазвичай за кордоном дешевше. Часто вузи, міські адміністрації, фірми мають платформи з віртуальними серверами. Інколи з кимось з них можна домовитися про невеликий віртуальний сервер на безоплатній (чи мінімально платній) співпраці.

Плюси/мінуси у віртуального сервера:
* вже є реальна IP,
* врахована плата за електрику та інтернет,
* часто є вбудоване резервування,
* немає стартового внеску але є місячна абонплата.

Для АБІС Koha не підходить звичайний [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D1%85%D0%BE%D1%81%D1%82%D0%B8%D0%BD%D0%B3 віртуальний веб-хостинг], потрібен [https://uk.wikipedia.org/wiki/%D0%92%D1%96%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%B8%D0%B9_%D0%B2%D0%B8%D0%B4%D1%96%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80 ''віртуальний приватний сервер'' (VPS) / ''віртуальний виділений сервер'' (VDS)] з можливістю встановлення [https://uk.wikipedia.org/wiki/Debian Linux Debian] актуальної версії (зараз '''Debian 9''', незабаром 10).

Краще вибирати варіанти з [https://uk.wikipedia.org/wiki/SSD SSD].

Добре щоб був захист від хакерських атак ([https://uk.wikipedia.org/wiki/DoS-%D0%B0%D1%82%D0%B0%D0%BA%D0%B0 DDOS], …).

Запитуйте про резервне копіювання (може входити у тариф чи бути за додаткову плату).

Підтримка може бути 24/7 чи лише у робочий час (дізнавайтеся про обсяг підтримки у тарифі та додатково).

Типи віртуалізації: [https://uk.wikipedia.org/wiki/Kernel-based_Virtual_Machine KVM] (апаратна вірт.), [https://uk.wikipedia.org/wiki/Xen XEN], [https://uk.wikipedia.org/wiki/VMware VMware], [https://uk.wikipedia.org/wiki/OpenVZ OpenVZ].

Добре, щоб була панель для управління VPS-сервером (хоча б для перезавантаження).

Запитуйте дані про рівень сервісу, % працездатності, [https://uk.wikipedia.org/wiki/%D0%A3%D0%B3%D0%BE%D0%B4%D0%B0_%D0%BF%D1%80%D0%BE_%D1%80%D1%96%D0%B2%D0%B5%D0%BD%D1%8C_%D0%BF%D0%BE%D1%81%D0%BB%D1%83%D0%B3 угоду про рівень послуг (SLA)].

Найнаймінімальніший варіант для Koha: 2 Gb RAM, 20 Gb HDD, 1 CPU.

=== VPS в Україні ===
Розрахунок у гривнях.
* [https://uahosting.com.ua/vps.php UAhosting], 100mbps; 20Tb/м.; SSD; KVM, DDOS-захист; панель; бекапи+30%; 9-18/1-5; сервери в Україні та Німеччині; офіси: Київ, Львів.
* [https://uh.ua/ua/ssdvps.html Український хостинг], необм.траф.; SSD; 100mbps; ап.вірт.; [https://uh.ua/ua/uh/kontakty.html офіси]
* [https://hyperhost.ua/uk/vps-vds HyperHost], SSD; 24/7; OpenVZ; офіси: Київ, Вінниця.
* [https://www.ukraine.com.ua/vps/ Хостинг „Украина“], ап.вірт.XEN; SSD; 100mbps; ssh,vnc; [https://www.ukraine.com.ua/contacts/ контакти]
* [https://hostpro.ua/linux-vps.html HostPro], 24/7; KVM; 1 IP; SSD; бекапи 7 днів; офіс: Київ
* [https://deltahost.ua/ua/vps.html#/ DeltaHost]
* [https://gigacloud.ua/ GigaCloud], VMWare
* [https://realhost.pro/uk/vps/linux RealHost]
* [https://cityhost.ua/uk/vds/ CityHost]
* [https://gmhost.com.ua/service/ssd-vps#undefined GMhost]
* [https://ukrdc.net/ua/services/vps-windows-price.html Український Дата Центр]

...інші: [https://toprated.hosting/vps-hosting/#tab-06 1]б [https://www.tophosting.in.ua/category/virtualnyj-server-vps-xosting-ukraina 2], [https://ru.hostings.info/hostings/country/ukraine 3], [http://tops.org.ua/uk/nedorohi-ukrayinski-vps-vds.html 4]

=== VPS за кордоном ===
Розрахунок у $.
* [https://www.digitalocean.com/products/linux-distribution/debian/ Digital Ocean]

== Фізичний сервер==
=== Виділений фізичний сервер===
Виділений сервер (dedicated server) — вид хостингу, який надає клієнту оренду окремого фізичного обладнання.

Орендар може вибирати конфігурацію сервера, встановлювати будь-яку ОС, ПО, налаштовувати систему під свої потреби.

У вартість оренди входить первинне налаштування сервера, а також моніторинг навантаження і цілодобова техпідтримка обладнання.
У випадки виходу з ладу - все технічне обслуговування компанія бере на себе.

Виділені сервери в Україні:
* [https://hostpro.ua/ua/servers.html HostPro]
* [https://besthosting.ua/ua/priceservers.php BestHosting] (ТОВ „ОН-ЛАЙН“)
* [https://www.ukrnames.com/ukr/dedicated/ UkrNames]
* [https://deltahost.ua/ua/dedicated.html DeltaHost]
* [https://uahosting.com.ua/dedicated.php UAHosting]
* [https://uh.ua/ua/dedicated-servers/ UH.ua]
* [https://hyperhost.ua/uk/servers/in-ukraine HyperHost]
* [https://www.ukraine.com.ua/dedicated/ Хостинг «Украина»]
* [https://cityhost.ua/uk/server/ CityHost]
* [https://gmhost.com.ua/service/dedicated-servers#UAH GMHost]

=== Власний фізичний сервер===
Зазвичай це значно потужніше рішення.

Плюси/мінуси фізичного сервера:
* більша потужність,
* великі стартові витрати: це сам сервер, блок безперебійного живлення, мережева шафка і мережеве обладнання для підключення до інтернет,
* немає абонплати (окрім витрат на електрику і інтернет),
* про підключення до інтернету, виділення реальної IP потрібно буде подбати самому,
* цей сервер також можна буде використовувати і для інших цілей: веб-сайт бібліотеки, електронний архів, файловий сервер і т.п.

Деякі варіанти фізичних серверів:
* Сервер ARTLINE Business T17v26, https://rozetka.com.ua/ua/artline-t17v26/p396394269/
* Сервер ARTLINE Business R17v26, https://rozetka.com.ua/ua/artline-r17v26/p396394086/

''Примітки: можна розглядати і б/в варіант фізичного сервера, вони зазвичай дуже надійні (розраховані на круглодобову роботу впродовж років).''

==== Колокейшин ====
Це послуга розміщення сервера у провайдера.

=== Локальний комп’ютер-сервер===
Інколи, в малій відокремленій бібліотеці, коли немає потреби надавати доступ через Інтернет, використовують комп’ютер з Linux Debian і як сервер і як робочий комп’ютер бібліотекаря з графічним середовищем ([https://uk.wikipedia.org/wiki/GNOME Gnome], [https://uk.wikipedia.org/wiki/KDE KDE], …).

Однак Linux-фахівець, який інколи обслуговує цей комп’ютер, все ж потрібен.

== Див. також ==
* [http://koha.1045719.n5.nabble.com/MySQL-database-server-dedicated-vs-virtual-td5912533.html#a5913263 MySQL database server, dedicated vs virtual] (форум [http://koha.1045719.n5.nabble.com/ Nabble Koha])

Rebuild nozebra.pl

2025-09-29T06:52:05Z

Dubyk: /* Джерела */

== Назва ==
rebuild_nozebra.pl — сценарій переіндексування бібліографічних та віторитетних MARC-записів у БД Zebra.

Використовуйте це пакетне завдання, щоб переіндексувати усі бібліотечні або авторитетні записи у Вашій базі даних Koha.

== Опис ==
Параметри:

'''-b'''
: — індексувати бібліографічні записи

'''-a'''
: — індексувати авторитетні записи

''' -daemon'''
: — Запуск у режимі сервісу. Програма циклічно перевіряє таблицю zebraqueue, обробляючи записи поступово, якщо вони є, після чого робить паузу на кілька секунд і повторює процес.
: Перевірка таблиці zebraqueue виконується простим SQL-запитом. Це дозволяє майже в реальному часі оновлювати пошуковий індекс Zebra з мінімальним навантаженням на систему.
: Використовуйте -sleep для керування інтервалом перевірки.
: Режим сервісу передбачає параметри -z, -a, -b. Програма відмовиться запускатися, якщо вказані параметри, які не мають сенсу під час інкрементального оновлення (наприклад, -r чи -offset).

''' -sleep 10'''
: — Кількість секунд паузи між перевірками таблиці zebraqueue у режимі сервісу. Типово — 5 секунд.

''' -z'''
: — Вибирати лише оновлені та вилученіі записи, позначені у таблиці zebraqueue. Неможливо використовувати разом із -r або -s.

''' --skip-deletes'''
: — Вибирати лише оновлення записів, без вилучень, щоб уникнути надмірного I/O під час обробки вилучень zebraidx.
: Якщо цей параметр використовується для звичайної індексації, слід налаштувати cron-завдання для запуску
: rebuild_zebra.pl -z без --skip-deletes
: у неробочий час.
: Діє лише з -z.

''' -r '''
: — Очистити індекс Zebra перед додаванням записів. Передбачає -w.

''' -d '''
: — Тимчасовий каталог для індексації.
: Якщо не вказаний, створюється автоматично. Каталог експорту видаляється автоматично, якщо не задано параметр -k.

''' -k'''
: — Не вилучати каталог експорту.

''' -s'''
: — Пропустити експорт. Використовується, якщо записи вже були експортовані під час попереднього запуску.

''' -nosanitize'''
: — Експортувати бібліографічні/авторитетні записи безпосередньо з поля marcxml у БД без „очищення“. Це пришвидшує процес дампу, але може спричинити помилки, якщо у БД є некоректно закодовані записи. Працює лише з -x.

''' -w'''
: — Пропустити „тіньове індексування“ для цього пакета.

''' -y'''
: — НЕ очищати zebraqueue після індексації; зазвичай після пакетної індексації zebraqueue має бути позначена як виконана для відповідних типів записів, щоб zebraqueue_daemon не намагався їх повторно індексувати. Використовуйте -y, щоб змінити це.
: Неможливо використовувати з -z.

''' -v'''
: — Збільшити рівень логування. Типово показуються лише попередження та помилки індексації.
: Використовуйте рівень логування 2 (-v -v), щоб включити усі журнали Zebra.

''' --length 1234'''
: — Кількість бібліографічних записів для експорту.

''' --offset 1243'''
: — Зміщення, з якого почати експорт.
: приклад: --offset 500 --length=500 призведе до LIMIT 500,1000 (експорт 1000 записів, починаючи з 500-го).
: )
: Зверніть увагу: ці числа НЕ пов’язані з biblionumber — так і задумано.

''' --where'''
: — Дозволяє вказати умову WHERE, наприклад itemtype='BOOK' чи щось подібне.

''' --run-as-root'''
: — Явно дозволити запуск сценарію від користувача 'root'.

''' --wait-for-lock'''
: — Якщо не в режимі служби, типовою поведінкою є переривання відновлення, якщо блокування зайняте. Цей параметр змусить програму чекати звільнення блокування і тоді продовжити процес.

''' --table'''
: — Вказати таблицю (може бути items, biblioitems, biblio, biblio_metadata) для отримання biblionumber для індексації.
: Типово використовується biblioitems.

''' --help or -h'''
: — Показати це повідомлення.

== Джерела ==
* https://git.koha-community.org/gitweb/?p=koha.git;a=blob;f=misc/migration_tools/rebuild_zebra.pl;h=ec19ce1f5c40445dcdb7c033414fde02dcb06c2b;hb=HEAD#l857
* https://github.com/Koha-Community/Koha/blob/master/misc/migration_tools/rebuild_zebra.pl

Rebuild nozebra.pl

2025-09-26T06:05:37Z

Dubyk:

== Назва ==
rebuild_nozebra.pl — сценарій переіндексування бібліографічних та віторитетних MARC-записів у БД Zebra.

Використовуйте це пакетне завдання, щоб переіндексувати усі бібліотечні або авторитетні записи у Вашій базі даних Koha.

== Опис ==
Параметри:

'''-b'''
: — індексувати бібліографічні записи

'''-a'''
: — індексувати авторитетні записи

''' -daemon'''
: — Запуск у режимі сервісу. Програма циклічно перевіряє таблицю zebraqueue, обробляючи записи поступово, якщо вони є, після чого робить паузу на кілька секунд і повторює процес.
: Перевірка таблиці zebraqueue виконується простим SQL-запитом. Це дозволяє майже в реальному часі оновлювати пошуковий індекс Zebra з мінімальним навантаженням на систему.
: Використовуйте -sleep для керування інтервалом перевірки.
: Режим сервісу передбачає параметри -z, -a, -b. Програма відмовиться запускатися, якщо вказані параметри, які не мають сенсу під час інкрементального оновлення (наприклад, -r чи -offset).

''' -sleep 10'''
: — Кількість секунд паузи між перевірками таблиці zebraqueue у режимі сервісу. Типово — 5 секунд.

''' -z'''
: — Вибирати лише оновлені та вилученіі записи, позначені у таблиці zebraqueue. Неможливо використовувати разом із -r або -s.

''' --skip-deletes'''
: — Вибирати лише оновлення записів, без вилучень, щоб уникнути надмірного I/O під час обробки вилучень zebraidx.
: Якщо цей параметр використовується для звичайної індексації, слід налаштувати cron-завдання для запуску
: rebuild_zebra.pl -z без --skip-deletes
: у неробочий час.
: Діє лише з -z.

''' -r '''
: — Очистити індекс Zebra перед додаванням записів. Передбачає -w.

''' -d '''
: — Тимчасовий каталог для індексації.
: Якщо не вказаний, створюється автоматично. Каталог експорту видаляється автоматично, якщо не задано параметр -k.

''' -k'''
: — Не вилучати каталог експорту.

''' -s'''
: — Пропустити експорт. Використовується, якщо записи вже були експортовані під час попереднього запуску.

''' -nosanitize'''
: — Експортувати бібліографічні/авторитетні записи безпосередньо з поля marcxml у БД без „очищення“. Це пришвидшує процес дампу, але може спричинити помилки, якщо у БД є некоректно закодовані записи. Працює лише з -x.

''' -w'''
: — Пропустити „тіньове індексування“ для цього пакета.

''' -y'''
: — НЕ очищати zebraqueue після індексації; зазвичай після пакетної індексації zebraqueue має бути позначена як виконана для відповідних типів записів, щоб zebraqueue_daemon не намагався їх повторно індексувати. Використовуйте -y, щоб змінити це.
: Неможливо використовувати з -z.

''' -v'''
: — Збільшити рівень логування. Типово показуються лише попередження та помилки індексації.
: Використовуйте рівень логування 2 (-v -v), щоб включити усі журнали Zebra.

''' --length 1234'''
: — Кількість бібліографічних записів для експорту.

''' --offset 1243'''
: — Зміщення, з якого почати експорт.
: приклад: --offset 500 --length=500 призведе до LIMIT 500,1000 (експорт 1000 записів, починаючи з 500-го).
: )
: Зверніть увагу: ці числа НЕ пов’язані з biblionumber — так і задумано.

''' --where'''
: — Дозволяє вказати умову WHERE, наприклад itemtype='BOOK' чи щось подібне.

''' --run-as-root'''
: — Явно дозволити запуск сценарію від користувача 'root'.

''' --wait-for-lock'''
: — Якщо не в режимі служби, типовою поведінкою є переривання відновлення, якщо блокування зайняте. Цей параметр змусить програму чекати звільнення блокування і тоді продовжити процес.

''' --table'''
: — Вказати таблицю (може бути items, biblioitems, biblio, biblio_metadata) для отримання biblionumber для індексації.
: Типово використовується biblioitems.

''' --help or -h'''
: — Показати це повідомлення.

== Джерела ==
* https://git.koha-community.org/gitweb/?p=koha.git;a=blob;f=misc/migration_tools/rebuild_zebra.pl;h=ec19ce1f5c40445dcdb7c033414fde02dcb06c2b;hb=HEAD
* https://github.com/Koha-Community/Koha/blob/master/misc/migration_tools/rebuild_zebra.pl

Встановлення Koha з репозитарію на ОС Debian

2025-06-17T13:56:29Z

Dubyk: /* Встановлення БД MySQL та допоміжних пакунків */

Розглядається встановлення АБІС Koha версії 23.11-25.05 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільні версії, які виходять 2 рази на рік і підтримуються 24-42 місяці (https://wiki.koha-community.org/wiki/Koha_Versioning).

Налаштування ключів:

sudo apt update
sudo apt install sudo apt-transport-https ca-certificates curl gnupg2
sudo mkdir -p --mode=0755 /etc/apt/keyrings
sudo curl -fsSL https://debian.koha-community.org/koha/gpg.asc -o /etc/apt/keyrings/koha.asc

Якщо ви дотримуєтесь певного номера версії Koha, ви залишаєтесь на цій версії Koha, доки не буде змінено вихідні коди пакунків.
Це рекомендується для виробничих середовищ, щоб "випадково" не оновитися до нового великого випуску.

Коли ви запускаєте оновлення, ви оновлюєтесь лише до останнього випуску технічного обслуговування для обраної версії.

Поточні номери версій Koha та їхні кодові назви:

* 25.05 (stable) — поточний стабільний реліз і наступна версія з довготривалою підтримкою (LTS)
* 24.11 (LTS) (oldstable) — на один реліз позаду від поточного стабільного
* 24.05 (oldoldstable) — на два релізи позаду від поточного стабільного
* 23.11 (oldoldoldstable) — версія з довготривалою підтримкою, підтримується приблизно 3 з половиною роки

Щоб оновити список джерел пакетів для використання релізу 25.05:

sudo tee /etc/apt/sources.list.d/koha.sources <<EOF
Types: deb
URIs: https://debian.koha-community.org/koha/
Suites: 25.05
Components: main
Signed-By: /etc/apt/keyrings/koha.asc
EOF

Щоб оновити список джерел пакетів для використання релізу 24.11:

sudo tee /etc/apt/sources.list.d/koha.sources <<EOF
Types: deb
URIs: https://debian.koha-community.org/koha/
Suites: 24.11
Components: main
Signed-By: /etc/apt/keyrings/koha.asc
EOF

Примітка: якщо ви раніше використовували старий формат списку джерел APT, видаліть файл /etc/apt/sources.list.d/koha.list.

Оновлюємо список доступних для встановлення пакунків

sudo apt update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mariadb restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''
* '''Test::PerlTidy'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'

sudo perl -MCPAN -e 'install Test::PerlTidy'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_25_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами. Примітка: sudo koha-translate --update uk-UA також генерує yaml-файли (потрібно при встановленні екземплярів Коха).

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
INSTANCE="ukr_unimarc"
MYSQL_USER="koha_"$INSTANCE
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_"$INSTANCE
# Вибір всіх таблиць в базі даних
TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart $INSTANCE

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

Для більшого контролю над наступними оновленнями Коха можна закоментувати рядок у /etc/apt/sources.list.d/koha.list (і розкоментовувати чи змінювати при ручному оновленні АБІС Koha).

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

Напр.
sudo apt-get install libhttp-tiny-perl

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2025-06-12T14:08:17Z

Dubyk: /* Веб-встановлювач */

Розглядається встановлення АБІС Koha версії 23.11-25.05 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільні версії, які виходять 2 рази на рік і підтримуються 24-42 місяці (https://wiki.koha-community.org/wiki/Koha_Versioning).

Налаштування ключів:

sudo apt update
sudo apt install sudo apt-transport-https ca-certificates curl gnupg2
sudo mkdir -p --mode=0755 /etc/apt/keyrings
sudo curl -fsSL https://debian.koha-community.org/koha/gpg.asc -o /etc/apt/keyrings/koha.asc

Якщо ви дотримуєтесь певного номера версії Koha, ви залишаєтесь на цій версії Koha, доки не буде змінено вихідні коди пакунків.
Це рекомендується для виробничих середовищ, щоб "випадково" не оновитися до нового великого випуску.

Коли ви запускаєте оновлення, ви оновлюєтесь лише до останнього випуску технічного обслуговування для обраної версії.

Поточні номери версій Koha та їхні кодові назви:

* 25.05 (stable) — поточний стабільний реліз і наступна версія з довготривалою підтримкою (LTS)
* 24.11 (LTS) (oldstable) — на один реліз позаду від поточного стабільного
* 24.05 (oldoldstable) — на два релізи позаду від поточного стабільного
* 23.11 (oldoldoldstable) — версія з довготривалою підтримкою, підтримується приблизно 3 з половиною роки

Щоб оновити список джерел пакетів для використання релізу 25.05:

sudo tee /etc/apt/sources.list.d/koha.sources <<EOF
Types: deb
URIs: https://debian.koha-community.org/koha/
Suites: 25.05
Components: main
Signed-By: /etc/apt/keyrings/koha.asc
EOF

Щоб оновити список джерел пакетів для використання релізу 24.11:

sudo tee /etc/apt/sources.list.d/koha.sources <<EOF
Types: deb
URIs: https://debian.koha-community.org/koha/
Suites: 24.11
Components: main
Signed-By: /etc/apt/keyrings/koha.asc
EOF

Примітка: якщо ви раніше використовували старий формат списку джерел APT, видаліть файл /etc/apt/sources.list.d/koha.list.

Оновлюємо список доступних для встановлення пакунків

sudo apt update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''
* '''Test::PerlTidy'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'

sudo perl -MCPAN -e 'install Test::PerlTidy'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_25_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами. Примітка: sudo koha-translate --update uk-UA також генерує yaml-файли (потрібно при встановленні екземплярів Коха).

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
INSTANCE="ukr_unimarc"
MYSQL_USER="koha_"$INSTANCE
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_"$INSTANCE
# Вибір всіх таблиць в базі даних
TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart $INSTANCE

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

Для більшого контролю над наступними оновленнями Коха можна закоментувати рядок у /etc/apt/sources.list.d/koha.list (і розкоментовувати чи змінювати при ручному оновленні АБІС Koha).

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

Напр.
sudo apt-get install libhttp-tiny-perl

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2025-06-12T13:22:22Z

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

Розглядається встановлення АБІС Koha версії 23.11-25.05 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільні версії, які виходять 2 рази на рік і підтримуються 24-42 місяці (https://wiki.koha-community.org/wiki/Koha_Versioning).

Налаштування ключів:

sudo apt update
sudo apt install sudo apt-transport-https ca-certificates curl gnupg2
sudo mkdir -p --mode=0755 /etc/apt/keyrings
sudo curl -fsSL https://debian.koha-community.org/koha/gpg.asc -o /etc/apt/keyrings/koha.asc

Якщо ви дотримуєтесь певного номера версії Koha, ви залишаєтесь на цій версії Koha, доки не буде змінено вихідні коди пакунків.
Це рекомендується для виробничих середовищ, щоб "випадково" не оновитися до нового великого випуску.

Коли ви запускаєте оновлення, ви оновлюєтесь лише до останнього випуску технічного обслуговування для обраної версії.

Поточні номери версій Koha та їхні кодові назви:

* 25.05 (stable) — поточний стабільний реліз і наступна версія з довготривалою підтримкою (LTS)
* 24.11 (LTS) (oldstable) — на один реліз позаду від поточного стабільного
* 24.05 (oldoldstable) — на два релізи позаду від поточного стабільного
* 23.11 (oldoldoldstable) — версія з довготривалою підтримкою, підтримується приблизно 3 з половиною роки

Щоб оновити список джерел пакетів для використання релізу 25.05:

sudo tee /etc/apt/sources.list.d/koha.sources <<EOF
Types: deb
URIs: https://debian.koha-community.org/koha/
Suites: 25.05
Components: main
Signed-By: /etc/apt/keyrings/koha.asc
EOF

Щоб оновити список джерел пакетів для використання релізу 24.11:

sudo tee /etc/apt/sources.list.d/koha.sources <<EOF
Types: deb
URIs: https://debian.koha-community.org/koha/
Suites: 24.11
Components: main
Signed-By: /etc/apt/keyrings/koha.asc
EOF

Примітка: якщо ви раніше використовували старий формат списку джерел APT, видаліть файл /etc/apt/sources.list.d/koha.list.

Оновлюємо список доступних для встановлення пакунків

sudo apt update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''
* '''Test::PerlTidy'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'

sudo perl -MCPAN -e 'install Test::PerlTidy'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами. Примітка: sudo koha-translate --update uk-UA також генерує yaml-файли (потрібно при встановленні екземплярів Коха).

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
INSTANCE="ukr_unimarc"
MYSQL_USER="koha_"$INSTANCE
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_"$INSTANCE
# Вибір всіх таблиць в базі даних
TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart $INSTANCE

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

Для більшого контролю над наступними оновленнями Коха можна закоментувати рядок у /etc/apt/sources.list.d/koha.list (і розкоментовувати чи змінювати при ручному оновленні АБІС Koha).

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

Напр.
sudo apt-get install libhttp-tiny-perl

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2025-06-12T11:45:37Z

Dubyk: /* Пакунки з CPAN */

Розглядається встановлення АБІС Koha версії 23.11-25.05 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha 25.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha 24.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha 24.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''
* '''Test::PerlTidy'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'

sudo perl -MCPAN -e 'install Test::PerlTidy'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами. Примітка: sudo koha-translate --update uk-UA також генерує yaml-файли (потрібно при встановленні екземплярів Коха).

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
INSTANCE="ukr_unimarc"
MYSQL_USER="koha_"$INSTANCE
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_"$INSTANCE
# Вибір всіх таблиць в базі даних
TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart $INSTANCE

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

Для більшого контролю над наступними оновленнями Коха можна закоментувати рядок у /etc/apt/sources.list.d/koha.list (і розкоментовувати чи змінювати при ручному оновленні АБІС Koha).

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

Напр.
sudo apt-get install libhttp-tiny-perl

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2025-06-12T10:55:10Z

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

Розглядається встановлення АБІС Koha версії 23.11-25.05 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha 25.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha 24.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha 24.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами. Примітка: sudo koha-translate --update uk-UA також генерує yaml-файли (потрібно при встановленні екземплярів Коха).

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
INSTANCE="ukr_unimarc"
MYSQL_USER="koha_"$INSTANCE
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_"$INSTANCE
# Вибір всіх таблиць в базі даних
TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart $INSTANCE

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

Для більшого контролю над наступними оновленнями Коха можна закоментувати рядок у /etc/apt/sources.list.d/koha.list (і розкоментовувати чи змінювати при ручному оновленні АБІС Koha).

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

Напр.
sudo apt-get install libhttp-tiny-perl

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2025-06-12T10:33:55Z

Dubyk: /* Встановлення ОС Debian GNU/Linux 11 Bullseye */

Розглядається встановлення АБІС Koha версії 23.11-25.05 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha 25.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 24.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 24.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами. Примітка: sudo koha-translate --update uk-UA також генерує yaml-файли (потрібно при встановленні екземплярів Коха).

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
INSTANCE="ukr_unimarc"
MYSQL_USER="koha_"$INSTANCE
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_"$INSTANCE
# Вибір всіх таблиць в базі даних
TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart $INSTANCE

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

Для більшого контролю над наступними оновленнями Коха можна закоментувати рядок у /etc/apt/sources.list.d/koha.list (і розкоментовувати чи змінювати при ручному оновленні АБІС Koha).

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

Напр.
sudo apt-get install libhttp-tiny-perl

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2025-06-12T10:31:37Z

Dubyk:

Розглядається встановлення АБІС Koha версії 23.11-25.05 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha 25.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 24.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 24.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами. Примітка: sudo koha-translate --update uk-UA також генерує yaml-файли (потрібно при встановленні екземплярів Коха).

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
INSTANCE="ukr_unimarc"
MYSQL_USER="koha_"$INSTANCE
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_"$INSTANCE
# Вибір всіх таблиць в базі даних
TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart $INSTANCE

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

Для більшого контролю над наступними оновленнями Коха можна закоментувати рядок у /etc/apt/sources.list.d/koha.list (і розкоментовувати чи змінювати при ручному оновленні АБІС Koha).

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

Напр.
sudo apt-get install libhttp-tiny-perl

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2025-06-12T09:05:06Z

Dubyk:

Розглядається встановлення АБІС Koha версії 23.11-25.05 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами. Примітка: sudo koha-translate --update uk-UA також генерує yaml-файли (потрібно при встановленні екземплярів Коха).

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
INSTANCE="ukr_unimarc"
MYSQL_USER="koha_"$INSTANCE
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_"$INSTANCE
# Вибір всіх таблиць в базі даних
TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart $INSTANCE

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

Для більшого контролю над наступними оновленнями Коха можна закоментувати рядок у /etc/apt/sources.list.d/koha.list (і розкоментовувати чи змінювати при ручному оновленні АБІС Koha).

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

Напр.
sudo apt-get install libhttp-tiny-perl

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Головна сторінка

2025-06-12T08:56:22Z

Dubyk:

Вітаємо на українській вікі-сторінці користувачів [[Koha|АБІС Koha]]!

'''Koha''' — автоматизована інтегрована бібліотечна система (АБІС) і насправді є першою вільною АБІС з відкритими джерельними кодами. Розробку АБІС Koha почала у 1999 році Katipo Communications для бібліотечної спілки[http://www.library.org.nz/] Хороунеуа що у Новій Зеландії. Перша інсталяція відбулася у січні 2000 року.
Назва „koha“ означає подарунок, дар мовою Маорі (Нова Зеландія).

Новини та інші не вікі-сторінки розміщуються на веб-сайті [http://koha.org.ua '''koha.org.ua'''] та Facebook-сторінці [https://www.facebook.com/kohaua Koha Ukraine]. Задавайте питання та починайте обговорення у [https://www.facebook.com/groups/608810989304700/ '''Facebook-групі'''] чи [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-групі'''] української спільноти користувачів АБІС Koha.

Українська спільнота користувачів АБІС Koha запрошує на сторінках цієї вікі ділитися досвідом використання ПЗ Koha.

Також не забувайте про офіційну англомовну вікі-сторінку Koha [https://wiki.koha-community.org/ wiki.koha-community.org], там теж багато цікавого.

[[Поширення АБІС Koha в Україні]] (таблиця та мапа).

[[Перелік функціональних можливостей АБІС Koha]].

[[Історія версій АБІС Koha]], примітки про випуски: [https://koha-community.org/koha-25-05-00-released/ Koha 25.05] (англ.), [https://koha-community.org/koha-24-11-00-released/ Koha 24.11] (англ.), [https://koha-community.org/koha-24-05-00-released/ Koha 24.05] (англ.), [https://koha-community.org/koha-23-05-released/ 23.05] (англ.), [https://koha-community.org/koha-22-11-released/ 22.11] (англ.), [https://koha-community.org/koha-22-05-released/ 22.05] (англ.), [https://koha-community.org/koha-21-11-released/ 21.11] (англ.), [https://koha-community.org/koha-21-05-released/ 21.05] (англ.), [https://koha-community.org/koha-20-11-released/ 20.11] (англ.), [[Примітки до випуску Koha 20.05|20.05]] (укр.), [[Примітки до випуску Koha 19.05|19.05]] (укр.), [[Примітки до випуску Koha 18.11|18.11]], [http://koha.org.ua/novini/vyjshla-koha-17-05/ 17.05] (укр.).

[[Демонстраційні сервери АБІС Koha та віртуальні образи]], ukr_unimarc ([http://opac.koha.org.ua/ Е.К.], [http://demo.koha.org.ua Б.І.]).




[[Групи користувачів АБІС Koha у світі]].

[[Сервери Z39.50/SRU в Україні]].

[[Переклад АБІС Koha]].

[[Бібліотечні стандарти]].

[[MARC-інструменти]].

[[Підбірка каталогів на АБІС Koha]].

[[Цитати для Koha]].

[[Виправлення та вдосконалення для АБІС Koha]].

[[Публікації стосовно АБІС Koha]].

[[Короткі нотатки]]

== Інструкції з встановлення ==
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Встановлення Koha з джерела на ОС Debian]]

== Керівництва та документації ==
* [[Вибір сервера для АБІС Koha]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]
* [[Налаштування Koha]]
* [[Налаштування Postfix та Gmail для Koha]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Оновлення Koha, встановленої з джерела, на версію з репозитарію]]
* [[Міграція даних у Koha]]
* [[Сервер Z39.50|Відкриття сервера Z39.50]]
* [[Штрих-кодування]]
* [[Структурований зміст]]
* [[Koha та RFID]]
* [[Помилки у журналах]], причини і виправлення
* Переклади довідки/документації: [[bulkmarcimport.pl]], [[link_bibs_to_authorities.pl]], [[rebuild_nozebra.pl]]
* [[Шаблони ISBD]]

== Редактори ==
* [http://wiki.koha.org.ua/%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87:Dubyk Сергій Дубик], [http://wiki.koha.org.ua/%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87:O.vasylenko Олег Василенко]

== Посилання на інші ресурси ==
* [https://uk.wikipedia.org/wiki/Koha Koha]{{ref-uk}} у Вікіпедії
* [http://docs.linux.org.ua/%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%B8/Koha/ Документація до АБІС Koha вер. 2.2]{{ref-uk}} (застаріло) на проекті української документації '''docs.linux.org.ua'''
* [https://web.archive.org/web/20070528163217/http://www.library.lviv.ua/software/koha/ Перша україномовна сторінка з АБІС Koha]{{ref-uk}} на сайтів ЛННБ ім. В. Стефаника /веб-архів/
* [https://web.archive.org/web/20120306060621/http://libraries.osdn.org.ua/ua/programms/ils/koha/ Розділ Koha]{{ref-uk}} на проекті „Вільне програмне забезпечення для бібліотек“ /веб-архів/
* [http://librarypolice.com/wiki.koha.org/ukrainian.html Україномовний розділ з колишньої wiki.koha.org]{{ref-uk}}
* [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-група української спільноти користувачів АБІС Koha''']
* [https://www.facebook.com/kohaua '''Facebook-сторінка'''] та [https://www.facebook.com/groups/608810989304700/ '''Facebook-група'''] української спільноти користувачів АБІС Koha
* https://unimarc.org.ua

Історія версій АБІС Koha

2025-06-12T08:55:17Z

Dubyk:

В цій історій версій АБІС Koha наведені найбільш видимі зміни. Детальніше дивіться за посиланням до кожної версії.

* '''[https://koha-community.org/koha-25-05-00-released/ Koha 25.05.00]''' (27 травня 2025 року)

* '''[https://koha-community.org/koha-24-11-00-released/ Koha 24.11.00]''' (26 листопада 2024 року)

* '''[https://koha-community.org/koha-24-05-00-released/ Koha 24.05.00]''' (28 травня 2024 року)

* [https://koha-community.org/koha-23-11-01-released/ Koha 23.11.01] (2 січня 2024 року)

* '''[https://koha-community.org/koha-23-11-release/ Koha 23.11]''' (30 листопада 2023 р)

* '''[https://koha-community.org/koha-23-05-release/ Koha 23.05]''' (1 червня 2023 року)

* '''[https://koha-community.org/koha-22-11-released/ Koha 21.11]''' (25 листопада 2022 року)

* '''[https://koha-community.org/koha-22-05-release/ Koha 22.05]''' (28 травня 2022 року)

* [https://koha-community.org/koha-21-11-01-released/ Koha 21.11.01] (22 грудня 2021 року)

* [https://koha-community.org/koha-21-05-08-released/ Koha 21.05.08] (23 грудня 2021 року)

* '''[https://koha-community.org/koha-21-11-released/ Koha 21.11]''' (25 листопада 2021 року)

* '''[https://koha-community.org/koha-21-05-released/ Koha 21.05]''' (28 травня 2021 року)

* [https://koha-community.org/koha-20-11-03-released/ Koha 20.11.03] (24 лютого 2021 року)

* [https://koha-community.org/koha-20-11-02-released/ Koha 20.11.02] (23 січня 2021 року)

* [https://koha-community.org/koha-20-11-01-released/ Koha 20.11.01] (7 січня 2021 року)

* '''[https://koha-community.org/koha-20-11-released/ Koha 20.11]''' (27 листопада 2020 року)

* [https://koha-community.org/koha-20-05-05-release/ Koha 20.05.05] (27 жовтня 2020 року)

* [https://koha-community.org/koha-20-05-01-release/ Koha 20.05.01] (23 червня 2020 року)

* '''[https://koha-community.org/koha-20-05-release/ Koha 20.05]''' (31 травня 2020 року), [[Примітки до випуску Koha 20.05]] (укр.)

* [https://koha-community.org/koha-19-11-06-release/ Koha 19.11.06] (21 травня 2020 року)

* [https://koha-community.org/koha-19-11-05-release/ Koha 19.11.05] (22 квітня 2020 року)

* [https://koha-community.org/koha-19-11-04-release/ Koha 19.11.04] (24 березня 2020 року)

* [https://koha-community.org/koha-19-11-03-release/ Koha 19.11.03] (21 лютого 2020 року)

* [https://koha-community.org/koha-19-11-02-release/ Koha 19.11.02] (22 січня 2020 року)

* [https://koha-community.org/koha-19-11-01-release/ Koha 19.11.01] (23 грудня 2019 року)

* '''[https://koha-community.org/koha-19-11-release/ Koha 19.11]''', [https://fossies.org/diffs/koha/19.05.05_vs_19.11.00/ %] (27 листопада 2019)

* [https://koha-community.org/koha-19-05-04-release/ Koha 19.05.04], [https://fossies.org/diffs/koha/19.05.03_vs_19.05.04/ %] (24 вересня 2019)

* [https://koha-community.org/koha-19-05-03-release/ Koha 19.05.03], [https://fossies.org/diffs/koha/19.05.02_vs_19.05.03/ %] (29 серпня 2019)
- [https://translate.koha-community.org/uk/19.05/ український переклад 71.3%]

* [https://koha-community.org/koha-19-05-02-release/ Koha 19.05.02], [https://fossies.org/diffs/koha/19.05.01_vs_19.05.02/ %] (24 липня 2019)

* [https://koha-community.org/koha-19-05-01-release/ Koha 19.05.01], [https://fossies.org/diffs/koha/19.05.00_vs_19.05.01/ %] (2 липня 2019),
- оновлення безпеки (міжсайтовий скриптинг, XSS)

* [https://koha-community.org/koha-19-05-05-release/ Koha 19.05.00], [https://fossies.org/diffs/koha/18.11.05_vs_19.05.00/ %] (31 травня 2019), [[Примітки до випуску Koha 19.05]] (укр.)
- пропозиції на придбання на e-mail, база знань Mana для обміну звітами та підписками, вдосконалено МАРК-редактор

* [https://koha-community.org/koha-18-11-05-release/ Koha 18.11.05] (3 травня 2019)

* [https://koha-community.org/koha-18-11-04-release/ Koha 18.11.04], [https://fossies.org/diffs/koha/18.11.03_vs_18.11.04/ %] (26 березня 2019)

* [https://koha-community.org/koha-18-11-03-release/ Koha 18.11.03] (23 лютого 2019)

* [https://koha-community.org/koha-18-11-01-release/ Koha 18.11.01] (21 грудня 2018)

* [https://koha-community.org/koha-18-11-release/ Koha 18.11.00], [[Примітки до випуску Koha 18.11]] (укр.)

- ротація бібліотечних фондів

- документація переведена в онлайн

- підтримка каталогу RecordedBooks, обкладинок AdLibris

- нові REST api для відвідувачів та маршрутів

- діаграми у звітах

- підтримка SRU для запозичень авторитетних файлів

- покращення безпеки автентифікації, SQL, XSS

- типові значення для індикаторів

- підтримка множинних форм у перекладах

- отримання згоди на обробку персональних даних (GDPR)

- українською перекладено 58,9% загалом: електронний каталог 100%, інтерфейс бібліотекаря %60,7, параметри 31,1%, Unimarc 100%, Marc21 32,1%

* [https://koha-community.org/koha-18-05-released/ Koha 18.05.00]

- ієрархії бібліотек та підрозділів

- кешування Plack та Memcached визнано стабільними

- краща підтримка Unicode

- інструмент об’єднання записів читачів

- підтримка OAuth2

- імпорт читачів з командного рядка

- змінна MarcFieldDocURL для посилання на МАРК-документацію, напр. MarcFieldDocURL=https://unimarc.org.ua/wiki/index.php/{FIELD}

- структура ACQ для надходжень

- вдосконалення підтримки Elasticsearch

* [https://koha-community.org/koha-17-11-released/ Koha 17.11.00]

- історія пені та платежів

- онлайн-платежі

- підтримка МБА-обмінів

- зведення для читача (його видачі, прострочення, резервування, сплати)

- історія резервувань

- зріс укр.-переклад, оновлено укр.-налаштування

* [https://koha-community.org/koha-17-05-released/ Koha 17.05.00], [http://koha.org.ua/novini/vyjshla-koha-17-05/ Вийшла Koha 17.05](укр.)

- запити на скан/ксерокс статей чи частин книг

- після-інсталяційний покроковий чарівник

- сповіщення різними мовами

- читач може робити примітки до виданих йому книг

- клуби читачів за інтересами

- міжбібліотечна статистика https://hea.koha-community.org/

- зміна поведінки звітів на основі marcxml

* [https://koha-community.org/koha-16-11-released-2/ Koha 16.11.00]

- відправлення постачальникам замовлення по пошті

- модуль прикутих до дому

* [https://koha-community.org/koha-16-05-released/ Koha 16.05.00]

- авторизація Google OAuth2 (OpenID Connect)

- відновлення забутого паролю

* [https://koha-community.org/koha-3-22-released/ Koha 3.22] (листопад 2015)

- додавання файлів до бібліографічних записів (upload.pl)

- пришвидшення Коха (технологія Plack)

- редактор професійного каталогізатора

- sitemap.pl для пошукових рушіїв (Google,...)

* [https://koha-community.org/koha-3-20-0-released/ Koha 3.20] (травень 2015)

- пакетна обробка біб-записів

- імпорт біб-файлів різних форматів через додатки

- підтримка обкладинок через віддалений кеш Coce

* [https://koha-community.org/koha-3-18-0-released/ Koha 3.18] (листопад 2014)

- завантаження сканованих накладних

- підтримка граней (при пошуку)

- пакетне вилучення біб-записів

- почергово переміщувані зібрання

- підтримка запозичень SRU (на додаток до Z39-50), можливість конвертації Marc21-Unimarc на льоту

* [https://koha-community.org/koha-3-16-0-released/ Koha 3.16] (травень 2014)

- індексатор Zebra працює як служба

- надсилання списків ел.поштою

* [https://koha-community.org/koha-3-14-0-released/ Koha 3.14] (листопад 2013)

- нова тема Bootstrap для ЕК (підтримка моб. пристроїв)

- модуль резервування курсів

- модуль офлайнового обігу

- переліки відвідувачів

- правила конвертування при імпорті біб-записів

- імпорт авторит. файлів через Z39-50

- підтримка мікроданих schema.org

* [https://koha-community.org/koha-3-12-0-released/ Koha 3.12] (травень 2013)

- підтримка HTML5 відео/аудіо

- само-реєстрація відвідувачів

- підтримка додатків

- статистика по відвідувачах

* [https://koha-community.org/koha-3-10-0-released/ Koha 3.10] (листопад 2012)

- додаток для інвентарного номера

- ''тихий'' видрук квитанцій

- вікові обмеження

- режим незалежних підрозділів

- скрипт MARC-експорту

- цитати дня

- обкладинки у списках

- пакетне редагування відвідувачів

- додавання PDF-файлів у профіль відвідувача

- ієрархія збережених звітів

- ширше-вужче-пов’язано для тематик, до цього відноситься „Чи ви мали на увазі?“

- підтримка SIP2

- підрозподілені привілеї

- таблиці в Koha

* [https://koha-community.org/koha-3-8-0-released/ Koha 3.8.0] (квітень 2012)

- локальні обладинки

- аналітичні записи

- додаткок для шифру callnumber-KU

- шлюз OCLC Connexion

- пошукові посилання у подробицях запису

- XSLT-таблиці для подробиць запису та результатів пошуку

- зірковий рейтинг в ЕК

- посилання на соц-мережі

- підтримка memcached

* [https://koha-community.org/koha-3-6-0-released/ Koha 3.6.0] (жовтень 2011)

- покращення для підтримки аналітичних записів

* [https://koha-community.org/koha-3-4-0-released/ Koha 3.4.0] (квітень 2011)

* [https://koha-community.org/koha-3-2-0/ Koha 3.2.0] (жовтень 2010)

- ієрархічні кошториси та кошти

- пакетне редагування примірників

- переміщення примірників між записами

- шукати за цим заголовком (у інших ресурсах)

- редаговані SQL-звіти

- OAI-PMH

- пакування для Debian (apt-get install koha)

* [https://koha-community.org/koha-3-0-6-ready-for-download/ Koha 3.0.6] (травень 2010)

* Koha 3.0.0 (серпень 2008)

Див. також тут https://koha-community.org/about/history/

Про історію Koha без сухих цифр і дат читайте тут https://wiki.koha-community.org/wiki/History.

Цікава відео-візуалізація розробки Koha https://www.youtube.com/watch?v=Tl1a2VN_pec&feature=youtu.be

Демонстраційні сервери АБІС Koha та віртуальні образи

2025-03-17T11:18:39Z

Dubyk: /* Демонстраційні сервери */

== Демонстраційні сервери ==

=== Тестовий сервер ТНТУ з АБІС Koha 24.11.02!===

Стан: '''працює'''

Доступні мови інтерфейсу: українська, англійська, польська, ідиш.

Мова SQL-таблиць: українська.

МАРК-формат: '''УКРМАРК/UNIMARC'''[https://unimarc.org.ua].

Для входу використовуйте

логін: librarian

пароль: librarian

Бібліотечний інтерфейс: '''https://demo.koha.org.ua''' (також http://koha.dynu.net)

Електронний каталог: '''https://opac.koha.org.ua'''

Спробуйте пошукати за кл. словами [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=2017 2017], [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=клуб клуб], [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=психо* психологія].

Примітки: український інтерфейс щоденно синхронізується з [https://translate.koha-community.org/projects/koha/24-11/-/uk/ https://translate.koha-community.org/projects/koha/24-11/-/uk/].




=== Див. також ===

* [https://koha-community.org/demo/ Перелік демо-серверів на оф. сторінці АБІС Koha].
* https://wiki.koha-community.org/wiki/Koha_Demo_Installations
* [http://koha.org.pl/demo Демо від польської спільноти АБІС Koha]

== Віртуальні образи ==

1) ЗАСТАРІЛО. Варіант АБІС Koha 16.05.05 для запуску під Virtual Box[https://www.virtualbox.org/wiki/Downloads].

Посилання для звантаження образу: [https://drive.google.com/open?id=0B9yQdtMQotpzZDZEbmhydDhwMTA] (12 Гб).

Операційна система та графічне середовище: GNU Linux Debian 8 Jessie, Gnome.

Доступні мови інтерфейсу: українська, англійська.

Мова SQL-таблиць: українська.

МАРК-формат: УКРМАРК/UNIMARC.

Про решту див. після запуску.

=== Див. також ===
* [https://wiki.koha-community.org/wiki/Koha_Virtual_Appliances Koha Virtual Appliances] (Koha Wiki)
* [https://wiki.koha-community.org/wiki/Sandboxes Sandboxes] (Koha Wiki)

== Koha Live DVD/USB ==

=== Див. також ===
* [https://vimal0212.wordpress.com/koha-live-dvd/ Koha Live DVD] від Vimal Kumar V.
* [https://wiki.koha-community.org/wiki/Koha_LiveCD Koha_Live CD] — про цей ж Koha Live DVD на Koha-вікі
* https://sourceforge.net/projects/kohalivedvd/

==Sandboxes==
=== Див. також ===
* https://wiki.koha-community.org/wiki/Sandboxes

Демонстраційні сервери АБІС Koha та віртуальні образи

2025-03-17T11:17:59Z

Dubyk: /* Демонстраційні сервери */

== Демонстраційні сервери ==

=== Тестовий сервер ТНТУ з АБІС Koha 24.11.02!===

Стан: '''працює'''

Доступні мови інтерфейсу: українська, англійська, польська, ідиш.

Мова SQL-таблиць: українська.

МАРК-формат: '''УКРМАРК/UNIMARC'''[https://unimarc.org.ua].

Для входу використовуйте

логін: librarian

пароль: librarian

Бібліотечний інтерфейс: '''https://demo.koha.org.ua''' (також http://koha.dynu.net)

Електронний каталог: '''https://opac.koha.org.ua'''

Спробуйте пошукати за кл. словами [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=2017 2017], [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=клуб клуб], [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=психо* психологія].

Примітки: український інтерфейс щоденно синхронізується з [https://translate.koha-community.org/uk/24.11/ translate.koha-community.org/uk/24.11].




=== Див. також ===

* [https://koha-community.org/demo/ Перелік демо-серверів на оф. сторінці АБІС Koha].
* https://wiki.koha-community.org/wiki/Koha_Demo_Installations
* [http://koha.org.pl/demo Демо від польської спільноти АБІС Koha]

== Віртуальні образи ==

1) ЗАСТАРІЛО. Варіант АБІС Koha 16.05.05 для запуску під Virtual Box[https://www.virtualbox.org/wiki/Downloads].

Посилання для звантаження образу: [https://drive.google.com/open?id=0B9yQdtMQotpzZDZEbmhydDhwMTA] (12 Гб).

Операційна система та графічне середовище: GNU Linux Debian 8 Jessie, Gnome.

Доступні мови інтерфейсу: українська, англійська.

Мова SQL-таблиць: українська.

МАРК-формат: УКРМАРК/UNIMARC.

Про решту див. після запуску.

=== Див. також ===
* [https://wiki.koha-community.org/wiki/Koha_Virtual_Appliances Koha Virtual Appliances] (Koha Wiki)
* [https://wiki.koha-community.org/wiki/Sandboxes Sandboxes] (Koha Wiki)

== Koha Live DVD/USB ==

=== Див. також ===
* [https://vimal0212.wordpress.com/koha-live-dvd/ Koha Live DVD] від Vimal Kumar V.
* [https://wiki.koha-community.org/wiki/Koha_LiveCD Koha_Live CD] — про цей ж Koha Live DVD на Koha-вікі
* https://sourceforge.net/projects/kohalivedvd/

==Sandboxes==
=== Див. також ===
* https://wiki.koha-community.org/wiki/Sandboxes

Історія версій АБІС Koha

2024-11-29T07:53:33Z

Dubyk:

В цій історій версій АБІС Koha наведені найбільш видимі зміни. Детальніше дивіться за посиланням до кожної версії.

* '''[https://koha-community.org/koha-24-11-00-released/ Koha 24.11.00]''' (26 листопада 2024 року)

* '''[https://koha-community.org/koha-24-05-00-released/ Koha 24.05.00]''' (28 травня 2024 року)

* [https://koha-community.org/koha-23-11-01-released/ Koha 23.11.01] (2 січня 2024 року)

* '''[https://koha-community.org/koha-23-11-release/ Koha 23.11]''' (30 листопада 2023 р)

* '''[https://koha-community.org/koha-23-05-release/ Koha 23.05]''' (1 червня 2023 року)

* '''[https://koha-community.org/koha-22-11-released/ Koha 21.11]''' (25 листопада 2022 року)

* '''[https://koha-community.org/koha-22-05-release/ Koha 22.05]''' (28 травня 2022 року)

* [https://koha-community.org/koha-21-11-01-released/ Koha 21.11.01] (22 грудня 2021 року)

* [https://koha-community.org/koha-21-05-08-released/ Koha 21.05.08] (23 грудня 2021 року)

* '''[https://koha-community.org/koha-21-11-released/ Koha 21.11]''' (25 листопада 2021 року)

* '''[https://koha-community.org/koha-21-05-released/ Koha 21.05]''' (28 травня 2021 року)

* [https://koha-community.org/koha-20-11-03-released/ Koha 20.11.03] (24 лютого 2021 року)

* [https://koha-community.org/koha-20-11-02-released/ Koha 20.11.02] (23 січня 2021 року)

* [https://koha-community.org/koha-20-11-01-released/ Koha 20.11.01] (7 січня 2021 року)

* '''[https://koha-community.org/koha-20-11-released/ Koha 20.11]''' (27 листопада 2020 року)

* [https://koha-community.org/koha-20-05-05-release/ Koha 20.05.05] (27 жовтня 2020 року)

* [https://koha-community.org/koha-20-05-01-release/ Koha 20.05.01] (23 червня 2020 року)

* '''[https://koha-community.org/koha-20-05-release/ Koha 20.05]''' (31 травня 2020 року), [[Примітки до випуску Koha 20.05]] (укр.)

* [https://koha-community.org/koha-19-11-06-release/ Koha 19.11.06] (21 травня 2020 року)

* [https://koha-community.org/koha-19-11-05-release/ Koha 19.11.05] (22 квітня 2020 року)

* [https://koha-community.org/koha-19-11-04-release/ Koha 19.11.04] (24 березня 2020 року)

* [https://koha-community.org/koha-19-11-03-release/ Koha 19.11.03] (21 лютого 2020 року)

* [https://koha-community.org/koha-19-11-02-release/ Koha 19.11.02] (22 січня 2020 року)

* [https://koha-community.org/koha-19-11-01-release/ Koha 19.11.01] (23 грудня 2019 року)

* '''[https://koha-community.org/koha-19-11-release/ Koha 19.11]''', [https://fossies.org/diffs/koha/19.05.05_vs_19.11.00/ %] (27 листопада 2019)

* [https://koha-community.org/koha-19-05-04-release/ Koha 19.05.04], [https://fossies.org/diffs/koha/19.05.03_vs_19.05.04/ %] (24 вересня 2019)

* [https://koha-community.org/koha-19-05-03-release/ Koha 19.05.03], [https://fossies.org/diffs/koha/19.05.02_vs_19.05.03/ %] (29 серпня 2019)
- [https://translate.koha-community.org/uk/19.05/ український переклад 71.3%]

* [https://koha-community.org/koha-19-05-02-release/ Koha 19.05.02], [https://fossies.org/diffs/koha/19.05.01_vs_19.05.02/ %] (24 липня 2019)

* [https://koha-community.org/koha-19-05-01-release/ Koha 19.05.01], [https://fossies.org/diffs/koha/19.05.00_vs_19.05.01/ %] (2 липня 2019),
- оновлення безпеки (міжсайтовий скриптинг, XSS)

* [https://koha-community.org/koha-19-05-05-release/ Koha 19.05.00], [https://fossies.org/diffs/koha/18.11.05_vs_19.05.00/ %] (31 травня 2019), [[Примітки до випуску Koha 19.05]] (укр.)
- пропозиції на придбання на e-mail, база знань Mana для обміну звітами та підписками, вдосконалено МАРК-редактор

* [https://koha-community.org/koha-18-11-05-release/ Koha 18.11.05] (3 травня 2019)

* [https://koha-community.org/koha-18-11-04-release/ Koha 18.11.04], [https://fossies.org/diffs/koha/18.11.03_vs_18.11.04/ %] (26 березня 2019)

* [https://koha-community.org/koha-18-11-03-release/ Koha 18.11.03] (23 лютого 2019)

* [https://koha-community.org/koha-18-11-01-release/ Koha 18.11.01] (21 грудня 2018)

* [https://koha-community.org/koha-18-11-release/ Koha 18.11.00], [[Примітки до випуску Koha 18.11]] (укр.)

- ротація бібліотечних фондів

- документація переведена в онлайн

- підтримка каталогу RecordedBooks, обкладинок AdLibris

- нові REST api для відвідувачів та маршрутів

- діаграми у звітах

- підтримка SRU для запозичень авторитетних файлів

- покращення безпеки автентифікації, SQL, XSS

- типові значення для індикаторів

- підтримка множинних форм у перекладах

- отримання згоди на обробку персональних даних (GDPR)

- українською перекладено 58,9% загалом: електронний каталог 100%, інтерфейс бібліотекаря %60,7, параметри 31,1%, Unimarc 100%, Marc21 32,1%

* [https://koha-community.org/koha-18-05-released/ Koha 18.05.00]

- ієрархії бібліотек та підрозділів

- кешування Plack та Memcached визнано стабільними

- краща підтримка Unicode

- інструмент об’єднання записів читачів

- підтримка OAuth2

- імпорт читачів з командного рядка

- змінна MarcFieldDocURL для посилання на МАРК-документацію, напр. MarcFieldDocURL=https://unimarc.org.ua/wiki/index.php/{FIELD}

- структура ACQ для надходжень

- вдосконалення підтримки Elasticsearch

* [https://koha-community.org/koha-17-11-released/ Koha 17.11.00]

- історія пені та платежів

- онлайн-платежі

- підтримка МБА-обмінів

- зведення для читача (його видачі, прострочення, резервування, сплати)

- історія резервувань

- зріс укр.-переклад, оновлено укр.-налаштування

* [https://koha-community.org/koha-17-05-released/ Koha 17.05.00], [http://koha.org.ua/novini/vyjshla-koha-17-05/ Вийшла Koha 17.05](укр.)

- запити на скан/ксерокс статей чи частин книг

- після-інсталяційний покроковий чарівник

- сповіщення різними мовами

- читач може робити примітки до виданих йому книг

- клуби читачів за інтересами

- міжбібліотечна статистика https://hea.koha-community.org/

- зміна поведінки звітів на основі marcxml

* [https://koha-community.org/koha-16-11-released-2/ Koha 16.11.00]

- відправлення постачальникам замовлення по пошті

- модуль прикутих до дому

* [https://koha-community.org/koha-16-05-released/ Koha 16.05.00]

- авторизація Google OAuth2 (OpenID Connect)

- відновлення забутого паролю

* [https://koha-community.org/koha-3-22-released/ Koha 3.22] (листопад 2015)

- додавання файлів до бібліографічних записів (upload.pl)

- пришвидшення Коха (технологія Plack)

- редактор професійного каталогізатора

- sitemap.pl для пошукових рушіїв (Google,...)

* [https://koha-community.org/koha-3-20-0-released/ Koha 3.20] (травень 2015)

- пакетна обробка біб-записів

- імпорт біб-файлів різних форматів через додатки

- підтримка обкладинок через віддалений кеш Coce

* [https://koha-community.org/koha-3-18-0-released/ Koha 3.18] (листопад 2014)

- завантаження сканованих накладних

- підтримка граней (при пошуку)

- пакетне вилучення біб-записів

- почергово переміщувані зібрання

- підтримка запозичень SRU (на додаток до Z39-50), можливість конвертації Marc21-Unimarc на льоту

* [https://koha-community.org/koha-3-16-0-released/ Koha 3.16] (травень 2014)

- індексатор Zebra працює як служба

- надсилання списків ел.поштою

* [https://koha-community.org/koha-3-14-0-released/ Koha 3.14] (листопад 2013)

- нова тема Bootstrap для ЕК (підтримка моб. пристроїв)

- модуль резервування курсів

- модуль офлайнового обігу

- переліки відвідувачів

- правила конвертування при імпорті біб-записів

- імпорт авторит. файлів через Z39-50

- підтримка мікроданих schema.org

* [https://koha-community.org/koha-3-12-0-released/ Koha 3.12] (травень 2013)

- підтримка HTML5 відео/аудіо

- само-реєстрація відвідувачів

- підтримка додатків

- статистика по відвідувачах

* [https://koha-community.org/koha-3-10-0-released/ Koha 3.10] (листопад 2012)

- додаток для інвентарного номера

- ''тихий'' видрук квитанцій

- вікові обмеження

- режим незалежних підрозділів

- скрипт MARC-експорту

- цитати дня

- обкладинки у списках

- пакетне редагування відвідувачів

- додавання PDF-файлів у профіль відвідувача

- ієрархія збережених звітів

- ширше-вужче-пов’язано для тематик, до цього відноситься „Чи ви мали на увазі?“

- підтримка SIP2

- підрозподілені привілеї

- таблиці в Koha

* [https://koha-community.org/koha-3-8-0-released/ Koha 3.8.0] (квітень 2012)

- локальні обладинки

- аналітичні записи

- додаткок для шифру callnumber-KU

- шлюз OCLC Connexion

- пошукові посилання у подробицях запису

- XSLT-таблиці для подробиць запису та результатів пошуку

- зірковий рейтинг в ЕК

- посилання на соц-мережі

- підтримка memcached

* [https://koha-community.org/koha-3-6-0-released/ Koha 3.6.0] (жовтень 2011)

- покращення для підтримки аналітичних записів

* [https://koha-community.org/koha-3-4-0-released/ Koha 3.4.0] (квітень 2011)

* [https://koha-community.org/koha-3-2-0/ Koha 3.2.0] (жовтень 2010)

- ієрархічні кошториси та кошти

- пакетне редагування примірників

- переміщення примірників між записами

- шукати за цим заголовком (у інших ресурсах)

- редаговані SQL-звіти

- OAI-PMH

- пакування для Debian (apt-get install koha)

* [https://koha-community.org/koha-3-0-6-ready-for-download/ Koha 3.0.6] (травень 2010)

* Koha 3.0.0 (серпень 2008)

Див. також тут https://koha-community.org/about/history/

Про історію Koha без сухих цифр і дат читайте тут https://wiki.koha-community.org/wiki/History.

Цікава відео-візуалізація розробки Koha https://www.youtube.com/watch?v=Tl1a2VN_pec&feature=youtu.be

Головна сторінка

2024-11-29T07:52:16Z

Dubyk:

Вітаємо на українській вікі-сторінці користувачів [[Koha|АБІС Koha]]!

'''Koha''' — автоматизована інтегрована бібліотечна система (АБІС) і насправді є першою вільною АБІС з відкритими джерельними кодами. Розробку АБІС Koha почала у 1999 році Katipo Communications для бібліотечної спілки[http://www.library.org.nz/] Хороунеуа що у Новій Зеландії. Перша інсталяція відбулася у січні 2000 року.
Назва „koha“ означає подарунок, дар мовою Маорі (Нова Зеландія).

Новини та інші не вікі-сторінки розміщуються на веб-сайті [http://koha.org.ua '''koha.org.ua'''] та Facebook-сторінці [https://www.facebook.com/kohaua Koha Ukraine]. Задавайте питання та починайте обговорення у [https://www.facebook.com/groups/608810989304700/ '''Facebook-групі'''] чи [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-групі'''] української спільноти користувачів АБІС Koha.

Українська спільнота користувачів АБІС Koha запрошує на сторінках цієї вікі ділитися досвідом використання ПЗ Koha.

Також не забувайте про офіційну англомовну вікі-сторінку Koha [https://wiki.koha-community.org/ wiki.koha-community.org], там теж багато цікавого.

[[Поширення АБІС Koha в Україні]] (таблиця та мапа).

[[Перелік функціональних можливостей АБІС Koha]].

[[Історія версій АБІС Koha]], примітки про випуски: [https://koha-community.org/koha-24-11-00-released/ Koha 24.11] (англ.), [https://koha-community.org/koha-24-05-00-released/ Koha 24.05] (англ.), [https://koha-community.org/koha-23-05-released/ 23.05] (англ.), [https://koha-community.org/koha-22-11-released/ 22.11] (англ.), [https://koha-community.org/koha-22-05-released/ 22.05] (англ.), [https://koha-community.org/koha-21-11-released/ 21.11] (англ.), [https://koha-community.org/koha-21-05-released/ 21.05] (англ.), [https://koha-community.org/koha-20-11-released/ 20.11] (англ.), [[Примітки до випуску Koha 20.05|20.05]] (укр.), [[Примітки до випуску Koha 19.05|19.05]] (укр.), [[Примітки до випуску Koha 18.11|18.11]], [http://koha.org.ua/novini/vyjshla-koha-17-05/ 17.05] (укр.).

[[Демонстраційні сервери АБІС Koha та віртуальні образи]], ukr_unimarc ([http://opac.koha.org.ua/ Е.К.], [http://demo.koha.org.ua Б.І.]).




[[Групи користувачів АБІС Koha у світі]].

[[Сервери Z39.50/SRU в Україні]].

[[Переклад АБІС Koha]].

[[Бібліотечні стандарти]].

[[MARC-інструменти]].

[[Підбірка каталогів на АБІС Koha]].

[[Цитати для Koha]].

[[Виправлення та вдосконалення для АБІС Koha]].

[[Публікації стосовно АБІС Koha]].

[[Короткі нотатки]]

== Інструкції з встановлення ==
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Встановлення Koha з джерела на ОС Debian]]

== Керівництва та документації ==
* [[Вибір сервера для АБІС Koha]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]
* [[Налаштування Koha]]
* [[Налаштування Postfix та Gmail для Koha]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Оновлення Koha, встановленої з джерела, на версію з репозитарію]]
* [[Міграція даних у Koha]]
* [[Сервер Z39.50|Відкриття сервера Z39.50]]
* [[Штрих-кодування]]
* [[Структурований зміст]]
* [[Koha та RFID]]
* [[Помилки у журналах]], причини і виправлення
* Переклади довідки/документації: [[bulkmarcimport.pl]], [[link_bibs_to_authorities.pl]], [[rebuild_nozebra.pl]]
* [[Шаблони ISBD]]

== Редактори ==
* [http://wiki.koha.org.ua/%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87:Dubyk Сергій Дубик], [http://wiki.koha.org.ua/%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87:O.vasylenko Олег Василенко]

== Посилання на інші ресурси ==
* [https://uk.wikipedia.org/wiki/Koha Koha]{{ref-uk}} у Вікіпедії
* [http://docs.linux.org.ua/%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%B8/Koha/ Документація до АБІС Koha вер. 2.2]{{ref-uk}} (застаріло) на проекті української документації '''docs.linux.org.ua'''
* [https://web.archive.org/web/20070528163217/http://www.library.lviv.ua/software/koha/ Перша україномовна сторінка з АБІС Koha]{{ref-uk}} на сайтів ЛННБ ім. В. Стефаника /веб-архів/
* [https://web.archive.org/web/20120306060621/http://libraries.osdn.org.ua/ua/programms/ils/koha/ Розділ Koha]{{ref-uk}} на проекті „Вільне програмне забезпечення для бібліотек“ /веб-архів/
* [http://librarypolice.com/wiki.koha.org/ukrainian.html Україномовний розділ з колишньої wiki.koha.org]{{ref-uk}}
* [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-група української спільноти користувачів АБІС Koha''']
* [https://www.facebook.com/kohaua '''Facebook-сторінка'''] та [https://www.facebook.com/groups/608810989304700/ '''Facebook-група'''] української спільноти користувачів АБІС Koha
* https://unimarc.org.ua

Переклад АБІС Koha

2024-10-22T09:24:08Z

Dubyk: /* Переклади, пов’язані з MARC-стандартами */

== Переклад інтерфейсу ==
=== Загальні зауваження ===
Переклад й локалізація АБІС Koha — непросте завдання.

Намагайтеся дотримуватися узгодженості термінів при перекладі, користуйтеся глосарієм й поповнюйте його.

Досить часто переклад однієї й тієї ж фрази використовуються на декількох сторінках АБІС Koha. Бажано використати варіант перекладу, що підходитиме до усіх цих сторінок.

Не перекладайте наосліп! Переклад рядків з файлів перекладу без бачення як реально вони використовуються в АБІС Koha дає погані результати.
Краще шукати неперекладені місця в інтерфейсі й перекладати їх в найбільш зрозумілий варіант (часто це не буде прямим перекладом).
При перекладі зручно користуватися [[Демонстраційні сервери АБІС Koha та віртуальні образи|нашими демо-серверами]] — там актуальна версія АБІС Koha та локалізація українською оновлюється щоденно (вночі) з сервера перекладів http://translate.koha-community.org.

Також добре перекладати посторінково. При цьому легше встановлюється контекст і простіше підібрати найбільш відповідний варіант перекладу. Користуйтеся при цьому [http://koha.tntu.edu.ua:8008/translate/ сервісом таблиць перекладів].

=== Офіційний сайт перекладу ===
Сайт, на якому ведеться переклад інтерфейсу та документації АБІС Koha:

http://translate.koha-community.org/

Зареєструвавшись на сайті можна подавати пропозиції на переклад, перекладати, модерувати та звантажувати актуальні файли перекладів.

==== Версії ====

На сайті перекладів доступні для перекладу наступні версії: [http://translate.koha-community.org/projects/18.05/ 18.05], 17.11, 17.05, 16.11, 16.05, 3.20, 3.22 та застарілі 3.10, 3.12, 3.14, 3.16, 3.18, 3.2, 3.4, 3.6, 3.8.

Переклади, виконані до підтримуваних версій будуть внесені в пакунок при виході цієї версії і, відповідно проявляться при оновленні.

Бажано перекладати останню доступну версію АБІС Koha.

Однак, буває (2 рази на рік), що проект з перекладу вже створений, а відповідна йому версія Koha ще не вийшла. Це робиться з метою, щоб перекладачі мали змогу перекласти нові рядки майбутнього випуску Koha. Тут або встановлювати й оновлювати Koha з GIT (і перекладати лише розроблювану майбутню версію) або вести переклад зразу двох версій (останньої та майбутньої).

==== Файли ====

uk-UA-opac-bootstrap.po — рядки інтерфейсу для читачів, електронного каталогу.

uk-UA-staff-prog.po — рядки інтерфейсу для бібліотекарів.

uk-UA-staff-help.po — рядки вбудованої довідки в інтерфейсі для бібліотекарів.

uk-UA-pref.po — рядки опису усіх системних налаштувань АБІС Koha в інтерфейсі для бібліотекарів.

uk-UA-marc-UNIMARC.po — рядки, пов’язані з інтеграцією UNIMARC в АБІС Koha (сюди не входять описи полів/підполів UNIMARC, див. SQL-таблиці).

uk-UA-marc-MARC21.po — рядки, пов’язані з інтеграцією MARC21 в АБІС Koha (сюди не входять описи полів/підполів MARC21, див. SQL-таблиці).

uk-UA-marc-NORMARC.po — рядки, пов’язані з інтеграцією норвезького NORMARC в АБІС Koha.

==== Глосарій ====
Для узгодженості й полегшенню перекладів АБІС Koha, перекладачі створюють глосарії
http://translate.koha-community.org/projects/terminology/

Український глосарій тут
http://translate.koha-community.org/uk/terminology/

=== Задіювання перекладу ===

Звантаження файлів перекладів (для версії 17.05.x) на локальному сервері та оновлення українського шаблонів інтерфейсу:

sudo wget http://translate.koha-community.org/download/uk/17.05/uk-UA-opac-bootstrap.po -O /usr/share/koha/misc/translator/po/uk-UA-opac-bootstrap.po;
sudo wget http://translate.koha-community.org/download/uk/17.05/uk-UA-staff-prog.po -O /usr/share/koha/misc/translator/po/uk-UA-staff-prog.po;
sudo wget http://translate.koha-community.org/download/uk/17.05/uk-UA-pref.po -O /usr/share/koha/misc/translator/po/uk-UA-pref.po;
sudo wget http://translate.koha-community.org/download/uk/17.05/uk-UA-staff-help.po -O /usr/share/koha/misc/translator/po/uk-UA-staff-help.po;
sudo wget http://translate.koha-community.org/download/uk/17.05/uk-UA-marc-UNIMARC.po -O /usr/share/koha/misc/translator/po/uk-UA-marc-UNIMARC.po;
sudo wget http://translate.koha-community.org/download/uk/17.05/uk-UA-marc-MARC21.po -O /usr/share/koha/misc/translator/po/uk-UA-marc-MARC21.po;
sudo wget http://translate.koha-community.org/download/uk/17.05/uk-UA-marc-NORMARC.po -O /usr/share/koha/misc/translator/po/uk-UA-marc-NORMARC.po;
sudo koha-translate --install uk-UA;
sudo koha-translate --update uk-UA

=== Табличний посторінковий засіб перекладу ===
http://koha.tntu.edu.ua:8008/translate/

Сторінки шаблонів з перекладами перегенеровуються щоденно (вночі).

== Локалізація SQL-таблиць ==
Актуальні локалізовані SQL-таблиці (у DrobBox Сергія Дубика) українською знаходяться за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Звантажуємо звідси найновішу версію теки uk-UA та замінюємо нею відповідну теку у /usr/share/koha/intranet/cgi-bin/installer/data/mysql.



== Шаблони ISBD ==

Див. [[Шаблони ISBD]].

== Переклад документації ==
На сайті перекладів також ведеться переклад документації для версій Koha [http://translate.koha-community.org/projects/man18.11/ 18.11], [http://translate.koha-community.org/projects/man18.05/ 18.05], [http://translate.koha-community.org/projects/man17.05/ 17.05], [http://translate.koha-community.org/projects/man17.11/ 17.11].

Збірки документації в HTML та PDF форматах тут: http://translate.koha-community.org/manual/

Актуальна англійська версія документації: http://translate.koha-community.org/manual/master/en/html/index.html

Залучайтеся до українського перекладу документації!

== Див. також ==
* https://perldoc.koha-community.org/misc/translator/tmpl_process3.html

Головна сторінка

2024-10-22T09:22:49Z

Dubyk: /* Редактори */

Вітаємо на українській вікі-сторінці користувачів [[Koha|АБІС Koha]]!

'''Koha''' — автоматизована інтегрована бібліотечна система (АБІС) і насправді є першою вільною АБІС з відкритими джерельними кодами. Розробку АБІС Koha почала у 1999 році Katipo Communications для бібліотечної спілки[http://www.library.org.nz/] Хороунеуа що у Новій Зеландії. Перша інсталяція відбулася у січні 2000 року.
Назва „koha“ означає подарунок, дар мовою Маорі (Нова Зеландія).

Новини та інші не вікі-сторінки розміщуються на веб-сайті [http://koha.org.ua '''koha.org.ua'''] та Facebook-сторінці [https://www.facebook.com/kohaua Koha Ukraine]. Задавайте питання та починайте обговорення у [https://www.facebook.com/groups/608810989304700/ '''Facebook-групі'''] чи [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-групі'''] української спільноти користувачів АБІС Koha.

Українська спільнота користувачів АБІС Koha запрошує на сторінках цієї вікі ділитися досвідом використання ПЗ Koha.

Також не забувайте про офіційну англомовну вікі-сторінку Koha [https://wiki.koha-community.org/ wiki.koha-community.org], там теж багато цікавого.

[[Поширення АБІС Koha в Україні]] (таблиця та мапа).

[[Перелік функціональних можливостей АБІС Koha]].

[[Історія версій АБІС Koha]], примітки про випуски: [https://koha-community.org/koha-24-05-00-released/ Koha 24.05] (англ.), [https://koha-community.org/koha-23-05-released/ 23.05] (англ.), [https://koha-community.org/koha-22-11-released/ 22.11] (англ.), [https://koha-community.org/koha-22-05-released/ 22.05] (англ.), [https://koha-community.org/koha-21-11-released/ 21.11] (англ.), [https://koha-community.org/koha-21-05-released/ 21.05] (англ.), [https://koha-community.org/koha-20-11-released/ 20.11] (англ.), [[Примітки до випуску Koha 20.05|20.05]] (укр.), [[Примітки до випуску Koha 19.05|19.05]] (укр.), [[Примітки до випуску Koha 18.11|18.11]], [http://koha.org.ua/novini/vyjshla-koha-17-05/ 17.05] (укр.).

[[Демонстраційні сервери АБІС Koha та віртуальні образи]], ukr_unimarc ([http://opac.koha.org.ua/ Е.К.], [http://demo.koha.org.ua Б.І.]).




[[Групи користувачів АБІС Koha у світі]].

[[Сервери Z39.50/SRU в Україні]].

[[Переклад АБІС Koha]].

[[Бібліотечні стандарти]].

[[MARC-інструменти]].

[[Підбірка каталогів на АБІС Koha]].

[[Цитати для Koha]].

[[Виправлення та вдосконалення для АБІС Koha]].

[[Публікації стосовно АБІС Koha]].

[[Короткі нотатки]]

== Інструкції з встановлення ==
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Встановлення Koha з джерела на ОС Debian]]

== Керівництва та документації ==
* [[Вибір сервера для АБІС Koha]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]
* [[Налаштування Koha]]
* [[Налаштування Postfix та Gmail для Koha]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Оновлення Koha, встановленої з джерела, на версію з репозитарію]]
* [[Міграція даних у Koha]]
* [[Сервер Z39.50|Відкриття сервера Z39.50]]
* [[Штрих-кодування]]
* [[Структурований зміст]]
* [[Koha та RFID]]
* [[Помилки у журналах]], причини і виправлення
* Переклади довідки/документації: [[bulkmarcimport.pl]], [[link_bibs_to_authorities.pl]], [[rebuild_nozebra.pl]]
* [[Шаблони ISBD]]

== Редактори ==
* [http://wiki.koha.org.ua/%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87:Dubyk Сергій Дубик], [http://wiki.koha.org.ua/%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87:O.vasylenko Олег Василенко]

== Посилання на інші ресурси ==
* [https://uk.wikipedia.org/wiki/Koha Koha]{{ref-uk}} у Вікіпедії
* [http://docs.linux.org.ua/%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%B8/Koha/ Документація до АБІС Koha вер. 2.2]{{ref-uk}} (застаріло) на проекті української документації '''docs.linux.org.ua'''
* [https://web.archive.org/web/20070528163217/http://www.library.lviv.ua/software/koha/ Перша україномовна сторінка з АБІС Koha]{{ref-uk}} на сайтів ЛННБ ім. В. Стефаника /веб-архів/
* [https://web.archive.org/web/20120306060621/http://libraries.osdn.org.ua/ua/programms/ils/koha/ Розділ Koha]{{ref-uk}} на проекті „Вільне програмне забезпечення для бібліотек“ /веб-архів/
* [http://librarypolice.com/wiki.koha.org/ukrainian.html Україномовний розділ з колишньої wiki.koha.org]{{ref-uk}}
* [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-група української спільноти користувачів АБІС Koha''']
* [https://www.facebook.com/kohaua '''Facebook-сторінка'''] та [https://www.facebook.com/groups/608810989304700/ '''Facebook-група'''] української спільноти користувачів АБІС Koha
* https://unimarc.org.ua

Головна сторінка

2024-10-22T09:22:22Z

Dubyk: /* Редактори */

Вітаємо на українській вікі-сторінці користувачів [[Koha|АБІС Koha]]!

'''Koha''' — автоматизована інтегрована бібліотечна система (АБІС) і насправді є першою вільною АБІС з відкритими джерельними кодами. Розробку АБІС Koha почала у 1999 році Katipo Communications для бібліотечної спілки[http://www.library.org.nz/] Хороунеуа що у Новій Зеландії. Перша інсталяція відбулася у січні 2000 року.
Назва „koha“ означає подарунок, дар мовою Маорі (Нова Зеландія).

Новини та інші не вікі-сторінки розміщуються на веб-сайті [http://koha.org.ua '''koha.org.ua'''] та Facebook-сторінці [https://www.facebook.com/kohaua Koha Ukraine]. Задавайте питання та починайте обговорення у [https://www.facebook.com/groups/608810989304700/ '''Facebook-групі'''] чи [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-групі'''] української спільноти користувачів АБІС Koha.

Українська спільнота користувачів АБІС Koha запрошує на сторінках цієї вікі ділитися досвідом використання ПЗ Koha.

Також не забувайте про офіційну англомовну вікі-сторінку Koha [https://wiki.koha-community.org/ wiki.koha-community.org], там теж багато цікавого.

[[Поширення АБІС Koha в Україні]] (таблиця та мапа).

[[Перелік функціональних можливостей АБІС Koha]].

[[Історія версій АБІС Koha]], примітки про випуски: [https://koha-community.org/koha-24-05-00-released/ Koha 24.05] (англ.), [https://koha-community.org/koha-23-05-released/ 23.05] (англ.), [https://koha-community.org/koha-22-11-released/ 22.11] (англ.), [https://koha-community.org/koha-22-05-released/ 22.05] (англ.), [https://koha-community.org/koha-21-11-released/ 21.11] (англ.), [https://koha-community.org/koha-21-05-released/ 21.05] (англ.), [https://koha-community.org/koha-20-11-released/ 20.11] (англ.), [[Примітки до випуску Koha 20.05|20.05]] (укр.), [[Примітки до випуску Koha 19.05|19.05]] (укр.), [[Примітки до випуску Koha 18.11|18.11]], [http://koha.org.ua/novini/vyjshla-koha-17-05/ 17.05] (укр.).

[[Демонстраційні сервери АБІС Koha та віртуальні образи]], ukr_unimarc ([http://opac.koha.org.ua/ Е.К.], [http://demo.koha.org.ua Б.І.]).




[[Групи користувачів АБІС Koha у світі]].

[[Сервери Z39.50/SRU в Україні]].

[[Переклад АБІС Koha]].

[[Бібліотечні стандарти]].

[[MARC-інструменти]].

[[Підбірка каталогів на АБІС Koha]].

[[Цитати для Koha]].

[[Виправлення та вдосконалення для АБІС Koha]].

[[Публікації стосовно АБІС Koha]].

[[Короткі нотатки]]

== Інструкції з встановлення ==
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Встановлення Koha з джерела на ОС Debian]]

== Керівництва та документації ==
* [[Вибір сервера для АБІС Koha]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]
* [[Налаштування Koha]]
* [[Налаштування Postfix та Gmail для Koha]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Оновлення Koha, встановленої з джерела, на версію з репозитарію]]
* [[Міграція даних у Koha]]
* [[Сервер Z39.50|Відкриття сервера Z39.50]]
* [[Штрих-кодування]]
* [[Структурований зміст]]
* [[Koha та RFID]]
* [[Помилки у журналах]], причини і виправлення
* Переклади довідки/документації: [[bulkmarcimport.pl]], [[link_bibs_to_authorities.pl]], [[rebuild_nozebra.pl]]
* [[Шаблони ISBD]]

== Редактори ==
* [Сергій Дубик|http://wiki.koha.org.ua/%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87:Dubyk], [Олег Василенко|http://wiki.koha.org.ua/%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87:O.vasylenko]

== Посилання на інші ресурси ==
* [https://uk.wikipedia.org/wiki/Koha Koha]{{ref-uk}} у Вікіпедії
* [http://docs.linux.org.ua/%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%B8/Koha/ Документація до АБІС Koha вер. 2.2]{{ref-uk}} (застаріло) на проекті української документації '''docs.linux.org.ua'''
* [https://web.archive.org/web/20070528163217/http://www.library.lviv.ua/software/koha/ Перша україномовна сторінка з АБІС Koha]{{ref-uk}} на сайтів ЛННБ ім. В. Стефаника /веб-архів/
* [https://web.archive.org/web/20120306060621/http://libraries.osdn.org.ua/ua/programms/ils/koha/ Розділ Koha]{{ref-uk}} на проекті „Вільне програмне забезпечення для бібліотек“ /веб-архів/
* [http://librarypolice.com/wiki.koha.org/ukrainian.html Україномовний розділ з колишньої wiki.koha.org]{{ref-uk}}
* [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-група української спільноти користувачів АБІС Koha''']
* [https://www.facebook.com/kohaua '''Facebook-сторінка'''] та [https://www.facebook.com/groups/608810989304700/ '''Facebook-група'''] української спільноти користувачів АБІС Koha
* https://unimarc.org.ua

Головна сторінка

2024-10-22T09:21:59Z

Dubyk: /* Керівництва та документації */

Вітаємо на українській вікі-сторінці користувачів [[Koha|АБІС Koha]]!

'''Koha''' — автоматизована інтегрована бібліотечна система (АБІС) і насправді є першою вільною АБІС з відкритими джерельними кодами. Розробку АБІС Koha почала у 1999 році Katipo Communications для бібліотечної спілки[http://www.library.org.nz/] Хороунеуа що у Новій Зеландії. Перша інсталяція відбулася у січні 2000 року.
Назва „koha“ означає подарунок, дар мовою Маорі (Нова Зеландія).

Новини та інші не вікі-сторінки розміщуються на веб-сайті [http://koha.org.ua '''koha.org.ua'''] та Facebook-сторінці [https://www.facebook.com/kohaua Koha Ukraine]. Задавайте питання та починайте обговорення у [https://www.facebook.com/groups/608810989304700/ '''Facebook-групі'''] чи [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-групі'''] української спільноти користувачів АБІС Koha.

Українська спільнота користувачів АБІС Koha запрошує на сторінках цієї вікі ділитися досвідом використання ПЗ Koha.

Також не забувайте про офіційну англомовну вікі-сторінку Koha [https://wiki.koha-community.org/ wiki.koha-community.org], там теж багато цікавого.

[[Поширення АБІС Koha в Україні]] (таблиця та мапа).

[[Перелік функціональних можливостей АБІС Koha]].

[[Історія версій АБІС Koha]], примітки про випуски: [https://koha-community.org/koha-24-05-00-released/ Koha 24.05] (англ.), [https://koha-community.org/koha-23-05-released/ 23.05] (англ.), [https://koha-community.org/koha-22-11-released/ 22.11] (англ.), [https://koha-community.org/koha-22-05-released/ 22.05] (англ.), [https://koha-community.org/koha-21-11-released/ 21.11] (англ.), [https://koha-community.org/koha-21-05-released/ 21.05] (англ.), [https://koha-community.org/koha-20-11-released/ 20.11] (англ.), [[Примітки до випуску Koha 20.05|20.05]] (укр.), [[Примітки до випуску Koha 19.05|19.05]] (укр.), [[Примітки до випуску Koha 18.11|18.11]], [http://koha.org.ua/novini/vyjshla-koha-17-05/ 17.05] (укр.).

[[Демонстраційні сервери АБІС Koha та віртуальні образи]], ukr_unimarc ([http://opac.koha.org.ua/ Е.К.], [http://demo.koha.org.ua Б.І.]).




[[Групи користувачів АБІС Koha у світі]].

[[Сервери Z39.50/SRU в Україні]].

[[Переклад АБІС Koha]].

[[Бібліотечні стандарти]].

[[MARC-інструменти]].

[[Підбірка каталогів на АБІС Koha]].

[[Цитати для Koha]].

[[Виправлення та вдосконалення для АБІС Koha]].

[[Публікації стосовно АБІС Koha]].

[[Короткі нотатки]]

== Інструкції з встановлення ==
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Встановлення Koha з джерела на ОС Debian]]

== Керівництва та документації ==
* [[Вибір сервера для АБІС Koha]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]
* [[Налаштування Koha]]
* [[Налаштування Postfix та Gmail для Koha]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Оновлення Koha, встановленої з джерела, на версію з репозитарію]]
* [[Міграція даних у Koha]]
* [[Сервер Z39.50|Відкриття сервера Z39.50]]
* [[Штрих-кодування]]
* [[Структурований зміст]]
* [[Koha та RFID]]
* [[Помилки у журналах]], причини і виправлення
* Переклади довідки/документації: [[bulkmarcimport.pl]], [[link_bibs_to_authorities.pl]], [[rebuild_nozebra.pl]]
* [[Шаблони ISBD]]

== Редактори ==
* [[Сергій Дубик|http://wiki.koha.org.ua/%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87:Dubyk]], [[Олег Василенко|http://wiki.koha.org.ua/%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87:O.vasylenko]]

== Посилання на інші ресурси ==
* [https://uk.wikipedia.org/wiki/Koha Koha]{{ref-uk}} у Вікіпедії
* [http://docs.linux.org.ua/%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%B8/Koha/ Документація до АБІС Koha вер. 2.2]{{ref-uk}} (застаріло) на проекті української документації '''docs.linux.org.ua'''
* [https://web.archive.org/web/20070528163217/http://www.library.lviv.ua/software/koha/ Перша україномовна сторінка з АБІС Koha]{{ref-uk}} на сайтів ЛННБ ім. В. Стефаника /веб-архів/
* [https://web.archive.org/web/20120306060621/http://libraries.osdn.org.ua/ua/programms/ils/koha/ Розділ Koha]{{ref-uk}} на проекті „Вільне програмне забезпечення для бібліотек“ /веб-архів/
* [http://librarypolice.com/wiki.koha.org/ukrainian.html Україномовний розділ з колишньої wiki.koha.org]{{ref-uk}}
* [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-група української спільноти користувачів АБІС Koha''']
* [https://www.facebook.com/kohaua '''Facebook-сторінка'''] та [https://www.facebook.com/groups/608810989304700/ '''Facebook-група'''] української спільноти користувачів АБІС Koha
* https://unimarc.org.ua

Головна сторінка

2024-10-22T09:21:19Z

Dubyk: /* Керівництва та документації */

Вітаємо на українській вікі-сторінці користувачів [[Koha|АБІС Koha]]!

'''Koha''' — автоматизована інтегрована бібліотечна система (АБІС) і насправді є першою вільною АБІС з відкритими джерельними кодами. Розробку АБІС Koha почала у 1999 році Katipo Communications для бібліотечної спілки[http://www.library.org.nz/] Хороунеуа що у Новій Зеландії. Перша інсталяція відбулася у січні 2000 року.
Назва „koha“ означає подарунок, дар мовою Маорі (Нова Зеландія).

Новини та інші не вікі-сторінки розміщуються на веб-сайті [http://koha.org.ua '''koha.org.ua'''] та Facebook-сторінці [https://www.facebook.com/kohaua Koha Ukraine]. Задавайте питання та починайте обговорення у [https://www.facebook.com/groups/608810989304700/ '''Facebook-групі'''] чи [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-групі'''] української спільноти користувачів АБІС Koha.

Українська спільнота користувачів АБІС Koha запрошує на сторінках цієї вікі ділитися досвідом використання ПЗ Koha.

Також не забувайте про офіційну англомовну вікі-сторінку Koha [https://wiki.koha-community.org/ wiki.koha-community.org], там теж багато цікавого.

[[Поширення АБІС Koha в Україні]] (таблиця та мапа).

[[Перелік функціональних можливостей АБІС Koha]].

[[Історія версій АБІС Koha]], примітки про випуски: [https://koha-community.org/koha-24-05-00-released/ Koha 24.05] (англ.), [https://koha-community.org/koha-23-05-released/ 23.05] (англ.), [https://koha-community.org/koha-22-11-released/ 22.11] (англ.), [https://koha-community.org/koha-22-05-released/ 22.05] (англ.), [https://koha-community.org/koha-21-11-released/ 21.11] (англ.), [https://koha-community.org/koha-21-05-released/ 21.05] (англ.), [https://koha-community.org/koha-20-11-released/ 20.11] (англ.), [[Примітки до випуску Koha 20.05|20.05]] (укр.), [[Примітки до випуску Koha 19.05|19.05]] (укр.), [[Примітки до випуску Koha 18.11|18.11]], [http://koha.org.ua/novini/vyjshla-koha-17-05/ 17.05] (укр.).

[[Демонстраційні сервери АБІС Koha та віртуальні образи]], ukr_unimarc ([http://opac.koha.org.ua/ Е.К.], [http://demo.koha.org.ua Б.І.]).




[[Групи користувачів АБІС Koha у світі]].

[[Сервери Z39.50/SRU в Україні]].

[[Переклад АБІС Koha]].

[[Бібліотечні стандарти]].

[[MARC-інструменти]].

[[Підбірка каталогів на АБІС Koha]].

[[Цитати для Koha]].

[[Виправлення та вдосконалення для АБІС Koha]].

[[Публікації стосовно АБІС Koha]].

[[Короткі нотатки]]

== Інструкції з встановлення ==
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Встановлення Koha з джерела на ОС Debian]]

== Керівництва та документації ==
* [[Вибір сервера для АБІС Koha]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]
* [[Налаштування Koha]]
* [[Налаштування Postfix та Gmail для Koha]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Оновлення Koha, встановленої з джерела, на версію з репозитарію]]
* [[Міграція даних у Koha]]
* [[Сервер Z39.50|Відкриття сервера Z39.50]]
* [[Штрих-кодування]]
* [[Структурований зміст]]
* [[Koha та RFID]]
* [[Помилки у журналах]], причини і виправлення
* Переклади довідки/документації: [[bulkmarcimport.pl]], [[link_bibs_to_authorities.pl]], [[rebuild_nozebra.pl]]
* [[Шаблони ISBD]]

--

== Редактори ==
* [[Сергій Дубик|http://wiki.koha.org.ua/%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87:Dubyk]], [[Олег Василенко|http://wiki.koha.org.ua/%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87:O.vasylenko]]

== Посилання на інші ресурси ==
* [https://uk.wikipedia.org/wiki/Koha Koha]{{ref-uk}} у Вікіпедії
* [http://docs.linux.org.ua/%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%B8/Koha/ Документація до АБІС Koha вер. 2.2]{{ref-uk}} (застаріло) на проекті української документації '''docs.linux.org.ua'''
* [https://web.archive.org/web/20070528163217/http://www.library.lviv.ua/software/koha/ Перша україномовна сторінка з АБІС Koha]{{ref-uk}} на сайтів ЛННБ ім. В. Стефаника /веб-архів/
* [https://web.archive.org/web/20120306060621/http://libraries.osdn.org.ua/ua/programms/ils/koha/ Розділ Koha]{{ref-uk}} на проекті „Вільне програмне забезпечення для бібліотек“ /веб-архів/
* [http://librarypolice.com/wiki.koha.org/ukrainian.html Україномовний розділ з колишньої wiki.koha.org]{{ref-uk}}
* [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-група української спільноти користувачів АБІС Koha''']
* [https://www.facebook.com/kohaua '''Facebook-сторінка'''] та [https://www.facebook.com/groups/608810989304700/ '''Facebook-група'''] української спільноти користувачів АБІС Koha
* https://unimarc.org.ua

Головна сторінка

2024-10-22T09:17:56Z

Dubyk: /* Посилання на інші ресурси */

Вітаємо на українській вікі-сторінці користувачів [[Koha|АБІС Koha]]!

'''Koha''' — автоматизована інтегрована бібліотечна система (АБІС) і насправді є першою вільною АБІС з відкритими джерельними кодами. Розробку АБІС Koha почала у 1999 році Katipo Communications для бібліотечної спілки[http://www.library.org.nz/] Хороунеуа що у Новій Зеландії. Перша інсталяція відбулася у січні 2000 року.
Назва „koha“ означає подарунок, дар мовою Маорі (Нова Зеландія).

Новини та інші не вікі-сторінки розміщуються на веб-сайті [http://koha.org.ua '''koha.org.ua'''] та Facebook-сторінці [https://www.facebook.com/kohaua Koha Ukraine]. Задавайте питання та починайте обговорення у [https://www.facebook.com/groups/608810989304700/ '''Facebook-групі'''] чи [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-групі'''] української спільноти користувачів АБІС Koha.

Українська спільнота користувачів АБІС Koha запрошує на сторінках цієї вікі ділитися досвідом використання ПЗ Koha.

Також не забувайте про офіційну англомовну вікі-сторінку Koha [https://wiki.koha-community.org/ wiki.koha-community.org], там теж багато цікавого.

[[Поширення АБІС Koha в Україні]] (таблиця та мапа).

[[Перелік функціональних можливостей АБІС Koha]].

[[Історія версій АБІС Koha]], примітки про випуски: [https://koha-community.org/koha-24-05-00-released/ Koha 24.05] (англ.), [https://koha-community.org/koha-23-05-released/ 23.05] (англ.), [https://koha-community.org/koha-22-11-released/ 22.11] (англ.), [https://koha-community.org/koha-22-05-released/ 22.05] (англ.), [https://koha-community.org/koha-21-11-released/ 21.11] (англ.), [https://koha-community.org/koha-21-05-released/ 21.05] (англ.), [https://koha-community.org/koha-20-11-released/ 20.11] (англ.), [[Примітки до випуску Koha 20.05|20.05]] (укр.), [[Примітки до випуску Koha 19.05|19.05]] (укр.), [[Примітки до випуску Koha 18.11|18.11]], [http://koha.org.ua/novini/vyjshla-koha-17-05/ 17.05] (укр.).

[[Демонстраційні сервери АБІС Koha та віртуальні образи]], ukr_unimarc ([http://opac.koha.org.ua/ Е.К.], [http://demo.koha.org.ua Б.І.]).




[[Групи користувачів АБІС Koha у світі]].

[[Сервери Z39.50/SRU в Україні]].

[[Переклад АБІС Koha]].

[[Бібліотечні стандарти]].

[[MARC-інструменти]].

[[Підбірка каталогів на АБІС Koha]].

[[Цитати для Koha]].

[[Виправлення та вдосконалення для АБІС Koha]].

[[Публікації стосовно АБІС Koha]].

[[Короткі нотатки]]

== Інструкції з встановлення ==
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Встановлення Koha з джерела на ОС Debian]]

== Керівництва та документації ==
* [[Вибір сервера для АБІС Koha]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]
* [[Налаштування Koha]]
* [[Налаштування Postfix та Gmail для Koha]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Оновлення Koha, встановленої з джерела, на версію з репозитарію]]
* [[Міграція даних у Koha]]
* [[Сервер Z39.50|Відкриття сервера Z39.50]]
* [[Штрих-кодування]]
* [[Структурований зміст]]
* [[Koha та RFID]]
* [[Помилки у журналах]], причини і виправлення
* Переклади довідки/документації: [[bulkmarcimport.pl]], [[link_bibs_to_authorities.pl]], [[rebuild_nozebra.pl]]
* [[Шаблони ISBD]]

== Посилання на інші ресурси ==
* [https://uk.wikipedia.org/wiki/Koha Koha]{{ref-uk}} у Вікіпедії
* [http://docs.linux.org.ua/%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%B8/Koha/ Документація до АБІС Koha вер. 2.2]{{ref-uk}} (застаріло) на проекті української документації '''docs.linux.org.ua'''
* [https://web.archive.org/web/20070528163217/http://www.library.lviv.ua/software/koha/ Перша україномовна сторінка з АБІС Koha]{{ref-uk}} на сайтів ЛННБ ім. В. Стефаника /веб-архів/
* [https://web.archive.org/web/20120306060621/http://libraries.osdn.org.ua/ua/programms/ils/koha/ Розділ Koha]{{ref-uk}} на проекті „Вільне програмне забезпечення для бібліотек“ /веб-архів/
* [http://librarypolice.com/wiki.koha.org/ukrainian.html Україномовний розділ з колишньої wiki.koha.org]{{ref-uk}}
* [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-група української спільноти користувачів АБІС Koha''']
* [https://www.facebook.com/kohaua '''Facebook-сторінка'''] та [https://www.facebook.com/groups/608810989304700/ '''Facebook-група'''] української спільноти користувачів АБІС Koha
* https://unimarc.org.ua

Демонстраційні сервери АБІС Koha та віртуальні образи

2024-10-22T09:16:52Z

Dubyk: /* Демонстраційні сервери */

== Демонстраційні сервери ==

=== Тестовий сервер ТНТУ з АБІС Koha 23.05.12!===

Стан: '''працює'''

Доступні мови інтерфейсу: українська, англійська, польська, ідиш.

Мова SQL-таблиць: українська.

МАРК-формат: '''УКРМАРК/UNIMARC'''[https://unimarc.org.ua].

Для входу використовуйте

логін: librarian

пароль: librarian

Бібліотечний інтерфейс: '''https://demo.koha.org.ua''' (також http://koha.dynu.net, http://liblab.tntu.edu.ua:8008)

Електронний каталог: '''https://opac.koha.org.ua''' (також http://koha.dynu.net:7007, http://liblab.tntu.edu.ua:7007)

Спробуйте пошукати за кл. словами [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=2017 2017], [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=клуб клуб], [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=психо* психологія].

Примітки: український інтерфейс щоденно синхронізується з [https://translate.koha-community.org/uk/22.11/ translate.koha-community.org/uk/22.11].




=== Див. також ===

* [https://koha-community.org/demo/ Перелік демо-серверів на оф. сторінці АБІС Koha].
* https://wiki.koha-community.org/wiki/Koha_Demo_Installations
* [http://koha.org.pl/demo Демо від польської спільноти АБІС Koha]

== Віртуальні образи ==

1) ЗАСТАРІЛО. Варіант АБІС Koha 16.05.05 для запуску під Virtual Box[https://www.virtualbox.org/wiki/Downloads].

Посилання для звантаження образу: [https://drive.google.com/open?id=0B9yQdtMQotpzZDZEbmhydDhwMTA] (12 Гб).

Операційна система та графічне середовище: GNU Linux Debian 8 Jessie, Gnome.

Доступні мови інтерфейсу: українська, англійська.

Мова SQL-таблиць: українська.

МАРК-формат: УКРМАРК/UNIMARC.

Про решту див. після запуску.

=== Див. також ===
* [https://wiki.koha-community.org/wiki/Koha_Virtual_Appliances Koha Virtual Appliances] (Koha Wiki)
* [https://wiki.koha-community.org/wiki/Sandboxes Sandboxes] (Koha Wiki)

== Koha Live DVD/USB ==

=== Див. також ===
* [https://vimal0212.wordpress.com/koha-live-dvd/ Koha Live DVD] від Vimal Kumar V.
* [https://wiki.koha-community.org/wiki/Koha_LiveCD Koha_Live CD] — про цей ж Koha Live DVD на Koha-вікі
* https://sourceforge.net/projects/kohalivedvd/

==Sandboxes==
=== Див. також ===
* https://wiki.koha-community.org/wiki/Sandboxes

Демонстраційні сервери АБІС Koha та віртуальні образи

2024-10-22T09:16:12Z

Dubyk: /* Демонстраційні сервери */

== Демонстраційні сервери ==

=== Тестовий сервер ТНТУ з АБІС Koha 23.05.12!===

Стан: '''працює'''

Доступні мови інтерфейсу: українська, англійська.

Мова SQL-таблиць: українська.

МАРК-формат: '''УКРМАРК/UNIMARC'''[https://unimarc.org.ua].

Для входу використовуйте

логін: librarian

пароль: librarian

Бібліотечний інтерфейс: '''https://demo.koha.org.ua''' (також http://koha.dynu.net, http://liblab.tntu.edu.ua:8008)

Електронний каталог: '''https://opac.koha.org.ua''' (також http://koha.dynu.net:7007, http://liblab.tntu.edu.ua:7007)

Спробуйте пошукати за кл. словами [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=2017 2017], [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=клуб клуб], [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=психо* психологія].

Примітки: український інтерфейс щоденно синхронізується з [https://translate.koha-community.org/uk/22.11/ translate.koha-community.org/uk/22.11].




=== Див. також ===

* [https://koha-community.org/demo/ Перелік демо-серверів на оф. сторінці АБІС Koha].
* https://wiki.koha-community.org/wiki/Koha_Demo_Installations
* [http://koha.org.pl/demo Демо від польської спільноти АБІС Koha]

== Віртуальні образи ==

1) ЗАСТАРІЛО. Варіант АБІС Koha 16.05.05 для запуску під Virtual Box[https://www.virtualbox.org/wiki/Downloads].

Посилання для звантаження образу: [https://drive.google.com/open?id=0B9yQdtMQotpzZDZEbmhydDhwMTA] (12 Гб).

Операційна система та графічне середовище: GNU Linux Debian 8 Jessie, Gnome.

Доступні мови інтерфейсу: українська, англійська.

Мова SQL-таблиць: українська.

МАРК-формат: УКРМАРК/UNIMARC.

Про решту див. після запуску.

=== Див. також ===
* [https://wiki.koha-community.org/wiki/Koha_Virtual_Appliances Koha Virtual Appliances] (Koha Wiki)
* [https://wiki.koha-community.org/wiki/Sandboxes Sandboxes] (Koha Wiki)

== Koha Live DVD/USB ==

=== Див. також ===
* [https://vimal0212.wordpress.com/koha-live-dvd/ Koha Live DVD] від Vimal Kumar V.
* [https://wiki.koha-community.org/wiki/Koha_LiveCD Koha_Live CD] — про цей ж Koha Live DVD на Koha-вікі
* https://sourceforge.net/projects/kohalivedvd/

==Sandboxes==
=== Див. також ===
* https://wiki.koha-community.org/wiki/Sandboxes

Встановлення Koha з репозитарію на ОС Debian

2024-07-28T20:17:11Z

Dubyk: /* Процес імпорту даних */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами. Примітка: sudo koha-translate --update uk-UA також генерує yaml-файли (потрібно при встановленні екземплярів Коха).

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
INSTANCE="ukr_unimarc"
MYSQL_USER="koha_"$INSTANCE
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_"$INSTANCE
# Вибір всіх таблиць в базі даних
TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart $INSTANCE

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

Для більшого контролю над наступними оновленнями Коха можна закоментувати рядок у /etc/apt/sources.list.d/koha.list (і розкоментовувати чи змінювати при ручному оновленні АБІС Koha).

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

Напр.
sudo apt-get install libhttp-tiny-perl

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2024-07-28T16:39:52Z

Dubyk: /* Утворення локалізованих шаблонів */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами. Примітка: sudo koha-translate --update uk-UA також генерує yaml-файли (потрібно при встановленні екземплярів Коха).

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
MYSQL_USER="koha_ukr_unimarc"
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_ukr_unimarc"
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart ukr_unimarc

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

Для більшого контролю над наступними оновленнями Коха можна закоментувати рядок у /etc/apt/sources.list.d/koha.list (і розкоментовувати чи змінювати при ручному оновленні АБІС Koha).

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

Напр.
sudo apt-get install libhttp-tiny-perl

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2024-07-22T05:52:10Z

Dubyk: /* Пакунки з репозитарію Debian */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами.

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
MYSQL_USER="koha_ukr_unimarc"
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_ukr_unimarc"
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart ukr_unimarc

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

Для більшого контролю над наступними оновленнями Коха можна закоментувати рядок у /etc/apt/sources.list.d/koha.list (і розкоментовувати чи змінювати при ручному оновленні АБІС Koha).

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

Напр.
sudo apt-get install libhttp-tiny-perl

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2024-07-22T04:57:04Z

Dubyk: /* Оновлення Koha */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами.

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
MYSQL_USER="koha_ukr_unimarc"
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_ukr_unimarc"
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart ukr_unimarc

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

Для більшого контролю над наступними оновленнями Коха можна закоментувати рядок у /etc/apt/sources.list.d/koha.list (і розкоментовувати чи змінювати при ручному оновленні АБІС Koha).

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2024-07-22T04:29:07Z

Dubyk: /* Оновлення Koha */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами.

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
MYSQL_USER="koha_ukr_unimarc"
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_ukr_unimarc"
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart ukr_unimarc

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2024-07-22T04:25:36Z

Dubyk: /* Оновлення Koha */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами.

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
MYSQL_USER="koha_ukr_unimarc"
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_ukr_unimarc"
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart ukr_unimarc

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

Більш стабільними є версії Коха, що пройшли декілька коригувальних оновлень.

Можна оновлювати Коху до версії з певної стабільної гілки. Напр., якщо потрібно оновити Коха до найновішої коригувальної версії у гілці 23.05, то у файлі /etc/apt/sources.list.d/koha.list
має бути наступне

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Головна сторінка

2024-07-16T12:05:12Z

Dubyk:

Вітаємо на українській вікі-сторінці користувачів [[Koha|АБІС Koha]]!

'''Koha''' — автоматизована інтегрована бібліотечна система (АБІС) і насправді є першою вільною АБІС з відкритими джерельними кодами. Розробку АБІС Koha почала у 1999 році Katipo Communications для бібліотечної спілки[http://www.library.org.nz/] Хороунеуа що у Новій Зеландії. Перша інсталяція відбулася у січні 2000 року.
Назва „koha“ означає подарунок, дар мовою Маорі (Нова Зеландія).

Новини та інші не вікі-сторінки розміщуються на веб-сайті [http://koha.org.ua '''koha.org.ua'''] та Facebook-сторінці [https://www.facebook.com/kohaua Koha Ukraine]. Задавайте питання та починайте обговорення у [https://www.facebook.com/groups/608810989304700/ '''Facebook-групі'''] чи [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-групі'''] української спільноти користувачів АБІС Koha.

Українська спільнота користувачів АБІС Koha запрошує на сторінках цієї вікі ділитися досвідом використання ПЗ Koha.

Також не забувайте про офіційну англомовну вікі-сторінку Koha [https://wiki.koha-community.org/ wiki.koha-community.org], там теж багато цікавого.

[[Поширення АБІС Koha в Україні]] (таблиця та мапа).

[[Перелік функціональних можливостей АБІС Koha]].

[[Історія версій АБІС Koha]], примітки про випуски: [https://koha-community.org/koha-24-05-00-released/ Koha 24.05] (англ.), [https://koha-community.org/koha-23-05-released/ 23.05] (англ.), [https://koha-community.org/koha-22-11-released/ 22.11] (англ.), [https://koha-community.org/koha-22-05-released/ 22.05] (англ.), [https://koha-community.org/koha-21-11-released/ 21.11] (англ.), [https://koha-community.org/koha-21-05-released/ 21.05] (англ.), [https://koha-community.org/koha-20-11-released/ 20.11] (англ.), [[Примітки до випуску Koha 20.05|20.05]] (укр.), [[Примітки до випуску Koha 19.05|19.05]] (укр.), [[Примітки до випуску Koha 18.11|18.11]], [http://koha.org.ua/novini/vyjshla-koha-17-05/ 17.05] (укр.).

[[Демонстраційні сервери АБІС Koha та віртуальні образи]], ukr_unimarc ([http://opac.koha.org.ua/ Е.К.], [http://demo.koha.org.ua Б.І.]).




[[Групи користувачів АБІС Koha у світі]].

[[Сервери Z39.50/SRU в Україні]].

[[Переклад АБІС Koha]].

[[Бібліотечні стандарти]].

[[MARC-інструменти]].

[[Підбірка каталогів на АБІС Koha]].

[[Цитати для Koha]].

[[Виправлення та вдосконалення для АБІС Koha]].

[[Публікації стосовно АБІС Koha]].

[[Короткі нотатки]]

== Інструкції з встановлення ==
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Встановлення Koha з джерела на ОС Debian]]

== Керівництва та документації ==
* [[Вибір сервера для АБІС Koha]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]
* [[Налаштування Koha]]
* [[Налаштування Postfix та Gmail для Koha]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Оновлення Koha, встановленої з джерела, на версію з репозитарію]]
* [[Міграція даних у Koha]]
* [[Сервер Z39.50|Відкриття сервера Z39.50]]
* [[Штрих-кодування]]
* [[Структурований зміст]]
* [[Koha та RFID]]
* [[Помилки у журналах]], причини і виправлення
* Переклади довідки/документації: [[bulkmarcimport.pl]], [[link_bibs_to_authorities.pl]], [[rebuild_nozebra.pl]]
* [[Шаблони ISBD]]

== Посилання на інші ресурси ==
* [https://uk.wikipedia.org/wiki/Koha Koha]{{ref-uk}} у Вікіпедії
* [http://docs.linux.org.ua/%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%B8/Koha/ Документація до АБІС Koha вер. 2.2]{{ref-uk}} (застаріло) на проекті української документації '''docs.linux.org.ua'''
* [https://web.archive.org/web/20070528163217/http://www.library.lviv.ua/software/koha/ Перша україномовна сторінка з АБІС Koha]{{ref-uk}} на сайтів ЛННБ ім. В. Стефаника /веб-архів/
* [https://web.archive.org/web/20120306060621/http://libraries.osdn.org.ua/ua/programms/ils/koha/ Розділ Koha]{{ref-uk}} на проекті „Вільне програмне забезпечення для бібліотек“ /веб-архів/
* [http://librarypolice.com/wiki.koha.org/ukrainian.html Україномовний розділ з колишньої wiki.koha.org]{{ref-uk}}
* [https://groups.google.com/forum/#!forum/koha-ukrainian '''Google-група української спільноти користувачів АБІС Koha''']
* [https://www.facebook.com/kohaua '''Facebook-сторінка'''] та [https://www.facebook.com/groups/608810989304700/ '''Facebook-група'''] української спільноти користувачів АБІС Koha

Історія версій АБІС Koha

2024-07-16T12:04:26Z

Dubyk:

В цій історій версій АБІС Koha наведені найбільш видимі зміни. Детальніше дивіться за посиланням до кожної версії.

* '''[https://koha-community.org/koha-24-05-00-released/ Koha 24.05.00]''' (28 травня 2024 року)

* [https://koha-community.org/koha-23-11-01-released/ Koha 23.11.01] (2 січня 2024 року)

* '''[https://koha-community.org/koha-23-11-release/ Koha 23.11]''' (30 листопада 2023 р)

* '''[https://koha-community.org/koha-23-05-release/ Koha 23.05]''' (1 червня 2023 року)

* '''[https://koha-community.org/koha-22-11-released/ Koha 21.11]''' (25 листопада 2022 року)

* '''[https://koha-community.org/koha-22-05-release/ Koha 22.05]''' (28 травня 2022 року)

* [https://koha-community.org/koha-21-11-01-released/ Koha 21.11.01] (22 грудня 2021 року)

* [https://koha-community.org/koha-21-05-08-released/ Koha 21.05.08] (23 грудня 2021 року)

* '''[https://koha-community.org/koha-21-11-released/ Koha 21.11]''' (25 листопада 2021 року)

* '''[https://koha-community.org/koha-21-05-released/ Koha 21.05]''' (28 травня 2021 року)

* [https://koha-community.org/koha-20-11-03-released/ Koha 20.11.03] (24 лютого 2021 року)

* [https://koha-community.org/koha-20-11-02-released/ Koha 20.11.02] (23 січня 2021 року)

* [https://koha-community.org/koha-20-11-01-released/ Koha 20.11.01] (7 січня 2021 року)

* '''[https://koha-community.org/koha-20-11-released/ Koha 20.11]''' (27 листопада 2020 року)

* [https://koha-community.org/koha-20-05-05-release/ Koha 20.05.05] (27 жовтня 2020 року)

* [https://koha-community.org/koha-20-05-01-release/ Koha 20.05.01] (23 червня 2020 року)

* '''[https://koha-community.org/koha-20-05-release/ Koha 20.05]''' (31 травня 2020 року), [[Примітки до випуску Koha 20.05]] (укр.)

* [https://koha-community.org/koha-19-11-06-release/ Koha 19.11.06] (21 травня 2020 року)

* [https://koha-community.org/koha-19-11-05-release/ Koha 19.11.05] (22 квітня 2020 року)

* [https://koha-community.org/koha-19-11-04-release/ Koha 19.11.04] (24 березня 2020 року)

* [https://koha-community.org/koha-19-11-03-release/ Koha 19.11.03] (21 лютого 2020 року)

* [https://koha-community.org/koha-19-11-02-release/ Koha 19.11.02] (22 січня 2020 року)

* [https://koha-community.org/koha-19-11-01-release/ Koha 19.11.01] (23 грудня 2019 року)

* '''[https://koha-community.org/koha-19-11-release/ Koha 19.11]''', [https://fossies.org/diffs/koha/19.05.05_vs_19.11.00/ %] (27 листопада 2019)

* [https://koha-community.org/koha-19-05-04-release/ Koha 19.05.04], [https://fossies.org/diffs/koha/19.05.03_vs_19.05.04/ %] (24 вересня 2019)

* [https://koha-community.org/koha-19-05-03-release/ Koha 19.05.03], [https://fossies.org/diffs/koha/19.05.02_vs_19.05.03/ %] (29 серпня 2019)
- [https://translate.koha-community.org/uk/19.05/ український переклад 71.3%]

* [https://koha-community.org/koha-19-05-02-release/ Koha 19.05.02], [https://fossies.org/diffs/koha/19.05.01_vs_19.05.02/ %] (24 липня 2019)

* [https://koha-community.org/koha-19-05-01-release/ Koha 19.05.01], [https://fossies.org/diffs/koha/19.05.00_vs_19.05.01/ %] (2 липня 2019),
- оновлення безпеки (міжсайтовий скриптинг, XSS)

* [https://koha-community.org/koha-19-05-05-release/ Koha 19.05.00], [https://fossies.org/diffs/koha/18.11.05_vs_19.05.00/ %] (31 травня 2019), [[Примітки до випуску Koha 19.05]] (укр.)
- пропозиції на придбання на e-mail, база знань Mana для обміну звітами та підписками, вдосконалено МАРК-редактор

* [https://koha-community.org/koha-18-11-05-release/ Koha 18.11.05] (3 травня 2019)

* [https://koha-community.org/koha-18-11-04-release/ Koha 18.11.04], [https://fossies.org/diffs/koha/18.11.03_vs_18.11.04/ %] (26 березня 2019)

* [https://koha-community.org/koha-18-11-03-release/ Koha 18.11.03] (23 лютого 2019)

* [https://koha-community.org/koha-18-11-01-release/ Koha 18.11.01] (21 грудня 2018)

* [https://koha-community.org/koha-18-11-release/ Koha 18.11.00], [[Примітки до випуску Koha 18.11]] (укр.)

- ротація бібліотечних фондів

- документація переведена в онлайн

- підтримка каталогу RecordedBooks, обкладинок AdLibris

- нові REST api для відвідувачів та маршрутів

- діаграми у звітах

- підтримка SRU для запозичень авторитетних файлів

- покращення безпеки автентифікації, SQL, XSS

- типові значення для індикаторів

- підтримка множинних форм у перекладах

- отримання згоди на обробку персональних даних (GDPR)

- українською перекладено 58,9% загалом: електронний каталог 100%, інтерфейс бібліотекаря %60,7, параметри 31,1%, Unimarc 100%, Marc21 32,1%

* [https://koha-community.org/koha-18-05-released/ Koha 18.05.00]

- ієрархії бібліотек та підрозділів

- кешування Plack та Memcached визнано стабільними

- краща підтримка Unicode

- інструмент об’єднання записів читачів

- підтримка OAuth2

- імпорт читачів з командного рядка

- змінна MarcFieldDocURL для посилання на МАРК-документацію, напр. MarcFieldDocURL=https://unimarc.org.ua/wiki/index.php/{FIELD}

- структура ACQ для надходжень

- вдосконалення підтримки Elasticsearch

* [https://koha-community.org/koha-17-11-released/ Koha 17.11.00]

- історія пені та платежів

- онлайн-платежі

- підтримка МБА-обмінів

- зведення для читача (його видачі, прострочення, резервування, сплати)

- історія резервувань

- зріс укр.-переклад, оновлено укр.-налаштування

* [https://koha-community.org/koha-17-05-released/ Koha 17.05.00], [http://koha.org.ua/novini/vyjshla-koha-17-05/ Вийшла Koha 17.05](укр.)

- запити на скан/ксерокс статей чи частин книг

- після-інсталяційний покроковий чарівник

- сповіщення різними мовами

- читач може робити примітки до виданих йому книг

- клуби читачів за інтересами

- міжбібліотечна статистика https://hea.koha-community.org/

- зміна поведінки звітів на основі marcxml

* [https://koha-community.org/koha-16-11-released-2/ Koha 16.11.00]

- відправлення постачальникам замовлення по пошті

- модуль прикутих до дому

* [https://koha-community.org/koha-16-05-released/ Koha 16.05.00]

- авторизація Google OAuth2 (OpenID Connect)

- відновлення забутого паролю

* [https://koha-community.org/koha-3-22-released/ Koha 3.22] (листопад 2015)

- додавання файлів до бібліографічних записів (upload.pl)

- пришвидшення Коха (технологія Plack)

- редактор професійного каталогізатора

- sitemap.pl для пошукових рушіїв (Google,...)

* [https://koha-community.org/koha-3-20-0-released/ Koha 3.20] (травень 2015)

- пакетна обробка біб-записів

- імпорт біб-файлів різних форматів через додатки

- підтримка обкладинок через віддалений кеш Coce

* [https://koha-community.org/koha-3-18-0-released/ Koha 3.18] (листопад 2014)

- завантаження сканованих накладних

- підтримка граней (при пошуку)

- пакетне вилучення біб-записів

- почергово переміщувані зібрання

- підтримка запозичень SRU (на додаток до Z39-50), можливість конвертації Marc21-Unimarc на льоту

* [https://koha-community.org/koha-3-16-0-released/ Koha 3.16] (травень 2014)

- індексатор Zebra працює як служба

- надсилання списків ел.поштою

* [https://koha-community.org/koha-3-14-0-released/ Koha 3.14] (листопад 2013)

- нова тема Bootstrap для ЕК (підтримка моб. пристроїв)

- модуль резервування курсів

- модуль офлайнового обігу

- переліки відвідувачів

- правила конвертування при імпорті біб-записів

- імпорт авторит. файлів через Z39-50

- підтримка мікроданих schema.org

* [https://koha-community.org/koha-3-12-0-released/ Koha 3.12] (травень 2013)

- підтримка HTML5 відео/аудіо

- само-реєстрація відвідувачів

- підтримка додатків

- статистика по відвідувачах

* [https://koha-community.org/koha-3-10-0-released/ Koha 3.10] (листопад 2012)

- додаток для інвентарного номера

- ''тихий'' видрук квитанцій

- вікові обмеження

- режим незалежних підрозділів

- скрипт MARC-експорту

- цитати дня

- обкладинки у списках

- пакетне редагування відвідувачів

- додавання PDF-файлів у профіль відвідувача

- ієрархія збережених звітів

- ширше-вужче-пов’язано для тематик, до цього відноситься „Чи ви мали на увазі?“

- підтримка SIP2

- підрозподілені привілеї

- таблиці в Koha

* [https://koha-community.org/koha-3-8-0-released/ Koha 3.8.0] (квітень 2012)

- локальні обладинки

- аналітичні записи

- додаткок для шифру callnumber-KU

- шлюз OCLC Connexion

- пошукові посилання у подробицях запису

- XSLT-таблиці для подробиць запису та результатів пошуку

- зірковий рейтинг в ЕК

- посилання на соц-мережі

- підтримка memcached

* [https://koha-community.org/koha-3-6-0-released/ Koha 3.6.0] (жовтень 2011)

- покращення для підтримки аналітичних записів

* [https://koha-community.org/koha-3-4-0-released/ Koha 3.4.0] (квітень 2011)

* [https://koha-community.org/koha-3-2-0/ Koha 3.2.0] (жовтень 2010)

- ієрархічні кошториси та кошти

- пакетне редагування примірників

- переміщення примірників між записами

- шукати за цим заголовком (у інших ресурсах)

- редаговані SQL-звіти

- OAI-PMH

- пакування для Debian (apt-get install koha)

* [https://koha-community.org/koha-3-0-6-ready-for-download/ Koha 3.0.6] (травень 2010)

* Koha 3.0.0 (серпень 2008)

Див. також тут https://koha-community.org/about/history/

Про історію Koha без сухих цифр і дат читайте тут https://wiki.koha-community.org/wiki/History.

Цікава відео-візуалізація розробки Koha https://www.youtube.com/watch?v=Tl1a2VN_pec&feature=youtu.be

Встановлення Koha з репозитарію на ОС Debian

2024-03-26T12:08:33Z

Dubyk: /* Включення sitemap */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами.

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
MYSQL_USER="koha_ukr_unimarc"
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_ukr_unimarc"
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart ukr_unimarc

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Створення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2024-03-26T12:08:21Z

Dubyk: /* Включення Plack */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами.

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
MYSQL_USER="koha_ukr_unimarc"
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_ukr_unimarc"
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart ukr_unimarc

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== Включення sitemap ==
koha-sitemap --enable ukr_unimarc
koha-sitemap --generate ukr_unimarc

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2024-03-22T12:29:57Z

Dubyk: /* Локаль з UTF-8 */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами.

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
MYSQL_USER="koha_ukr_unimarc"
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_ukr_unimarc"
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart ukr_unimarc

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2024-03-22T12:24:24Z

Dubyk: /* Попередні налаштування */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами.

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
MYSQL_USER="koha_ukr_unimarc"
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_ukr_unimarc"
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart ukr_unimarc

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Демонстраційні сервери АБІС Koha та віртуальні образи

2024-03-20T09:01:25Z

Dubyk: /* Демонстраційні сервери */

== Демонстраційні сервери ==

=== Тестовий сервер ТНТУ з АБІС Koha 22.11.05!===

Стан: '''працює'''

Доступні мови інтерфейсу: українська, англійська.

Мова SQL-таблиць: українська.

МАРК-формат: '''УКРМАРК/UNIMARC'''[https://unimarc.org.ua].

Для входу використовуйте

логін: librarian

пароль: librarian

Бібліотечний інтерфейс: '''https://demo.koha.org.ua''' (також http://koha.dynu.net, http://liblab.tntu.edu.ua:8008)

Електронний каталог: '''https://opac.koha.org.ua''' (також http://koha.dynu.net:7007, http://liblab.tntu.edu.ua:7007)

Спробуйте пошукати за кл. словами [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=2017 2017], [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=клуб клуб], [https://opac.koha.org.ua/cgi-bin/koha/opac-search.pl?q=психо* психологія].

Примітки: український інтерфейс щоденно синхронізується з [https://translate.koha-community.org/uk/22.11/ translate.koha-community.org/uk/22.11].




=== Див. також ===

* [https://koha-community.org/demo/ Перелік демо-серверів на оф. сторінці АБІС Koha].
* https://wiki.koha-community.org/wiki/Koha_Demo_Installations
* [http://koha.org.pl/demo Демо від польської спільноти АБІС Koha]

== Віртуальні образи ==

1) ЗАСТАРІЛО. Варіант АБІС Koha 16.05.05 для запуску під Virtual Box[https://www.virtualbox.org/wiki/Downloads].

Посилання для звантаження образу: [https://drive.google.com/open?id=0B9yQdtMQotpzZDZEbmhydDhwMTA] (12 Гб).

Операційна система та графічне середовище: GNU Linux Debian 8 Jessie, Gnome.

Доступні мови інтерфейсу: українська, англійська.

Мова SQL-таблиць: українська.

МАРК-формат: УКРМАРК/UNIMARC.

Про решту див. після запуску.

=== Див. також ===
* [https://wiki.koha-community.org/wiki/Koha_Virtual_Appliances Koha Virtual Appliances] (Koha Wiki)
* [https://wiki.koha-community.org/wiki/Sandboxes Sandboxes] (Koha Wiki)

== Koha Live DVD/USB ==

=== Див. також ===
* [https://vimal0212.wordpress.com/koha-live-dvd/ Koha Live DVD] від Vimal Kumar V.
* [https://wiki.koha-community.org/wiki/Koha_LiveCD Koha_Live CD] — про цей ж Koha Live DVD на Koha-вікі
* https://sourceforge.net/projects/kohalivedvd/

==Sandboxes==
=== Див. також ===
* https://wiki.koha-community.org/wiki/Sandboxes

Встановлення Koha з репозитарію на ОС Debian

2024-01-30T07:38:35Z

Dubyk: /* Встановлення БД MySQL та допоміжних пакунків */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами.

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
MYSQL_USER="koha_ukr_unimarc"
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_ukr_unimarc"
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart ukr_unimarc

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2024-01-16T22:19:53Z

Dubyk: /* E-mail */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами.

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
MYSQL_USER="koha_ukr_unimarc"
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_ukr_unimarc"
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart ukr_unimarc

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

== Вимкнення оновлення Koha ==
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main

Це дозволить легко оновлювати інші пакунки Debian

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]

Встановлення Koha з репозитарію на ОС Debian

2024-01-16T21:46:29Z

Dubyk: /* Кроки веб-встановлювача */

Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

На даний час це найбільш протестований і розповсюджений варіант.

Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki

= Встановлення ОС Debian GNU/Linux  11 Bullseye =

Див. також:
* http://download.openlib.org.ua/ustanovka-debian-11/
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/
* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_%D0%9E%D0%A1_Debian_Linux Встановлення ОС Debian Linux].

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bullseye main non-free contrib
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib

deb http://security.debian.org/debian-security/ bullseye-security main
deb-src http://security.debian.org/debian-security/ bullseye-security main

deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free

deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main

sudo apt-get update
sudo apt-get upgrade

= Встановлення ОС Debian GNU/Linux 12 bookworm =

Див. також:
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції

Перевірка поточної версії Debian:
lsb_release -d

Щодо сумісності Коха з іншими версіями ОС див.
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)

== Підключення гілок non-free та contrib для пакунків Дебіен ==

Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib

sudo mc -e /etc/apt/sources.list

deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware

deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware

deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware

sudo apt-get update
sudo apt-get upgrade

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
apt install locales-all
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

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

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:

Встановити gpg
apt-get install gnupg2

Звантажити та встановити ключ

Новіший спосіб
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg

або старіший спосіб
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).

Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list
'''echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''
echo 'deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list

Оновлюємо список доступних для встановлення пакунків
sudo apt-get update

= Встановлення Koha =

== Встановлення пакунків Koha ==
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 та https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here

Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування

less /usr/share/doc/koha-common/README.Debian

(у нових версіях можуть бути зміни)

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install mariadb-server

sudo mysql_secure_installation

За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!

sudo apt-get install memcached libmemcached-tools

sudo apt install aptitude



sudo apt install php-twig

sudo apt install phpmyadmin php libapache2-mod-php

* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку

Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin

Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

sudo /etc/init.d/apache2 restart

По умовчанню вхід через phphmyadmin для root закрито.
За потреби можна створити іншого користувача

mysql -u root -p
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';

та надати йому привілеї на усі БД:

GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;
exit
sudo /etc/init.d/mysql restart

== Пакунки з CPAN ==

Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.

Станом на 12.2023 необхідні модулі

* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).

* '''Locale::XGettext::TT2'''

Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :

sudo apt-get install make

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
— встановився, вивід —
ADIRAJ/ApacheBench-0.73.tar.gz
make install -- OK

sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl

sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'

sudo perl -MCPAN -e 'install Test::Differences'

sudo perl -MCPAN -e 'install Text::CSV::Unicode'
— встановився, вивід —
RMBARKER/Text-CSV-Unicode-0.400.tar.gz
./Build install -- OK

sudo perl -MCPAN -e 'install Selenium::Remote::Driver'
— встановився, вивід —
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz
/usr/bin/make install -- OK






sudo perl -MCPAN -e 'install Locale::XGettext::TT2'






== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі  Deflate, Cgi, headers, proxy_http
sudo a2enmod deflate
sudo a2enmod rewrite
sudo a2enmod cgi

sudo a2enmod headers proxy_http

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.
USE_MEMCACHED="yes" # Set the instance to make use of memcache.
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

sudo /etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис команди для створення екземплярів АБІС Koha — [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create на вікі] та більш актуальний у [http://git.koha-community.org/gitweb/?p=koha.git;a=blob_plain;f=debian/scripts/koha-create;hb=HEAD коді на Git], а також через вбудовану довідку „koha-create --help“:
koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21(default)|normarc|unimarc] \
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \
[--elasticsearch-server localhost:9200(default)] \
[--auth-idx dom(default)|grs1] \
[--biblio-idx dom (default)|grs1] \
[--use-memcached] \
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \
[--memcached-prefix KOHA|koha_|...] \
[--enable-sru] \
[--sru-port 7090(default)|9998] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] \
[--passwdfile /path/to/passwd] \
[--dbhost host] \
[--database dbname] \
[--adminuser admin_user_id_in_db] \
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \
[--timezone time/zone (America/Argentina)] \
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \
[--letsencrypt] \
[--smtp-host host] \
[--smtp-port NN] \
[--smtp-timeout NN] \
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \
[--smtp-user-name user] \
[--smtp-password pass] \
[--smtp-debug] \
[--mb-host localhost)default)] \
[--mb-port NN default: 61613] \
[--mb-user guest(default)] \
[--mb-pass guest(default)] \
[--mb-vhost koha_<instance>(default)] \
[--keep-cookie NAME] \
[--help,-h] \
instancename

''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''

Створення екземпляра АБІС Koha (українська, Unimarc)

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

Вивід:

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

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.

Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:

'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'

Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''

Виконайте наступну команду
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української

sudo koha-translate --install uk-UA


Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA
разом з раніше скопійованими '''SQL'''-файлами.

Також можете встановити деякі інші мови інтерфейсу

sudo koha-translate --install pl-PL

sudo koha-translate --install de-DE
sudo koha-translate --install fr-FR
sudo koha-translate --install it-IT
sudo koha-translate --install cs-CZ
sudo koha-translate --install bg-Cyrl
…

=== Кроки веб-встановлювача ===

Типовий логін для екземляра напр. „ukr_unimarc“ буде:
koha_ukr_unimarc

Пароль та логін можна переглянути за допомогою:
sudo koha-passwd ukr_unimarc

або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова '''uk-UA''', перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).

¹Які типові дані можна вимкнути:
* Приклади користувачів
* Приклади бібліотек/підрозділів

²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.

==== Процес імпорту даних ====
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика).

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:

#!/bin/bash
# MySQL сервер та інформація про підключення
MYSQL_USER="koha_ukr_unimarc"
MYSQL_PASSWORD="ваш_пароль"
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL
MYSQL_DB="koha_ukr_unimarc"
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")
# Вимкнення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;"
# Цикл для виконання DELETE для кожної таблиці
for table in $TABLES
do
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"
done
# Включення перевірки зовнішніх ключів
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"
echo "Всі дані з бази даних $MYSQL_DB були очищені."
sudo /etc/init.d/koha-common restart
sudo /etc/init.d/apache2 restart
sudo /etc/init.d/mariadb restart
sudo /etc/init.d/memcached restart
koha-plack --restart ukr_unimarc

Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.

==== Помилка „Gateway Timeout“ ====
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати
sudo /etc/init.d/apache2 restart

та перезапустити веб-встановлювач (й попередньо очистити таблиці).

==== Адаптаційний етап ====
=====Створення бібліотеки/підрозділу=====

Створюємо свій підрозділ, напр.

Код бібліотеки/підрозділу: AB
Найменування: Абонемент

=====Створення категорії користувачів=====
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.

===== Створення адміністратора Коха=====

Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.

===== Створення нового типу одиниць =====
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.

===== Створення нового правила обігу =====
Наприклад, вибираємо
Підрозділ бібліотеки: Абонемент
Категорія користувача: Студент
Тип одиниці: BOOK
Поточна дозволена кількість видач: 50
Термін випозичання: 14
Одиниці: дні
Продовження (дозволена кількість): 1
=====Встановлення завершено!=====
Вітаємо, Ви закінчили і готові до використання Коха

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-zebra --start ukr_unimarc
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

== Включення Plack ==
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc
Щодо продуктивності див. також тут:
* https://wiki.koha-community.org/wiki/Performance
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11

== E-mail ==

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

sudo koha-email-enable ukr_unimarc

= Виправлення проблем =
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.


Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.

= Оновлення Koha =

Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.

Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common

Деколи необхідно оновити ключ debian-сховища Koha.

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

== Встановлення/оновлення допоміжних perl-модулів ==

Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.

Ви можете побачити відсутні модулі Perl, виділені різними кольорами,

=== Пакунки з репозитарію Debian ===

Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук
https://www.debian.org/distrib/packages#search_packages

Знайдені пакунки довстановлюємо

sudo apt-get install знайдений_пакунок

=== Пакунки з CPAN ===

Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.

Наприклад, при оновлення до 16.11:

(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)

sudo cpan
install Test::DBIx::Class
install Readonly::XS
install HTTPD::Bench::ApacheBench

== Оновлення локалізації ==

sudo koha-translate --update uk-UA
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)

Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами

sudo /etc/init.d/mariadb restart
sudo /etc/init.d/apache2 restart
sudo koha-zebra --stop ukr_unimarc
sudo koha-indexer --stop ukr_unimarc
sudo koha-plack --stop ukr_unimarc
sudo koha-disable ukr_unimarc
sudo koha-remove ukr_unimarc
sudo /sbin/userdel ukr_unimarc-koha
sudo /sbin/groupdel ukr_unimarc-koha
sudo /etc/init.d/memcached restart

Інколи виникає помилка userdel: user ukr_unimarc-koha is currently used by process 4793 /usr/sbin/deluser: `/usr/sbin/userdel ukr_unimarc-koha' returned error code 8. Див. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=4880.

Перегляд переліку наявних екземплярів

sudo koha-list

Остаточне вилучення пакунків Koha

sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch

Перевірте також теки:
/var/spool/koha
/var/log/koha
/var/lib/koha
/var/cache/koha
/usr/share/koha
/etc/koha

Можна очистити вміст цих тек щодо екземпляру ukr_unimarc
rm -rf /var/spool/koha/ukr_unimarc
rm -rf /var/log/koha/ukr_unimarc
rm -rf /var/lib/koha/ukr_unimarc
rm -rf /var/cache/koha/ukr_unimarc

У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha
rm -rf /usr/share/koha
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.

У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо
rm -rf /etc/koha/sites/ukr_unimarc
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/
rm -rf /etc/koha

Вилучення налаштувань для веб-сервера Apache2

rm /etc/apache2/sites-enabled/ukr_unimarc.conf
rm /etc/apache2/sites-available/ukr_unimarc.conf

Якщо після видалення планується перевстановлення Коха, то ще потрібно

sudo /etc/init.d/memcached restart

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Category:АБІС Koha]]