Відмінності між версіями «Встановлення Koha з репозитарію на ОС Debian»
Dubyk (обговорення • внесок) (→Встановлення БД MySQL та допоміжних пакунків) |
Dubyk (обговорення • внесок) |
||
(Не показані 42 проміжні версії цього користувача) | |||
Рядок 1: | Рядок 1: | ||
− | Розглядається встановлення АБІС Koha | + | <b>Наповнення цієї сторінки на цій площадці заморожено! <br /> |
+ | Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha [http://wiki.koha.org.ua wiki.koha.org.ua]!<br /> | ||
+ | Ласкаво просимо!</b> | ||
+ | |||
+ | Розглядається встановлення АБІС Koha версії 16.05.05 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. | ||
+ | |||
+ | Див. також | ||
+ | * [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki | ||
+ | * [http://git.koha-community.org/gitweb/?p=koha.git;a=blob;f=INSTALL.debian;hb=HEAD INSTALL.debian] на Git | ||
+ | * [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki | ||
+ | |||
'''Цей варіант встановлення ще тестується, наразі більш апробованим та універсальним залишається [[Встановлення Koha з джерела на ОС Debian|встановлення з джерельних кодів]].''' | '''Цей варіант встановлення ще тестується, наразі більш апробованим та універсальним залишається [[Встановлення Koha з джерела на ОС Debian|встановлення з джерельних кодів]].''' | ||
− | = Встановлення ОС Debian GNU/Linux | + | = Встановлення ОС Debian GNU/Linux 9 Stratch = |
Детальніше: [[Встановлення ОС Debian Linux]]. | Детальніше: [[Встановлення ОС Debian Linux]]. | ||
Рядок 32: | Рядок 42: | ||
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk" | sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk" | ||
− | == Користувач для Koha == | + | <!--== Користувач для Koha == |
Додаємо користувача | Додаємо користувача | ||
Рядок 50: | Рядок 60: | ||
Після додавання клавіатурним скороченням Ctrl-O зберігаємо файл (/etc/sudoers) та через Ctrl-X виходимо. | Після додавання клавіатурним скороченням Ctrl-O зберігаємо файл (/etc/sudoers) та через Ctrl-X виходимо. | ||
+ | --> | ||
+ | |||
+ | <!--== Підключення репозитарію Debian „testing“ та „unstable“ == | ||
+ | |||
+ | Деякі пакунки (чи оновленні версії) не попали в стабільний випуск Debian, проте можуть бути у випуску „testing“ чи „unstable“. | ||
+ | |||
+ | Створюємо файл /etc/apt/apt.conf і додаємо наступне | ||
+ | |||
+ | # Зробити „wheezy“ дистрибутивом за умовчанням | ||
+ | APT::Default-Release "wheezy"; | ||
+ | |||
+ | Створюємо файл /etc/apt/preferences і додаємо наступне (щоб у стабільної гілки „wheezy“ був вищий пріоритет) | ||
+ | |||
+ | Package: * | ||
+ | Pin: release a=stable | ||
+ | Pin-Priority: 700 | ||
+ | |||
+ | Package: * | ||
+ | Pin: release a=testing | ||
+ | Pin-Priority: 650 | ||
+ | |||
+ | Package: * | ||
+ | Pin: release a=unstable | ||
+ | Pin-Priority: 600 | ||
+ | |||
+ | У файл /etc/apt/sources.list додаємо наступне джерело | ||
+ | |||
+ | # Джерело пакунків з гілки Дебіен „testing“ | ||
+ | deb http://http.us.debian.org/debian/ testing main contrib non-free. | ||
+ | deb-src http://http.us.debian.org/debian/ testing main contrib non-free. | ||
+ | |||
+ | # Джерело пакунків з гілки Дебіен „testing“ — оновлення безпеки | ||
+ | deb http://security.debian.org/ testing/updates main contrib non-free | ||
+ | deb-src http://security.debian.org/ testing/updates main contrib non-free | ||
+ | |||
+ | # Джерело пакунків з гілки Дебіен „unstable“ | ||
+ | deb http://http.us.debian.org/debian/ unstable main contrib non-free. | ||
+ | deb-src http://http.us.debian.org/debian/ unstable main contrib non-free. | ||
+ | |||
+ | Оновлюємо список доступних для встановлення пакунків | ||
+ | |||
+ | sudo apt-get update | ||
+ | --> | ||
== Підключення репозитарію Koha == | == Підключення репозитарію Koha == | ||
Рядок 56: | Рядок 109: | ||
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується) | Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується) | ||
− | deb http://debian.koha-community.org/koha | + | deb http://debian.koha-community.org/koha stable main |
− | + | (доступні й інші версії, див. тут http://debian.koha-community.org/koha/dists/) | |
− | deb http://debian.koha-community.org/koha | + | |
− | + | Швидко підключити репозитарій Koha можна командою | |
+ | echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list | ||
+ | |||
Також додаємо ключ gpg.asc до довірених ключів APT: | Також додаємо ключ gpg.asc до довірених ключів APT: | ||
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add - | wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add - | ||
Рядок 75: | Рядок 130: | ||
та | та | ||
− | „'''koha'''“ — подібний пакунок, однак надає один екземпляр Koha. Однак цей варіант ще не керується сценаріями а також необхідно вручну додавати завдання cron та індексування Zebra (див. bug 5071 | + | „'''koha'''“ — подібний пакунок, однак надає один екземпляр Koha. Однак цей варіант ще не керується сценаріями а також необхідно вручну додавати завдання cron та індексування Zebra (див. [http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=5071 bug 5071]. |
Отож рекомендовано встановлювати пакунок „'''koha-common'''“ | Отож рекомендовано встановлювати пакунок „'''koha-common'''“ | ||
Рядок 93: | Рядок 148: | ||
less /usr/share/doc/koha-common/README.Debian | less /usr/share/doc/koha-common/README.Debian | ||
+ | |||
+ | Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865 | ||
== Встановлення БД MySQL та допоміжних пакунків == | == Встановлення БД MySQL та допоміжних пакунків == | ||
Рядок 104: | Рядок 161: | ||
* при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку | * при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку | ||
− | + | У файлі /etc/phpmyadmin/phpmyadmin.service змінити порт | |
− | /etc/phpmyadmin/phpmyadmin.service | ||
− | |||
... | ... | ||
<port>8888</port> | <port>8888</port> | ||
... | ... | ||
− | /etc/apache2/ports.conf | + | та додати цей порт у файл /etc/apache2/ports.conf |
Listen 8888 | Listen 8888 | ||
− | /etc/init.d/apache2 restart | + | Перезапуск Apache |
+ | |||
+ | /etc/init.d/apache2 restart | ||
== Налаштування MySQL == | == Налаштування MySQL == | ||
Рядок 142: | Рядок 199: | ||
(він задіює модулі Rewrite та Suexec для Apache) | (він задіює модулі Rewrite та Suexec для Apache) | ||
− | 2) Додатково задіюємо модулі Expires та | + | 2) Додатково задіюємо модулі Expires, Deflate, Cgi, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event |
sudo a2enmod expires | sudo a2enmod expires | ||
sudo a2enmod deflate | sudo a2enmod deflate | ||
+ | sudo a2enmod cgi | ||
+ | sudo a2enmod mpm_itk | ||
+ | sudo a2dismod mpm_event | ||
3) Редагуємо /etc/apache2/conf-available/charset.conf | 3) Редагуємо /etc/apache2/conf-available/charset.conf | ||
Рядок 150: | Рядок 210: | ||
AddDefaultCharset UTF-8 | AddDefaultCharset UTF-8 | ||
− | + | та задіюємо його | |
sudo a2enconf charset | sudo a2enconf charset | ||
Рядок 159: | Рядок 219: | ||
== Створення екземпляра АБІС Koha == | == Створення екземпляра АБІС Koha == | ||
− | === koha-ukr-unimarc-site.conf === | + | === Варіанти налаштування АБІС Koha з доменами та портами === |
+ | |||
+ | ==== Варіант з портами 8080 та 8888 (тестовий) ==== | ||
+ | Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс. | ||
+ | |||
+ | ===== koha-ukr-unimarc-site.conf ===== | ||
Створюємо файл | Створюємо файл | ||
Рядок 165: | Рядок 230: | ||
наступного змісту | наступного змісту | ||
− | # | + | 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. | ||
+ | |||
+ | ===== ports.conf ===== | ||
+ | Додаємо | ||
+ | |||
+ | Listen 8080 | ||
+ | Listen 8888 | ||
+ | |||
+ | у файл /etc/apache2/ports.conf | ||
+ | |||
+ | Також перезапускаємо Apache | ||
+ | |||
+ | /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. | ||
+ | ===== ports.conf ===== | ||
Додаємо | Додаємо | ||
− | |||
Listen 8080 | Listen 8080 | ||
+ | Listen 8008 | ||
у файл /etc/apache2/ports.conf | у файл /etc/apache2/ports.conf | ||
+ | |||
+ | Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008. | ||
+ | Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок | ||
+ | |||
+ | <VirtualHost *:8008> | ||
+ | |||
+ | Також перезапускаємо Apache | ||
+ | |||
+ | /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-create“ === | ||
− | Синтаксис | + | |
+ | Синтаксис [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create] | ||
+ | |||
koha-create [--create-db|--request-db|--populate-db|--use-db] \ | koha-create [--create-db|--request-db|--populate-db|--use-db] \ | ||
[--marcflavor marc21|normarc|unimarc] \ | [--marcflavor marc21|normarc|unimarc] \ | ||
Рядок 208: | Рядок 320: | ||
Koha instance is empty, no staff user created. | Koha instance is empty, no staff user created. | ||
− | |||
− | |||
− | |||
− | |||
Starting Zebra server for ukr_unimarc | Starting Zebra server for ukr_unimarc | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== Веб-встановлювач == | == Веб-встановлювач == | ||
Рядок 231: | Рядок 326: | ||
=== Актуальні українські sql-файли === | === Актуальні українські sql-файли === | ||
− | + | Актуальні локалізовані SQL-таблиці (у [https://www.dropbox.com/referrals/NTE4MzAyOTY5?src=global9 DrobBox] Сергія Дубика) '''українською''' знаходяться за адресою: | |
− | + | https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0 | |
− | + | Звантажуємо звідси найновішу версію теки '''uk-UA''' та замінюємо нею відповідну теку у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''. | |
− | + | Примітка: локалізація SQL-таблиць російською '''ru-RU''' доступна лише для версії 3.4.х. | |
=== Утворення локалізованих шаблонів === | === Утворення локалізованих шаблонів === | ||
− | Переходимо у теку сценаріїв локалізації Коха | + | <!--Переходимо у теку сценаріїв локалізації Коха |
cd /usr/share/koha/misc/translator | cd /usr/share/koha/misc/translator | ||
Рядок 251: | Рядок 346: | ||
... і для інших необхідних мов (окрім „en“) | ... і для інших необхідних мов (окрім „en“) | ||
+ | --> | ||
+ | |||
+ | Спочатку дивимося перелік доступних мов | ||
+ | |||
+ | sudo koha-translate --list --available | ||
+ | |||
+ | Встановлюємо переклади для української та російської | ||
+ | |||
+ | sudo koha-translate --install uk-UA | ||
+ | sudo koha-translate --install ru-RU | ||
+ | |||
+ | та декілька інших | ||
+ | |||
+ | sudo koha-translate --install pl-PL | ||
+ | sudo koha-translate --install be-BY | ||
+ | … | ||
=== Кроки веб-встановлювача === | === Кроки веб-встановлювача === | ||
− | У файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''' у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити пароль можна через | + | У файлі '''/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 | sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml | ||
− | У веб-оглядачі переходимо за адресою http://localhost: | + | У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA. Бачимо запит на авторизацію від веб-встановлювача. |
Крок 1: мова uk-UA, перевірка залежностей | Крок 1: мова uk-UA, перевірка залежностей | ||
Рядок 270: | Рядок 382: | ||
Встановлення завершено!. | Встановлення завершено!. | ||
− | == | + | == Підтримка кирилиці рушієм пошуку Zebra == |
− | + | Необхідно додати кириличні символи до файлу | |
− | + | /etc/koha/zebradb/etc/word-phrase-utf.chr | |
− | |||
− | на | + | а саме виправити на наступне: |
− | lowercase {0-9}{a-z} | + | lowercase {0-9}{a-z}æäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’ |
− | uppercase {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“ також потрібно вносити ці зміни. | При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни. | ||
Рядок 293: | Рядок 409: | ||
sudo koha-rebuild-zebra -f -v ukr_unimarc | sudo koha-rebuild-zebra -f -v 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 libraryname | ||
=== Перевірка пошуку === | === Перевірка пошуку === | ||
Рядок 298: | Рядок 420: | ||
У типових даних є декілька біб-записів й примірників. Перевіряємо пошук за словами | У типових даних є декілька біб-записів й примірників. Перевіряємо пошук за словами | ||
− | '''Україна''' (http://localhost: | + | '''Україна''' (http://localhost:80/cgi-bin/koha/opac-search.pl?q=Україна) |
− | '''Інвестиції''' (http://localhost: | + | '''Інвестиції''' (http://localhost:80/cgi-bin/koha/opac-search.pl?q=Інвестиції) |
− | '''2011''' (http://localhost: | + | '''2011''' (http://localhost:80/cgi-bin/koha/opac-search.pl?q=2011) |
== До перевірки == | == До перевірки == | ||
Рядок 313: | Рядок 435: | ||
= Оновлення Koha = | = Оновлення Koha = | ||
+ | |||
+ | Буде додано… | ||
= Вилучення Koha = | = Вилучення Koha = | ||
− | Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. Екземпляри АБІС Koha вилучаються за допомогою команди | + | Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно вилучити усі екземпляри АБІС Koha. Екземпляри АБІС Koha вилучаються за допомогою команди |
koha-remove ukr_unimarc | koha-remove ukr_unimarc | ||
Рядок 337: | Рядок 461: | ||
* [[Оновлення Koha, встановленої з джерела]] | * [[Оновлення Koha, встановленої з джерела]] | ||
* [[Вилучення Koha, встановленої з джерела]] | * [[Вилучення Koha, встановленої з джерела]] | ||
+ | * [[Коротка інструкція для адміністратора АБІС Koha]] | ||
+ | * [[Короткий посібник користувача АБІС Koha]] | ||
[[Категорія:АБІС Koha]] | [[Категорія:АБІС Koha]] | ||
[[Категорія:Бібліотека]] | [[Категорія:Бібліотека]] |
Поточна версія на 20:05, 1 листопада 2023
Наповнення цієї сторінки на цій площадці заморожено!
Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha wiki.koha.org.ua!
Ласкаво просимо!
Розглядається встановлення АБІС Koha версії 16.05.05 з репозитарію debian.koha-community.org.
Див. також
- Koha_on_Debian на Koha Wiki
- INSTALL.debian на Git
- Category:Installation на Koha Wiki
Цей варіант встановлення ще тестується, наразі більш апробованим та універсальним залишається встановлення з джерельних кодів.
Зміст
- 1 Встановлення ОС Debian GNU/Linux 9 Stratch
- 2 Попередні налаштування
- 3 Встановлення Koha
- 3.1 Встановлення пакунка „koha-common“
- 3.2 Встановлення БД MySQL та допоміжних пакунків
- 3.3 Налаштування MySQL
- 3.4 Налаштування Apache та сценарій „koha-post-install-setup“
- 3.5 Створення екземпляра АБІС Koha
- 3.6 Веб-встановлювач
- 3.7 Підтримка кирилиці рушієм пошуку Zebra
- 3.8 До перевірки
- 4 Оновлення Koha
- 5 Вилучення Koha
- 6 Налаштування
- 7 Див. також
Встановлення ОС Debian GNU/Linux 9 Stratch
Детальніше: Встановлення ОС Debian Linux.
Попередні налаштування
Локаль з 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 не згадується, то встановлюємо локаль
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"
Підключення репозитарію Koha
В репозитарії debian.koha-community.org доступні стабільна та розробницька версії.
Підключаємо у файлі /etc/apt/sources.list стабільну версію (рекомендується)
deb http://debian.koha-community.org/koha stable main
(доступні й інші версії, див. тут http://debian.koha-community.org/koha/dists/)
Швидко підключити репозитарій Koha можна командою
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list
Також додаємо ключ gpg.asc до довірених ключів APT:
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
Оновлюємо список доступних для встановлення пакунків
apt-get update
Встановлення Koha
Встановлення пакунка „koha-common“
Доступні два пакунки, що встановлюють АБІС Koha, це
„koha-common“ — містить увесь код та допоміжні сценарії. Цей пакунок після встановлення не надає налаштованого та працюючого екземпляру Koha, однак доступна команда „koha-create“ та інші корисні інструменти, що дозволять Вам створити скільки завгодно налаштованих та працюючих екземплярів (включаючи завдання cron та індексацію Zebra).
та
„koha“ — подібний пакунок, однак надає один екземпляр Koha. Однак цей варіант ще не керується сценаріями а також необхідно вручну додавати завдання cron та індексування Zebra (див. bug 5071.
Отож рекомендовано встановлювати пакунок „koha-common“
apt-get install koha-common
При цьому може з’явитися вивід повідомлень Debconf, напр.
If you are upgrading from a Koha 3.2 to 3.4 release, you must run: sudo /usr/sbin/koha-upgrade-to-3.4 For large catalogues, running this may take a while. Your Koha installation should be largely operational during the process, but some things, particularly to do with items, may appear strange until the upgrade and re-index is complete.
Читаємо та слідуємо вказівкам.
Також читаємо стандартну інструкцію про подальше налаштування
less /usr/share/doc/koha-common/README.Debian
Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865
Встановлення БД MySQL та допоміжних пакунків
sudo apt-get install \ mysql-server \ phpmyadmin
- при встановленні сервера MySQL вказуємо пароль адміністратора (користувач „root“), надалі „ПарольАдмінаMySQL“
- для „phpmyadmin“ вибрати лише „apache2“
- при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку
У файлі /etc/phpmyadmin/phpmyadmin.service змінити порт
... <port>8888</port> ...
та додати цей порт у файл /etc/apache2/ports.conf
Listen 8888
Перезапуск Apache
/etc/init.d/apache2 restart
Налаштування MySQL
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL Якщо пароль не вибрано при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином
sudo dpkg-reconfigure mysql-server-5.5
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне
[mysqld] init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci' character-set-server=utf8 collation-server=utf8_unicode_ci character_set_client=utf8 skip-character-set-client-handshake
3) Перезапускаємо сервер MySQL
sudo /etc/init.d/mysql restart
4) Переконуємося, що зміни внесені, виконавши
sudo mysql -uroot -pПарольАдмінаMySQL show variables; quit
Налаштування Apache та сценарій „koha-post-install-setup“
1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)
2) Додатково задіюємо модулі Expires, Deflate, Cgi, Mpm_Itk та виключаємо[1] модуль Event
sudo a2enmod expires sudo a2enmod deflate sudo a2enmod cgi sudo a2enmod mpm_itk sudo a2dismod mpm_event
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.
ports.conf
Додаємо
Listen 8080 Listen 8888
у файл /etc/apache2/ports.conf
Також перезапускаємо Apache
/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.
ports.conf
Додаємо
Listen 8080 Listen 8008
у файл /etc/apache2/ports.conf
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008. Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок
<VirtualHost *:8008>
Також перезапускаємо Apache
/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“
Синтаксис [2]
koha-create [--create-db|--request-db|--populate-db|--use-db] \ [--marcflavor marc21|normarc|unimarc] \ [--zebralang en|es|fr|nb|ru|uk] \ [--defaultsql /path/to/some.sql] \ [--configfile /path/to/config] [--passwdfile /path/to/passwd] \ [--database database] [--adminuser n] instancename
Створення екземпляра АБІС Koha (українська, Unimarc)
sudo koha-create --create-db --marcflavor unimarc --zebralang uk \ --auth-idx dom --biblio-idx dom \ --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc
Вивід:
Koha instance is empty, no staff user created. Starting Zebra server for ukr_unimarc
Веб-встановлювач
Актуальні українські sql-файли
Актуальні локалізовані SQL-таблиці (у DrobBox Сергія Дубика) українською знаходяться за адресою:
https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0
Звантажуємо звідси найновішу версію теки uk-UA та замінюємо нею відповідну теку у /usr/share/koha/intranet/cgi-bin/installer/data/mysql.
Примітка: локалізація SQL-таблиць російською ru-RU доступна лише для версії 3.4.х.
Утворення локалізованих шаблонів
Спочатку дивимося перелік доступних мов
sudo koha-translate --list --available
Встановлюємо переклади для української та російської
sudo koha-translate --install uk-UA sudo koha-translate --install ru-RU
та декілька інших
sudo koha-translate --install pl-PL sudo koha-translate --install be-BY …
Кроки веб-встановлювача
У файлі /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. Бачимо запит на авторизацію від веб-встановлювача.
Крок 1: мова uk-UA, перевірка залежностей
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв
Крок 3: створення таблиць, вибір МАРК-стандарту (Unimarc), вибір типових даних.
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.
Встановлення завершено!.
Підтримка кирилиці рушієм пошуку 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-start-zebra ukr_unimarc
Запуск індексації Zebra
sudo koha-rebuild-zebra -f -v ukr_unimarc
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 libraryname
Перевірка пошуку
У типових даних є декілька біб-записів й примірників. Перевіряємо пошук за словами
Україна (http://localhost:80/cgi-bin/koha/opac-search.pl?q=Україна)
Інвестиції (http://localhost:80/cgi-bin/koha/opac-search.pl?q=Інвестиції)
2011 (http://localhost:80/cgi-bin/koha/opac-search.pl?q=2011)
До перевірки
- що додано у завдання cron?
- переіндесація автоматична чи по розкладу і чи взагалі робиться?
- як задіяти ICU? (Зауваження щодо ICU див. тут)
- чи можна обійтися без правки word-phrase-utf.chr?
- пошук за „Інвестиції“ мав дати 4 результати..?
Оновлення Koha
Буде додано…
Вилучення Koha
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. Попередньо необхідно вилучити усі екземпляри АБІС Koha. Екземпляри АБІС Koha вилучаються за допомогою команди
koha-remove ukr_unimarc
Перегляд переліку наявних екземплярів
koha-list
Остаточне вилучення пакунків Koha
apt-get purge koha koha-common
Налаштування
Щодо додаткових налаштувань та адаптацій див. тут: Налаштування Koha, встановленої з джерела.